google-cloud-spanner 2.10.0 → 2.12.1

data/lib/google/cloud/spanner/instance.rb

@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# DO NOT EDIT: Unless you're fixing a P0/P1 and/or a security issue. This class
+# is frozen to all new features from `google-cloud-spanner/v2.11.0` onwards.
+
 
 require "google/cloud/spanner/instance/job"
 require "google/cloud/spanner/instance/list"
@@ -25,6 +28,13 @@ module Google
       ##
       # # Instance
       #
+      # NOTE: From `google-cloud-spanner/v2.11.0` onwards, new features for
+      # mananging instances will only be available through the
+      # [google-cloud-spanner-admin-instance-v1](https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-spanner-admin-instance-v1)
+      # client. See the
+      # [README](https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-spanner#google-cloud-spanner)
+      # for further details.
+      #
       # Represents a Cloud Spanner instance. Instances are dedicated Cloud
       # Spanner serving and storage resources to be used by Cloud Spanner
       # databases. Instances offer isolation: problems with databases in one
@@ -38,6 +48,10 @@ module Google
       # {Google::Cloud::Spanner::Project#instance}, and
       # {Google::Cloud::Spanner::Project#create_instance}.
       #
+      # @deprecated Use
+      # {Google::Cloud::Spanner::Admin::Instance#instance_admin}
+      # instead.
+      #
       # @example
       #   require "google/cloud/spanner"
       #

data/lib/google/cloud/spanner/project.rb

@@ -106,6 +106,10 @@ module Google
         # @return [Array<Google::Cloud::Spanner::Instance>] The list of
         #   instances. (See {Google::Cloud::Spanner::Instance::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#list_instances}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -140,6 +144,10 @@ module Google
         # @return [Google::Cloud::Spanner::Instance, nil] The instance, or `nil`
         #   if the instance does not exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#get_instance}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -200,6 +208,10 @@ module Google
         #   asynchronous processing of an instance create operation.
         # @raise [ArgumentError] if both processing_units or nodes are specified.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#create_instance}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -266,6 +278,10 @@ module Google
         #   instance configurations. (See
         #   {Google::Cloud::Spanner::Instance::Config::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#list_instance_configs}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -303,6 +319,10 @@ module Google
         #   configuration, or `nil` if the instance configuration does not
         #   exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Instance#instance_admin Client#get_instance_config}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -335,6 +355,10 @@ module Google
         # @return [Array<Google::Cloud::Spanner::Database>] The list of
         #   databases. (See {Google::Cloud::Spanner::Database::List})
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#list_databases}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -370,6 +394,10 @@ module Google
         # @return [Google::Cloud::Spanner::Database, nil] The database, or `nil`
         #   if the database does not exist.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#get_database}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -417,6 +445,10 @@ module Google
         # @return [Database::Job] The job representing the long-running,
         #   asynchronous processing of a database create operation.
         #
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#create_database}
+        # instead.
+        #
         # @example
         #   require "google/cloud/spanner"
         #
@@ -629,6 +661,9 @@ module Google
           raise "Must have active connection to service" unless service
         end
 
+        # @deprecated Use
+        # {Google::Cloud::Spanner::Admin::Database#database_admin Client#database_path}
+        # instead.
         def database_path instance_id, database_id
           Admin::Database::V1::DatabaseAdminClient.database_path(
             project, instance_id, database_id

data/lib/google/cloud/spanner/service.rb

@@ -34,13 +34,15 @@ module Google
         attr_accessor :host
         attr_accessor :lib_name
         attr_accessor :lib_version
+        attr_accessor :quota_project
 
         ##
         # Creates a new Service instance.
-        def initialize project, credentials,
+        def initialize project, credentials, quota_project: nil,
                        host: nil, timeout: nil, lib_name: nil, lib_version: nil
           @project = project
           @credentials = credentials
+          @quota_project = quota_project || (credentials.quota_project_id if credentials.respond_to? :quota_project_id)
           @host = host
           @timeout = timeout
           @lib_name = lib_name
@@ -68,6 +70,7 @@ module Google
           @service ||= \
             V1::Spanner::Client.new do |config|
               config.credentials = channel
+              config.quota_project = @quota_project
               config.timeout = timeout if timeout
               config.endpoint = host if host
               config.lib_name = lib_name_with_prefix
@@ -82,6 +85,7 @@ module Google
           @instances ||= \
             Admin::Instance::V1::InstanceAdmin::Client.new do |config|
               config.credentials = channel
+              config.quota_project = @quota_project
               config.timeout = timeout if timeout
               config.endpoint = host if host
               config.lib_name = lib_name_with_prefix
@@ -96,6 +100,7 @@ module Google
           @databases ||= \
             Admin::Database::V1::DatabaseAdmin::Client.new do |config|
               config.credentials = channel
+              config.quota_project = @quota_project
               config.timeout = timeout if timeout
               config.endpoint = host if host
               config.lib_name = lib_name_with_prefix

data/lib/google/cloud/spanner/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "2.10.0".freeze
+      VERSION = "2.12.1".freeze
     end
   end
 end

data/lib/google/cloud/spanner.rb

@@ -120,7 +120,7 @@ module Google
 
         Spanner::Project.new(
           Spanner::Service.new(
-            project_id, credentials,
+            project_id, credentials, quota_project: configure.quota_project,
             host: endpoint, timeout: timeout, lib_name: lib_name,
             lib_version: lib_version
           ),
@@ -143,6 +143,8 @@ module Google
       #   parameter `keyfile` is considered deprecated, but may also be used.)
       # * `scope` - (String, Array<String>) The OAuth 2.0 scopes controlling
       #   the set of resources and operations that the connection can access.
+      # * `quota_project` - (String) The project ID for a project that can be
+      #   used by client libraries for quota and billing purposes.
       # * `timeout` - (Integer) Default timeout to use in requests.
       # * `endpoint` - (String) Override of the endpoint host name, or `nil`
       #   to use the default endpoint.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner
 version: !ruby/object:Gem::Version
-  version: 2.10.0
+  version: 2.12.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-24 00:00:00.000000000 Z
+date: 2022-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -269,7 +269,9 @@ files:
 - TROUBLESHOOTING.md
 - lib/google-cloud-spanner.rb
 - lib/google/cloud/spanner.rb
+- lib/google/cloud/spanner/admin/database.rb
 - lib/google/cloud/spanner/admin/database/credentials.rb
+- lib/google/cloud/spanner/admin/instance.rb
 - lib/google/cloud/spanner/admin/instance/credentials.rb
 - lib/google/cloud/spanner/backup.rb
 - lib/google/cloud/spanner/backup/job.rb
@@ -331,7 +333,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Spanner API