google-cloud-spanner 2.6.0 → 2.9.0

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

@@ -69,6 +69,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -127,6 +128,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -184,6 +186,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -243,6 +246,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |

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

@@ -324,6 +324,25 @@ module Google
 
             [input_params, input_param_types]
           end
+
+          ##
+          # Build request options by replacing tag to respecitve statistics
+          # collection tag type.
+          #
+          # @param [Hash] options Common request options.
+          #   * `:tag` (String) A tag used for statistics collection.
+          #
+          # @param [Symbol] tag_type Request tag type.
+          #   Possible values are `request_tag`, `transaction_tag`
+          # @return [Hash, nil]
+          #
+          def to_request_options options, tag_type: nil
+            return unless options
+
+            return options unless options.key? :tag
+
+            options.transform_keys { |k| k == :tag ? tag_type : k }
+          end
         end
 
         # rubocop:enable all

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

@@ -113,6 +113,13 @@ module Google
           @grpc.state
         end
 
+        ##
+        # Time at which the database creation started.
+        # @return [Time]
+        def create_time
+          Convert.timestamp_to_time @grpc.create_time
+        end
+
         # An encryption configuration describing the encryption type and key
         # resources in Cloud KMS.
         #

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

@@ -57,12 +57,13 @@ module Google
         #   Hash values must contain the type value. If a Hash is used the
         #   fields will be created using the same order as the Hash keys.
         #
-        #   Supported type values incude:
+        #   Supported type values include:
         #
         #   * `:BOOL`
         #   * `:BYTES`
         #   * `:DATE`
         #   * `:FLOAT64`
