google-cloud-spanner 1.16.0 → 2.2.0

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

@@ -17,6 +17,7 @@ require "time"
 require "date"
 require "stringio"
 require "base64"
+require "bigdecimal"
 require "google/cloud/spanner/data"
 
 module Google
@@ -67,6 +68,9 @@ module Google
               Google::Protobuf::Value.new bool_value: false
             when Integer
               Google::Protobuf::Value.new string_value: obj.to_s
+            # BigDecimal must be put before Numeric.
+            when BigDecimal
+              Google::Protobuf::Value.new string_value: obj.to_s("F")
             when Numeric
               if obj == Float::INFINITY
                 Google::Protobuf::Value.new string_value: "Infinity"
@@ -125,6 +129,9 @@ module Google
               :BOOL
             when Integer
               :INT64
+            # BigDecimal must be put before Numeric.
+            when BigDecimal
+              :NUMERIC
             when Numeric
               :FLOAT64
             when Time
@@ -169,12 +176,12 @@ module Google
             return field.to_grpc_type if field.respond_to? :to_grpc_type
 
             if Array === field
-              Google::Spanner::V1::Type.new(
+              V1::Type.new(
                 code: :ARRAY,
                 array_element_type: grpc_type_for_field(field.first)
               )
             else
-              Google::Spanner::V1::Type.new(code: field)
+              V1::Type.new(code: field)
             end
           end
 
@@ -214,6 +221,8 @@ module Google
               end
             when :STRUCT
               Data.from_grpc value.list_value.values, type.struct_type.fields
+            when :NUMERIC
+              BigDecimal value.string_value
             end
           end
 
@@ -274,24 +283,24 @@ module Google
               range_opts.delete :end_closed
             end
 
-            Google::Spanner::V1::KeyRange.new range_opts
+            V1::KeyRange.new range_opts
           end
 
           def to_key_set keys
-            return Google::Spanner::V1::KeySet.new(all: true) if keys.nil?
+            return V1::KeySet.new(all: true) if keys.nil?
             keys = [keys] unless keys.is_a? Array
-            return Google::Spanner::V1::KeySet.new(all: true) if keys.empty?
+            return V1::KeySet.new(all: true) if keys.empty?
 
             if keys_are_ranges? keys
               key_ranges = keys.map { |r| to_key_range(r) }
-              return Google::Spanner::V1::KeySet.new(ranges: key_ranges)
+              return V1::KeySet.new(ranges: key_ranges)
             end
 
             key_list = keys.map do |key|
               key = [key] unless key.is_a? Array
               object_to_grpc_value(key).list_value
             end
-            Google::Spanner::V1::KeySet.new keys: key_list
+            V1::KeySet.new keys: key_list
           end
 
           def keys_are_ranges? keys

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

@@ -13,7 +13,7 @@
 # limitations under the License.
 
 
-require "google/cloud/spanner/v1/credentials"
+require "google/cloud/spanner/v1/spanner/credentials"
 
 module Google
   module Cloud
@@ -37,7 +37,7 @@ module Google
       #
       #   spanner.project_id #=> "my-project"
       #
-      class Credentials < Google::Cloud::Spanner::V1::Credentials
+      class Credentials < Google::Cloud::Spanner::V1::Spanner::Credentials
       end
     end
   end

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

@@ -216,9 +216,9 @@ module Google
         ##
         # @private
         def to_grpc_type
-          Google::Spanner::V1::Type.new(
+          V1::Type.new(
             code: :STRUCT,
-            struct_type: Google::Spanner::V1::StructType.new(
+            struct_type: V1::StructType.new(
               fields: @grpc_fields
             )
           )

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

@@ -229,7 +229,6 @@ module Google
           true
         end
 
-
         # @private
         DATBASE_OPERATION_METADAT_FILTER_TEMPLATE = [
           "(metadata.@type:CreateDatabaseMetadata AND " \
@@ -248,10 +247,10 @@ module Google
         #   response.
         #
         #   The response returns a list of
-        #   {Google::Longrunning::Operation long-running operations} whose names
+        #   `Google::Longrunning::Operation` long-running operations whose names
         #   are prefixed by a database name within the specified instance.
         #   The long-running operation
-        #   {Google::Longrunning::Operation#metadata metadata} field type
+        #   `Google::Longrunning::Operation#metadata` metadata field type
         #   `metadata.type_url` describes the type of the metadata.
         #
         #   The filter expression must specify the field name,
@@ -384,10 +383,9 @@ module Google
             )
           end
 
-          grpc = service.list_database_operations \
-            instance_id,
-            filter: database_filter,
-            page_size: page_size
+          grpc = service.list_database_operations instance_id,
+                                                  filter: database_filter,
+                                                  page_size: page_size
           Database::Job::List.from_grpc grpc, service
         end
 
@@ -573,20 +571,22 @@ module Google
         #
         #   The permissions that can be checked on a database are:
         #
-        #   * pubsub.databases.create
-        #   * pubsub.databases.list
-        #   * pubsub.databases.update
-        #   * pubsub.databases.updateDdl
-        #   * pubsub.databases.get
-        #   * pubsub.databases.getDdl
-        #   * pubsub.databases.getIamPolicy
-        #   * pubsub.databases.setIamPolicy
-        #   * pubsub.databases.beginReadOnlyTransaction
-        #   * pubsub.databases.beginOrRollbackReadWriteTransaction
-        #   * pubsub.databases.read
-        #   * pubsub.databases.select
-        #   * pubsub.databases.write
-        #   * pubsub.databases.drop
+        #  * spanner.databases.beginPartitionedDmlTransaction
+        #  * spanner.databases.create
+        #  * spanner.databases.createBackup
+        #  * spanner.databases.list
+        #  * spanner.databases.update
+        #  * spanner.databases.updateDdl
+        #  * spanner.databases.get
+        #  * spanner.databases.getDdl
+        #  * spanner.databases.getIamPolicy
+        #  * spanner.databases.setIamPolicy
+        #  * spanner.databases.beginReadOnlyTransaction
+        #  * spanner.databases.beginOrRollbackReadWriteTransaction
+        #  * spanner.databases.read
+        #  * spanner.databases.select
+        #  * spanner.databases.write
+        #  * spanner.databases.drop
         #
         # @return [Array<Strings>] The permissions that have access.
         #
@@ -611,7 +611,7 @@ module Google
 
         ##
         # @private Creates a new Database instance from a
-        # Google::Spanner::Admin::Database::V1::Database.
+        # `Google::Cloud::Spanner::Admin::Database::V1::Database`.
         def self.from_grpc grpc, service
           new grpc, service
         end

data/lib/google/cloud/spanner/database/backup_info.rb

@@ -94,7 +94,7 @@ module Google
 
           ##
           # @private Creates a new Database::BackupInfo instance from a
-          # Google::Spanner::Admin::Database::V1::BackupInfo.
+          # `Google::Cloud::Spanner::Admin::Database::V1::BackupInfo`.
           def self.from_grpc grpc
             new grpc
           end

data/lib/google/cloud/spanner/database/job.rb

@@ -52,7 +52,7 @@ module Google
         #
         class Job
           ##
-          # @private The Google::Gax::Operation gRPC object.
+          # @private The `Gapic::Operation` gRPC object.
           attr_accessor :grpc
 
           ##
@@ -89,7 +89,7 @@ module Google
             return nil unless done?
             return nil unless @grpc.grpc_op.result == :response
             return nil unless @grpc.results.instance_of? \
-              Google::Spanner::Admin::Database::V1::Database
+              Admin::Database::V1::Database
             Database.from_grpc @grpc.results, service
           end
 
@@ -201,7 +201,7 @@ module Google
           end
 
           ##
-          # @private New Database::Job from a Google::Gax::Operation object.
+          # @private New Database::Job from a `Gapic::Operation` object.
           def self.from_grpc grpc, service
             new.tap do |job|
               job.instance_variable_set :@grpc, grpc

data/lib/google/cloud/spanner/database/job/list.rb

@@ -146,7 +146,7 @@ module Google
             # @private
             #
             # New Database::Job::List from a
-            # Google::Gax::PagedEnumerable<Google::Longrunning::Operation>
+            # `Gapic::PagedEnumerable<Google::Longrunning::Operation>`
             # object. Operation object is a database operation.
             #
             def self.from_grpc grpc, service
@@ -154,7 +154,7 @@ module Google
                 service.databases.instance_variable_get "@operations_client"
               jobs = new(Array(grpc.response.operations).map do |job_grpc|
                 Job.from_grpc \
-                  Google::Gax::Operation.new(job_grpc, operations_client),
+                  Gapic::Operation.new(job_grpc, operations_client),
                   service
               end)
               jobs.grpc = grpc

data/lib/google/cloud/spanner/database/list.rb

@@ -142,7 +142,7 @@ module Google
 
           ##
           # @private New Database::List from a
-          # Google::Spanner::Admin::Database::V1::ListDatabasesResponse
+          # `Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse`
           # object.
           def self.from_grpc grpc, service, instance_id, max = nil
             databases = List.new(Array(grpc.databases).map do |database|

data/lib/google/cloud/spanner/database/restore_info.rb

@@ -52,7 +52,7 @@ module Google
 
           ##
           # @private Creates a new Database::RestoreInfo instance from a
-          # Google::Spanner::Admin::Database::V1::RestoreInfo.
+          # `Google::Cloud::Spanner::Admin::Database::V1::RestoreInfo`
           def self.from_grpc grpc
             new grpc
           end

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

@@ -372,9 +372,9 @@ module Google
         ##
         # @private
         def to_grpc_type
-          Google::Spanner::V1::Type.new(
+          V1::Type.new(
             code: :STRUCT,
-            struct_type: Google::Spanner::V1::StructType.new(
+            struct_type: V1::StructType.new(
               fields: @grpc_fields
             )
           )
@@ -382,7 +382,7 @@ module Google
 
         ##
         # @private Creates a new Fields instance from a
-        # Google::Spanner::V1::Metadata::Row_type::Fields.
+        # V1::Metadata::Row_type::Fields.
         def self.from_grpc fields
           new([]).tap do |f|
             f.instance_variable_set :@grpc_fields, Array(fields)
@@ -412,18 +412,18 @@ module Google
           if pair.is_a?(Array)
             if pair.count == 2
               if pair.first.is_a?(Integer)
-                Google::Spanner::V1::StructType::Field.new(
+                V1::StructType::Field.new(
                   type: Convert.grpc_type_for_field(pair.last)
                 )
               else
-                Google::Spanner::V1::StructType::Field.new(
+                V1::StructType::Field.new(
                   name: String(pair.first),
                   type: Convert.grpc_type_for_field(pair.last)
                 )
               end
             else
-              Google::Spanner::V1::StructType::Field.new(
-                type: Google::Spanner::V1::Type.new(
+              V1::StructType::Field.new(
+                type: V1::Type.new(
                   code: :ARRAY,
                   array_element_type: Convert.grpc_type_for_field(pair.last)
                 )
@@ -435,7 +435,7 @@ module Google
             unless pair.is_a?(Symbol)
               raise ArgumentError, "type must be a symbol"
             end
-            Google::Spanner::V1::StructType::Field.new(
+            V1::StructType::Field.new(
               type: Convert.grpc_type_for_field(pair)
             )
           end

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

@@ -342,10 +342,10 @@ module Google
         #   response.
         #
         #   The response returns a list of
-        #   {Google::Longrunning::Operation long-running operations} whose names
+        #  `Google::Longrunning::Operation` long-running operations whose names
         #   are prefixed by a database name within the specified instance.
         #   The long-running operation
-        #   {Google::Longrunning::Operation#metadata metadata} field type
+        #   `Google::Longrunning::Operation#metadata` metadata field type
         #   `metadata.type_url` describes the type of the metadata.
         #
         #   The filter expression must specify the field name,
@@ -603,10 +603,10 @@ module Google
         #   response.
         #
         #   The response returns a list of
-        #   {Google::Longrunning::Operation long-running operations} whose names
+        #   `Google::Longrunning::Operation` long-running operations whose names
         #   are prefixed by a backup name within the specified instance.
         #   The long-running operation
-        #   {Google::Longrunning::Operation#metadata metadata} field type
+        #   `Google::Longrunning::Operation#metadata` metadata field type
         #   `metadata.type_url` describes the type of the metadata.
         #
         #   The filter expression must specify the field name of an operation, a
@@ -856,7 +856,7 @@ module Google
 
         ##
         # @private Creates a new Instance instance from a
-        # Google::Spanner::Admin::Instance::V1::Instance.
+        # `Google::Cloud::Spanner::Admin::Instance::V1::Instance`.
         def self.from_grpc grpc, service
           new grpc, service
         end
@@ -869,13 +869,6 @@ module Google
         def ensure_service!
           raise "Must have active connection to service" unless service
         end
-
-        def instance_config_path name
-          return name if name.to_s.include? "/"
-          Admin::Instance::V1::InstanceAdminClient.instance_config_path(
-            project, name.to_s
-          )
-        end
       end
     end
   end

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

@@ -77,7 +77,7 @@ module Google
 
           ##
           # @private Creates a new Instance::Config instance from a
-          # Google::Spanner::Admin::Instance::V1::InstanceConfig.
+          # `Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig`.
           def self.from_grpc grpc
             new grpc
           end

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

@@ -142,7 +142,7 @@ module Google
 
             ##
             # @private New Instance::Config::List from a
-            # Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse
+            # `Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse`
             # object.
             def self.from_grpc grpc, service, max = nil
               configs = List.new(Array(grpc.instance_configs).map do |config|

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

@@ -54,7 +54,7 @@ module Google
         #
         class Job
           ##
-          # @private The Google::Gax::Operation gRPC object.
+          # @private The `Gapic::Operation` gRPC object.
           attr_accessor :grpc
 
           ##
@@ -219,7 +219,7 @@ module Google
           end
 
           ##
-          # @private New Instance::Job from a Google::Gax::Operation object.
+          # @private New Instance::Job from a `Gapic::Operation` object.
           def self.from_grpc grpc, service
             new.tap do |job|
               job.instance_variable_set :@grpc, grpc

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

@@ -139,7 +139,7 @@ module Google
 
           ##
           # @private New Instance::List from a
-          # Google::Spanner::Admin::Instance::V1::ListInstancesResponse
+          # `Google::Cloud::Spanner::Admin::Instance::V1::ListInstancesResponse`
           # object.
           def self.from_grpc grpc, service, max = nil
             instances = List.new(Array(grpc.instances).map do |instance|

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

@@ -172,13 +172,13 @@ module Google
           new.tap do |p|
             if data[:execute]
               execute_sql_grpc = \
-                Google::Spanner::V1::ExecuteSqlRequest.decode(
+                V1::ExecuteSqlRequest.decode(
                   Base64.decode64(data[:execute])
                 )
               p.instance_variable_set :@execute, execute_sql_grpc
             end
             if data[:read]
-              read_grpc = Google::Spanner::V1::ReadRequest.decode \
+              read_grpc = V1::ReadRequest.decode \
                 Base64.decode64(data[:read])
               p.instance_variable_set :@read, read_grpc
             end
@@ -194,7 +194,7 @@ module Google
         end
 
         ##
-        # @private New Partition from a Google::Spanner::V1::ExecuteSqlRequest
+        # @private New Partition from a `Google::Cloud::Spanner::V1::ExecuteSqlRequest`
         # object.
         def self.from_execute_sql_grpc grpc
           new.tap do |p|
@@ -203,7 +203,7 @@ module Google
         end
 
         ##
-        # @private New Partition from a Google::Spanner::V1::ReadRequest object.
+        # @private New Partition from a `Google::Cloud::Spanner::V1::ReadRequest` object.
         def self.from_read_grpc grpc
           new.tap do |p|
             p.instance_variable_set :@read, grpc

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

@@ -159,7 +159,7 @@ module Google
         end
 
         ##
-        # @private Convert the Policy to a Google::Iam::V1::Policy object.
+        # @private Convert the Policy to a `Google::Iam::V1::Policy` object.
         def to_grpc
           Google::Iam::V1::Policy.new(
             etag: etag,
@@ -174,7 +174,7 @@ module Google
         end
 
         ##
-        # @private New Policy from a Google::Iam::V1::Policy object.
+        # @private New Policy from a `Google::Iam::V1::Policy` object.
         def self.from_grpc grpc
           roles = grpc.bindings.each_with_object({}) do |binding, memo|
             memo[binding.role] = binding.members.to_a