+        #   * `:NUMERIC`
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`

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

@@ -68,6 +68,7 @@ module Google
         def initialize grpc, service
           @grpc = grpc
           @service = service
+          @current_values = grpc.to_h
         end
 
         # The unique identifier for the project.
@@ -134,6 +135,23 @@ module Google
         end
         alias node_count= nodes=
 
+        ##
+        # The number of processing units allocated to this instance.
+        #
+        # @return [Integer]
+        def processing_units
+          @grpc.processing_units
+        end
+
+        ##
+        # Updates number of processing units allocated to this instance.
+        #
+        # @param units [Integer] The number of processing units allocated
+        #   to this instance.
+        def processing_units= units
+          @grpc.processing_units = units
+        end
+
         ##
         # The current instance state. Possible values are `:CREATING` and
         # `:READY`.
@@ -188,8 +206,50 @@ module Google
           )
         end
 
+        ##
+        # Update changes.
+        #  `display_name`, `labels`, `nodes`, `processing_units` can be
+        #  updated. `processing_units` and `nodes` can be used interchangeably
+        #  to update.
+        #
+        # @return [Instance::Job] The job representing the long-running,
+        #   asynchronous processing of an instance update operation.
+        # @raise [ArgumentError] if both processing_units or nodes are specified.
+        #
+        # @example
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   instance = spanner.instance "my-instance"
+        #   instance.display_name = "prod-instance"
+        #   instance.labels = { env: "prod", app: "api" }
+        #   instance.nodes = 2
+        #   # OR
+        #   # instance.processing_units = 500
+        #
+        #   job = instance.save
+        #
+        #   job.done? #=> false
+        #   job.reload! # API call
+        #   job.done? #=> true
+        #
+        #   if job.error?
+        #     status = job.error
+        #   else
+        #     instance = job.instance
+        #   end
+        #
         def save
-          job_grpc = service.update_instance @grpc
+          ensure_service!
+
+          field_mask = []
+          @current_values.each do |field, value|
+            field_mask << field unless @grpc[field.to_s] == value
+          end
+
+          job_grpc = service.update_instance @grpc, field_mask: field_mask
+          @current_values = @grpc.to_h
           Instance::Job.from_grpc job_grpc, service
         end
         alias update save

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

@@ -177,7 +177,10 @@ module Google
         #   configuration. Values can be the `instance_config_id`, the full
         #   path, or an {Instance::Config} object. Required.
         # @param [Integer] nodes The number of nodes allocated to this instance.
-        #   Required.
+        #   Optional. Specify either `nodes` or `processing_units`
+        # @param [Integer] processing_units The number of processing units
+        #   allocated to this instance. Optional. Specify either `nodes`
+        #   or `processing_units`
         # @param [Hash] labels Cloud Labels are a flexible and lightweight
         #   mechanism for organizing cloud resources into groups that reflect a
         #   customer's organizational needs and deployment strategies. Cloud
@@ -195,6 +198,7 @@ module Google
         #
         # @return [Instance::Job] The job representing the long-running,
         #   asynchronous processing of an instance create operation.
+        # @raise [ArgumentError] if both processing_units or nodes are specified.
         #
         # @example
         #   require "google/cloud/spanner"
@@ -217,14 +221,36 @@ module Google
         #     instance = job.instance
         #   end
         #
+        # @example Create instance using processsing units
+        #   require "google/cloud/spanner"
+        #
+        #   spanner = Google::Cloud::Spanner.new
+        #
+        #   job = spanner.create_instance "my-new-instance",
+        #                                 name: "My New Instance",
+        #                                 config: "regional-us-central1",
+        #                                 processing_units: 500,
+        #                                 labels: { production: :env }
+        #
+        #   job.done? #=> false
+        #   job.reload! # API call
+        #   job.done? #=> true
+        #
+        #   if job.error?
+        #     status = job.error
+        #   else
+        #     instance = job.instance
+        #   end
+        #
         def create_instance instance_id, name: nil, config: nil, nodes: nil,
-                            labels: nil
+                            processing_units: nil, labels: nil
           config = config.path if config.respond_to? :path
+
           # Convert from possible Google::Protobuf::Map
           labels = Hash[labels.map { |k, v| [String(k), String(v)] }] if labels
           grpc = service.create_instance \
             instance_id, name: name, config: config, nodes: nodes,
-                         labels: labels
+                         processing_units: processing_units, labels: labels
           Instance::Job.from_grpc grpc, service
         end
 
@@ -490,6 +516,8 @@ module Google
         #   * `:optimizer_version` (String) The version of optimizer to use.
         #     Empty to use database default. "latest" to use the latest
         #     available optimizer version.
+        #   * `:optimizer_statistics_package` (String) Statistics package to
+        #     use. Empty to use the database default.
         #
         # @return [Client] The newly created client.
         #
@@ -554,6 +582,8 @@ module Google
         #   * `:optimizer_version` (String) The version of optimizer to use.
         #     Empty to use database default. "latest" to use the latest
         #     available optimizer version.
+        #   * `:optimizer_statistics_package` (String) Statistics package to
+        #     use. Empty to use the database default.
         #
         # @return [Client] The newly created client.
         #

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

@@ -319,11 +319,13 @@ module Google
         def self.execute_query service, session_path, sql, params: nil,
                                types: nil, transaction: nil,
                                partition_token: nil, seqno: nil,
-                               query_options: nil, call_options: nil
+                               query_options: nil, request_options: nil,
+                               call_options: nil
           execute_query_options = {
             transaction: transaction, params: params, types: types,
             partition_token: partition_token, seqno: seqno,
-            query_options: query_options, call_options: call_options
+            query_options: query_options, request_options: request_options,
+            call_options: call_options
           }
           enum = service.execute_streaming_sql session_path, sql,
                                                **execute_query_options
@@ -338,11 +340,13 @@ module Google
         # @private
         def self.read service, session_path, table, columns, keys: nil,
                       index: nil, limit: nil, transaction: nil,
-                      partition_token: nil, call_options: nil
+                      partition_token: nil, request_options: nil,
+                      call_options: nil
           read_options = {
             keys: keys, index: index, limit: limit,
             transaction: transaction,
             partition_token: partition_token,
+            request_options: request_options,
             call_options: call_options
           }
           enum = service.streaming_read_table \

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

@@ -127,13 +127,15 @@ module Google
         end
 
         def create_instance instance_id, name: nil, config: nil, nodes: nil,
-                            labels: nil, call_options: nil
+                            processing_units: nil, labels: nil,
+                            call_options: nil
           opts = default_options call_options: call_options
           labels = Hash[labels.map { |k, v| [String(k), String(v)] }] if labels
 
           create_obj = Admin::Instance::V1::Instance.new({
             display_name: name, config: instance_config_path(config),
-            node_count: nodes, labels: labels
+            node_count: nodes, processing_units: processing_units,
+            labels: labels
           }.delete_if { |_, v| v.nil? })
 
           request = {
@@ -144,12 +146,17 @@ module Google
           instances.create_instance request, opts
         end
 
-        def update_instance instance, call_options: nil
+        def update_instance instance, field_mask: nil, call_options: nil
           opts = default_options call_options: call_options
-          mask = Google::Protobuf::FieldMask.new(
-            paths: %w[display_name node_count labels]
-          )
-          request = { instance: instance, field_mask: mask }
+
+          if field_mask.nil? || field_mask.empty?
+            field_mask = %w[display_name node_count labels]
+          end
+
+          request = {
+            instance: instance,
+            field_mask: Google::Protobuf::FieldMask.new(paths: field_mask)
+          }
           instances.update_instance request, opts
         end
 
@@ -313,7 +320,8 @@ module Google
         def execute_streaming_sql session_name, sql, transaction: nil,
                                   params: nil, types: nil, resume_token: nil,
                                   partition_token: nil, seqno: nil,
-                                  query_options: nil, call_options: nil
+                                  query_options: nil, request_options: nil,
+                                  call_options: nil
           opts = default_options session_name: session_name,
                                  call_options: call_options
           request =  {
@@ -325,13 +333,14 @@ module Google
             resume_token: resume_token,
             partition_token: partition_token,
             seqno: seqno,
-            query_options: query_options
+            query_options: query_options,
+            request_options: request_options
           }
           service.execute_streaming_sql request, opts
         end
 
         def execute_batch_dml session_name, transaction, statements, seqno,
-                              call_options: nil
+                              request_options: nil, call_options: nil
           opts = default_options session_name: session_name,
                                  call_options: call_options
           statements = statements.map(&:to_grpc)
@@ -339,7 +348,8 @@ module Google
             session: session_name,
             transaction: transaction,
             statements: statements,
-            seqno: seqno
+            seqno: seqno,
+            request_options: request_options
           }
           results = service.execute_batch_dml request, opts
 
@@ -357,14 +367,14 @@ module Google
         def streaming_read_table session_name, table_name, columns, keys: nil,
                                  index: nil, transaction: nil, limit: nil,
                                  resume_token: nil, partition_token: nil,
-                                 call_options: nil
+                                 request_options: nil, call_options: nil
           opts = default_options session_name: session_name,
                                  call_options: call_options
           request = {
             session: session_name, table: table_name, columns: columns,
             key_set: keys, transaction: transaction, index: index,
             limit: limit, resume_token: resume_token,
-            partition_token: partition_token
+            partition_token: partition_token, request_options: request_options
           }
           service.streaming_read request, opts
         end
@@ -402,7 +412,7 @@ module Google
         end
 
         def commit session_name, mutations = [], transaction_id: nil,
-                   commit_options: nil, call_options: nil
+                   commit_options: nil, request_options: nil, call_options: nil
           tx_opts = nil
           if transaction_id.nil?
             tx_opts = V1::TransactionOptions.new(
@@ -413,7 +423,8 @@ module Google
                                  call_options: call_options
           request = {
             session: session_name, transaction_id: transaction_id,
-            single_use_transaction: tx_opts, mutations: mutations
+            single_use_transaction: tx_opts, mutations: mutations,
+            request_options: request_options
           }
 
           if commit_options
@@ -430,13 +441,18 @@ module Google
           service.rollback request, opts
         end
 
-        def begin_transaction session_name, call_options: nil
+        def begin_transaction session_name, request_options: nil,
+                              call_options: nil
           tx_opts = V1::TransactionOptions.new(
             read_write: V1::TransactionOptions::ReadWrite.new
           )
           opts = default_options session_name: session_name,
                                  call_options: call_options
-          request = { session: session_name, options: tx_opts }
+          request = {
+            session: session_name,
+            options: tx_opts,
+            request_options: request_options
+          }
           service.begin_transaction request, opts
         end
 

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

@@ -116,6 +116,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -141,6 +142,7 @@ module Google
         #   * `:BYTES`
         #   * `:DATE`
         #   * `:FLOAT64`
+        #   * `:NUMERIC`
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
@@ -163,6 +165,25 @@ module Google
         #   * `:optimizer_version` (String) The version of optimizer to use.
         #     Empty to use database default. "latest" to use the latest
         #     available optimizer version.
+        #   * `:optimizer_statistics_package` (String) Statistics package to
+        #     use. Empty to use the database default.
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -283,7 +304,10 @@ module Google
         #   db = spanner.client "my-instance", "my-database"
         #
         #   results = db.execute_query \
-        #     "SELECT * FROM users", query_options: { optimizer_version: "1" }
+        #     "SELECT * FROM users", query_options: {
+        #       optimizer_version: "1",
+        #       optimizer_statistics_package: "auto_20191128_14_47_22UTC"
+        #     }
         #
         #   results.rows.each do |row|
         #     puts "User #{row[:id]} is #{row[:name]}"
@@ -314,7 +338,7 @@ module Google
         #
         def execute_query sql, params: nil, types: nil, transaction: nil,
                           partition_token: nil, seqno: nil, query_options: nil,
-                          call_options: nil
+                          request_options: nil, call_options: nil
           ensure_service!
           if query_options.nil?
             query_options = @query_options
@@ -328,6 +352,7 @@ module Google
                                           partition_token: partition_token,
                                           seqno: seqno,
                                           query_options: query_options,
+                                          request_options: request_options,
                                           call_options: call_options
           @last_updated_at = Time.now
           results
@@ -341,6 +366,23 @@ module Google
         #   transactions.
         # @param [Integer] seqno A per-transaction sequence number used to
         #   identify this request.
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -369,7 +411,8 @@ module Google
         # @return [Array<Integer>] A list with the exact number of rows that
         #   were modified for each DML statement.
         #
-        def batch_update transaction, seqno, call_options: nil
+        def batch_update transaction, seqno, request_options: nil,
+                         call_options: nil
           ensure_service!
 
           raise ArgumentError, "block is required" unless block_given?
@@ -379,6 +422,7 @@ module Google
 
           results = service.execute_batch_dml path, transaction,
                                               batch.statements, seqno,
+                                              request_options: request_options,
                                               call_options: call_options
           @last_updated_at = Time.now
           results
@@ -403,6 +447,23 @@ module Google
         # @param [Google::Cloud::Spanner::V1::TransactionSelector] transaction The
         #   transaction selector value to send. Only used for single-use
         #   transactions.
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -434,13 +495,15 @@ module Google
         #   end
         #
         def read table, columns, keys: nil, index: nil, limit: nil,
-                 transaction: nil, partition_token: nil, call_options: nil
+                 transaction: nil, partition_token: nil, request_options: nil,
+                 call_options: nil
           ensure_service!
 
           results = Results.read service, path, table, columns,
                                  keys: keys, index: index, limit: limit,
                                  transaction: transaction,
                                  partition_token: partition_token,
+                                 request_options: request_options,
                                  call_options: call_options
           @last_updated_at = Time.now
           results
@@ -494,6 +557,23 @@ module Google
         #     {CommitResponse}. Default value is `false`
         #
         # transaction. Default it is `false`.
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -542,13 +622,15 @@ module Google
         #   puts commit_resp.timestamp
         #   puts commit_resp.stats.mutation_count
         #
-        def commit transaction_id: nil, commit_options: nil, call_options: nil
+        def commit transaction_id: nil, commit_options: nil,
+                   request_options: nil, call_options: nil
           ensure_service!
           commit = Commit.new
           yield commit
           commit_resp = service.commit path, commit.mutations,
                                        transaction_id: transaction_id,
                                        commit_options: commit_options,
+                                       request_options: request_options,
                                        call_options: call_options
           @last_updated_at = Time.now
           resp = CommitResponse.from_grpc commit_resp
@@ -573,6 +655,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -590,6 +673,23 @@ module Google
         #     then statistics related to the transaction will be included in
         #     {CommitResponse}. Default value is `false`
         #
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -633,10 +733,11 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def upsert table, *rows, transaction_id: nil, commit_options: nil,
-                   call_options: nil
+                   request_options: nil, call_options: nil
           opts = {
             transaction_id: transaction_id,
             commit_options: commit_options,
+            request_options: request_options,
             call_options: call_options
           }
           commit(**opts) do |c|
@@ -662,6 +763,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -679,6 +781,23 @@ module Google
         #     then statistics related to the transaction will be included in
         #     {CommitResponse}. Default value is `false`
         #
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -722,10 +841,11 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def insert table, *rows, transaction_id: nil, commit_options: nil,
-                   call_options: nil
+                   request_options: nil, call_options: nil
           opts = {
             transaction_id: transaction_id,
             commit_options: commit_options,
+            request_options: request_options,
             call_options: call_options
           }
           commit(**opts) do |c|
@@ -750,6 +870,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -767,6 +888,23 @@ module Google
         #     then statistics related to the transaction will be included in
         #     {CommitResponse}. Default value is `false`
         #
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -810,10 +948,11 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def update table, *rows, transaction_id: nil, commit_options: nil,
-                   call_options: nil
+                   request_options: nil, call_options: nil
           opts = {
             transaction_id: transaction_id,
             commit_options: commit_options,
+            request_options: request_options,
             call_options: call_options
           }
           commit(**opts) do |c|
@@ -840,6 +979,7 @@ module Google
         #   | `BOOL`      | `true`/`false` | |
         #   | `INT64`     | `Integer`      | |
         #   | `FLOAT64`   | `Float`        | |
+        #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
@@ -857,6 +997,23 @@ module Google
         #     then statistics related to the transaction will be included in
         #     {CommitResponse}. Default value is `false`.
         #
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -900,10 +1057,11 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def replace table, *rows, transaction_id: nil, commit_options: nil,
-                    call_options: nil
+                    request_options: nil, call_options: nil
           opts = {
             transaction_id: transaction_id,
             commit_options: commit_options,
+            request_options: request_options,
             call_options: call_options
           }
           commit(**opts) do |c|
@@ -928,6 +1086,23 @@ module Google
         #     then statistics related to the transaction will be included in
         #     {CommitResponse}. Default value is `false`
         #
+        # @param [Hash] request_options Common request options.
+        #
+        #   * `:request_tag` (String) A per-request tag which can be applied
+        #     to queries or reads, used for statistics collection. Both
+        #     request_tag and transaction_tag can be specified for a read or
+        #     query that belongs to a transaction. This field is ignored for
+        #     requests where it's not applicable (e.g. CommitRequest).
+        #     `request_tag` must be a valid identifier of the form:
+        #     `[a-zA-Z][a-zA-Z0-9_\-]` between 2 and 64 characters in length.
+        #   * `:transaction_tag` (String) A tag used for statistics collection
+        #     about this transaction. Both request_tag and transaction_tag can
+        #     be specified for a read or query that belongs to a transaction.
+        #     The value of transaction_tag should be the same for all requests
+        #     belonging to the same transaction. If this request doesn't belong
+        #     to any transaction, transaction_tag will be ignored.
+        #     `transaction_tag` must be a valid identifier of the format:
+        #     [a-zA-Z][a-zA-Z0-9_\-]{0,49}
         # @param [Hash] call_options A hash of values to specify the custom
         #   call options, e.g., timeout, retries, etc. Call options are
         #   optional. The following settings can be provided:
@@ -968,10 +1143,11 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def delete table, keys = [], transaction_id: nil, commit_options: nil,
-                   call_options: nil
+                   request_options: nil, call_options: nil
           opts = {
             transaction_id: transaction_id,
             commit_options: commit_options,
+            request_options: request_options,
             call_options: call_options
           }
           commit(**opts) do |c|