google-apis-spanner_v1 0.6.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f99ff9f6821502c873da0a908d418d033a1f6d9baff866c14287c1b6e5d4a1fb
-  data.tar.gz: ee944ff1114fdedcddf45fd62a9e5713e46118bfa87356193ca619f0b4ab54da
+  metadata.gz: 4fe2a36134fd6ba4b1a4aa60736544fb9f1cfd1edb04c3b58afa5c15f48cd4f2
+  data.tar.gz: '09ee659f8263048d5acabdc2e0b17338f1bcfff0d44db12259e840496c6c3e08'
 SHA512:
-  metadata.gz: 3b00aa6d4ba8ed6403127765bb9f86126791f6a9ff3b3f20f65986d6304a295f4d50478d60639f459cc817920673a6db06a970c99f30302f86b1f18157edbbea
-  data.tar.gz: f2afbdbc190d30b4824c01f09ac50d841638e2b0fc6d9b61f505bc128fa1fd986091b753c92f256e9677da2e8dd12406ed50942ea63f96e9d0b46857dab61c88
+  metadata.gz: 0c23a445d9966cc458a967cd6013672ff8f1d9e2ff8375cc1cd50fd98789f10701adb78cc20388fe5d3c84761753b076ab28a5beb6434ea34074c4cddebaa570
+  data.tar.gz: a7aba698c3932248b83fceeb28820b0e940c5dd77976951a27f835312bc3030de2813922ddeda4c168df5679b9551ec454276126df2b963d02ccb556ecb1c285

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release history for google-apis-spanner_v1
 
+### v0.11.0 (2021-06-03)
+
+* Regenerated from discovery document revision 20210527
+* Regenerated using generator version 0.3.0
+
+### v0.10.0 (2021-05-22)
+
+* Regenerated from discovery document revision 20210517
+* Unspecified changes
+
+### v0.9.0 (2021-04-17)
+
+* Regenerated from discovery document revision 20210405
+
+### v0.8.0 (2021-04-01)
+
+* Regenerated from discovery document revision 20210325
+
+### v0.7.0 (2021-03-26)
+
+* Regenerated from discovery document revision 20210318
+
 ### v0.6.0 (2021-03-13)
 
 * Regenerated from discovery document revision 20210309

data/lib/google/apis/spanner_v1.rb

@@ -30,7 +30,7 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V1'
 
-      # View and manage your data across Google Cloud Platform services
+      # See, edit, configure, and delete your Google Cloud Platform data
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 
       # Administer your Spanner databases

data/lib/google/apis/spanner_v1/classes.rb

@@ -364,6 +364,11 @@ module Google
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :options
       
+        # Common request options for various APIs.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::SpannerV1::RequestOptions]
+        attr_accessor :request_options
+      
         def initialize(**args)
            update!(**args)
         end
@@ -371,6 +376,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @options = args[:options] if args.key?(:options)
+          @request_options = args[:request_options] if args.key?(:request_options)
         end
       end
       
@@ -494,6 +500,11 @@ module Google
         # @return [Array<Google::Apis::SpannerV1::Mutation>]
         attr_accessor :mutations
       
+        # Common request options for various APIs.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::SpannerV1::RequestOptions]
+        attr_accessor :request_options
+      
         # If `true`, then statistics related to the transaction will be included in the
         # CommitResponse. Default value is `false`.
         # Corresponds to the JSON property `returnCommitStats`
@@ -677,6 +688,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @mutations = args[:mutations] if args.key?(:mutations)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @return_commit_stats = args[:return_commit_stats] if args.key?(:return_commit_stats)
           @single_use_transaction = args[:single_use_transaction] if args.key?(:single_use_transaction)
           @transaction_id = args[:transaction_id] if args.key?(:transaction_id)
@@ -715,11 +727,11 @@ module Google
         # The total number of mutations for the transaction. Knowing the `mutation_count`
         # value can help you maximize the number of mutations in a transaction and
         # minimize the number of API round trips. You can also monitor this value to
-        # prevent transactions from exceeding the system [limit](http://cloud.google.com/
-        # spanner/quotas#limits_for_creating_reading_updating_and_deleting_data). If the
-        # number of mutations exceeds the limit, the server returns [INVALID_ARGUMENT](
-        # http://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.
-        # INVALID_ARGUMENT).
+        # prevent transactions from exceeding the system [limit](https://cloud.google.
+        # com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data). If
+        # the number of mutations exceeds the limit, the server returns [
+        # INVALID_ARGUMENT](https://cloud.google.com/spanner/docs/reference/rest/v1/Code#
+        # ENUM_VALUES.INVALID_ARGUMENT).
         # Corresponds to the JSON property `mutationCount`
         # @return [Fixnum]
         attr_accessor :mutation_count
@@ -734,6 +746,45 @@ module Google
         end
       end
       
+      # A message representing context for a KeyRangeInfo, including a label, value,
+      # unit, and severity.
+      class ContextValue
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `label`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :label
+      
+        # The severity of this context.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # The unit of the context value.
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
+        # The value for the context.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label = args[:label] if args.key?(:label)
+          @severity = args[:severity] if args.key?(:severity)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Metadata type for the operation returned by CreateBackup.
       class CreateBackupMetadata
         include Google::Apis::Core::Hashable
@@ -1024,6 +1075,85 @@ module Google
         end
       end
       
+      # A message representing a derived metric.
+      class DerivedMetric
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `denominator`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :denominator
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `numerator`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :numerator
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @denominator = args[:denominator] if args.key?(:denominator)
+          @numerator = args[:numerator] if args.key?(:numerator)
+        end
+      end
+      
+      # A message representing the key visualizer diagnostic messages.
+      class DiagnosticMessage
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `metric`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :metric
+      
+        # Whether this message is specific only for the current metric. By default
+        # Diagnostics are shown for all metrics, regardless which metric is the
+        # currently selected metric in the UI. However occasionally a metric will
+        # generate so many messages that the resulting visual clutter becomes
+        # overwhelming. In this case setting this to true, will show the diagnostic
+        # messages for that metric only if it is the currently selected metric.
+        # Corresponds to the JSON property `metricSpecific`
+        # @return [Boolean]
+        attr_accessor :metric_specific
+        alias_method :metric_specific?, :metric_specific
+      
+        # The severity of the diagnostic message.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `shortMessage`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :short_message
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @info = args[:info] if args.key?(:info)
+          @metric = args[:metric] if args.key?(:metric)
+          @metric_specific = args[:metric_specific] if args.key?(:metric_specific)
+          @severity = args[:severity] if args.key?(:severity)
+          @short_message = args[:short_message] if args.key?(:short_message)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -1102,6 +1232,11 @@ module Google
       class ExecuteBatchDmlRequest
         include Google::Apis::Core::Hashable
       
+        # Common request options for various APIs.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::SpannerV1::RequestOptions]
+        attr_accessor :request_options
+      
         # Required. A per-transaction sequence number used to identify this request.
         # This field makes each request idempotent such that if the request is received
         # multiple times, at most one will succeed. The sequence number must be
@@ -1134,6 +1269,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @seqno = args[:seqno] if args.key?(:seqno)
           @statements = args[:statements] if args.key?(:statements)
           @transaction = args[:transaction] if args.key?(:transaction)
@@ -1232,6 +1368,11 @@ module Google
         # @return [Google::Apis::SpannerV1::QueryOptions]
         attr_accessor :query_options
       
+        # Common request options for various APIs.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::SpannerV1::RequestOptions]
+        attr_accessor :request_options
+      
         # If this request is resuming a previously interrupted SQL statement execution, `
         # resume_token` should be copied from the last PartialResultSet yielded before
         # the interruption. Doing this enables the new SQL statement execution to resume
@@ -1275,6 +1416,7 @@ module Google
           @partition_token = args[:partition_token] if args.key?(:partition_token)
           @query_mode = args[:query_mode] if args.key?(:query_mode)
           @query_options = args[:query_options] if args.key?(:query_options)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @resume_token = args[:resume_token] if args.key?(:resume_token)
           @seqno = args[:seqno] if args.key?(:seqno)
           @sql = args[:sql] if args.key?(:sql)
@@ -1430,6 +1572,49 @@ module Google
         end
       end
       
+      # A message representing a (sparse) collection of hot keys for specific key
+      # buckets.
+      class IndexedHotKey
+        include Google::Apis::Core::Hashable
+      
+        # A (sparse) mapping from key bucket index to the index of the specific hot row
+        # key for that key bucket. The index of the hot row key can be translated to the
+        # actual row key via the ScanData.VisualizationData.indexed_keys repeated field.
+        # Corresponds to the JSON property `sparseHotKeys`
+        # @return [Hash<String,Fixnum>]
+        attr_accessor :sparse_hot_keys
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sparse_hot_keys = args[:sparse_hot_keys] if args.key?(:sparse_hot_keys)
+        end
+      end
+      
+      # A message representing a (sparse) collection of KeyRangeInfos for specific key
+      # buckets.
+      class IndexedKeyRangeInfos
+        include Google::Apis::Core::Hashable
+      
+        # A (sparse) mapping from key bucket index to the KeyRangeInfos for that key
+        # bucket.
+        # Corresponds to the JSON property `keyRangeInfos`
+        # @return [Hash<String,Google::Apis::SpannerV1::KeyRangeInfos>]
+        attr_accessor :key_range_infos
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @key_range_infos = args[:key_range_infos] if args.key?(:key_range_infos)
+        end
+      end
+      
       # An isolated set of Cloud Spanner resources on which databases can be hosted.
       class Instance
         include Google::Apis::Core::Hashable
@@ -1618,6 +1803,97 @@ module Google
         end
       end
       
+      # A message representing information for a key range (possibly one key).
+      class KeyRangeInfo
+        include Google::Apis::Core::Hashable
+      
+        # The list of context values for this key range.
+        # Corresponds to the JSON property `contextValues`
+        # @return [Array<Google::Apis::SpannerV1::ContextValue>]
+        attr_accessor :context_values
+      
+        # The index of the end key in indexed_keys.
+        # Corresponds to the JSON property `endKeyIndex`
+        # @return [Fixnum]
+        attr_accessor :end_key_index
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # The number of keys this range covers.
+        # Corresponds to the JSON property `keysCount`
+        # @return [Fixnum]
+        attr_accessor :keys_count
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `metric`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :metric
+      
+        # The index of the start key in indexed_keys.
+        # Corresponds to the JSON property `startKeyIndex`
+        # @return [Fixnum]
+        attr_accessor :start_key_index
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `unit`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :unit
+      
+        # The value of the metric.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @context_values = args[:context_values] if args.key?(:context_values)
+          @end_key_index = args[:end_key_index] if args.key?(:end_key_index)
+          @info = args[:info] if args.key?(:info)
+          @keys_count = args[:keys_count] if args.key?(:keys_count)
+          @metric = args[:metric] if args.key?(:metric)
+          @start_key_index = args[:start_key_index] if args.key?(:start_key_index)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # A message representing a list of specific information for multiple key ranges.
+      class KeyRangeInfos
+        include Google::Apis::Core::Hashable
+      
+        # The list individual KeyRangeInfos.
+        # Corresponds to the JSON property `infos`
+        # @return [Array<Google::Apis::SpannerV1::KeyRangeInfo>]
+        attr_accessor :infos
+      
+        # The total size of the list of all KeyRangeInfos. This may be larger than the
+        # number of repeated messages above. If that is the case, this number may be
+        # used to determine how many are not being shown.
+        # Corresponds to the JSON property `totalSize`
+        # @return [Fixnum]
+        attr_accessor :total_size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @infos = args[:infos] if args.key?(:infos)
+          @total_size = args[:total_size] if args.key?(:total_size)
+        end
+      end
+      
       # `KeySet` defines a collection of Cloud Spanner keys and/or key ranges. All the
       # keys are expected to be in the same table or index. The keys need not be
       # sorted in any particular way. If the same key is specified multiple times in
@@ -1855,6 +2131,32 @@ module Google
         end
       end
       
+      # Response method from the ListScans method.
+      class ListScansResponse
+        include Google::Apis::Core::Hashable
+      
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Available scans based on the list query parameters.
+        # Corresponds to the JSON property `scans`
+        # @return [Array<Google::Apis::SpannerV1::Scan>]
+        attr_accessor :scans
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @scans = args[:scans] if args.key?(:scans)
+        end
+      end
+      
       # The response for ListSessions.
       class ListSessionsResponse
         include Google::Apis::Core::Hashable
@@ -1881,6 +2183,179 @@ module Google
         end
       end
       
+      # A message representing a user-facing string whose value may need to be
+      # translated before being displayed.
+      class LocalizedString
+        include Google::Apis::Core::Hashable
+      
+        # A map of arguments used when creating the localized message. Keys represent
+        # parameter names which may be used by the localized version when substituting
+        # dynamic values.
+        # Corresponds to the JSON property `args`
+        # @return [Hash<String,String>]
+        attr_accessor :args
+      
+        # The canonical English version of this message. If no token is provided or the
+        # front-end has no message associated with the token, this text will be
+        # displayed as-is.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be
+        # unique within the service.
+        # Corresponds to the JSON property `token`
+        # @return [String]
+        attr_accessor :token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @args = args[:args] if args.key?(:args)
+          @message = args[:message] if args.key?(:message)
+          @token = args[:token] if args.key?(:token)
+        end
+      end
+      
+      # A message representing the actual monitoring data, values for each key bucket
+      # over time, of a metric.
+      class Metric
+        include Google::Apis::Core::Hashable
+      
+        # The aggregation function used to aggregate each key bucket
+        # Corresponds to the JSON property `aggregation`
+        # @return [String]
+        attr_accessor :aggregation
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `category`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :category
+      
+        # A message representing a derived metric.
+        # Corresponds to the JSON property `derived`
+        # @return [Google::Apis::SpannerV1::DerivedMetric]
+        attr_accessor :derived
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `displayLabel`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :display_label
+      
+        # Whether the metric has any non-zero data.
+        # Corresponds to the JSON property `hasNonzeroData`
+        # @return [Boolean]
+        attr_accessor :has_nonzero_data
+        alias_method :has_nonzero_data?, :has_nonzero_data
+      
+        # The value that is considered hot for the metric. On a per metric basis hotness
+        # signals high utilization and something that might potentially be a cause for
+        # concern by the end user. hot_value is used to calibrate and scale visual color
+        # scales.
+        # Corresponds to the JSON property `hotValue`
+        # @return [Float]
+        attr_accessor :hot_value
+      
+        # The (sparse) mapping from time index to an IndexedHotKey message, representing
+        # those time intervals for which there are hot keys.
+        # Corresponds to the JSON property `indexedHotKeys`
+        # @return [Hash<String,Google::Apis::SpannerV1::IndexedHotKey>]
+        attr_accessor :indexed_hot_keys
+      
+        # The (sparse) mapping from time interval index to an IndexedKeyRangeInfos
+        # message, representing those time intervals for which there are informational
+        # messages concerning key ranges.
+        # Corresponds to the JSON property `indexedKeyRangeInfos`
+        # @return [Hash<String,Google::Apis::SpannerV1::IndexedKeyRangeInfos>]
+        attr_accessor :indexed_key_range_infos
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # A message representing a matrix of floats.
+        # Corresponds to the JSON property `matrix`
+        # @return [Google::Apis::SpannerV1::MetricMatrix]
+        attr_accessor :matrix
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `unit`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :unit
+      
+        # Whether the metric is visible to the end user.
+        # Corresponds to the JSON property `visible`
+        # @return [Boolean]
+        attr_accessor :visible
+        alias_method :visible?, :visible
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregation = args[:aggregation] if args.key?(:aggregation)
+          @category = args[:category] if args.key?(:category)
+          @derived = args[:derived] if args.key?(:derived)
+          @display_label = args[:display_label] if args.key?(:display_label)
+          @has_nonzero_data = args[:has_nonzero_data] if args.key?(:has_nonzero_data)
+          @hot_value = args[:hot_value] if args.key?(:hot_value)
+          @indexed_hot_keys = args[:indexed_hot_keys] if args.key?(:indexed_hot_keys)
+          @indexed_key_range_infos = args[:indexed_key_range_infos] if args.key?(:indexed_key_range_infos)
+          @info = args[:info] if args.key?(:info)
+          @matrix = args[:matrix] if args.key?(:matrix)
+          @unit = args[:unit] if args.key?(:unit)
+          @visible = args[:visible] if args.key?(:visible)
+        end
+      end
+      
+      # A message representing a matrix of floats.
+      class MetricMatrix
+        include Google::Apis::Core::Hashable
+      
+        # The rows of the matrix.
+        # Corresponds to the JSON property `rows`
+        # @return [Array<Google::Apis::SpannerV1::MetricMatrixRow>]
+        attr_accessor :rows
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @rows = args[:rows] if args.key?(:rows)
+        end
+      end
+      
+      # A message representing a row of a matrix of floats.
+      class MetricMatrixRow
+        include Google::Apis::Core::Hashable
+      
+        # The columns of the row.
+        # Corresponds to the JSON property `cols`
+        # @return [Array<Float>]
+        attr_accessor :cols
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cols = args[:cols] if args.key?(:cols)
+        end
+      end
+      
       # A modification to one or more Cloud Spanner rows. Mutations can be applied to
       # a Cloud Spanner database by sending them in a Commit call.
       class Mutation
@@ -2489,21 +2964,71 @@ module Google
         end
       end
       
+      # A message representing a key prefix node in the key prefix hierarchy. for eg.
+      # Bigtable keyspaces are lexicographically ordered mappings of keys to values.
+      # Keys often have a shared prefix structure where users use the keys to organize
+      # data. Eg ///employee In this case Keysight will possibly use one node for a
+      # company and reuse it for all employees that fall under the company. Doing so
+      # improves legibility in the UI.
+      class PrefixNode
+        include Google::Apis::Core::Hashable
+      
+        # Whether this corresponds to a data_source name.
+        # Corresponds to the JSON property `dataSourceNode`
+        # @return [Boolean]
+        attr_accessor :data_source_node
+        alias_method :data_source_node?, :data_source_node
+      
+        # The depth in the prefix hierarchy.
+        # Corresponds to the JSON property `depth`
+        # @return [Fixnum]
+        attr_accessor :depth
+      
+        # The index of the end key bucket of the range that this node spans.
+        # Corresponds to the JSON property `endIndex`
+        # @return [Fixnum]
+        attr_accessor :end_index
+      
+        # The index of the start key bucket of the range that this node spans.
+        # Corresponds to the JSON property `startIndex`
+        # @return [Fixnum]
+        attr_accessor :start_index
+      
+        # The string represented by the prefix node.
+        # Corresponds to the JSON property `word`
+        # @return [String]
+        attr_accessor :word
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_source_node = args[:data_source_node] if args.key?(:data_source_node)
+          @depth = args[:depth] if args.key?(:depth)
+          @end_index = args[:end_index] if args.key?(:end_index)
+          @start_index = args[:start_index] if args.key?(:start_index)
+          @word = args[:word] if args.key?(:word)
+        end
+      end
+      
       # Query optimizer configuration.
       class QueryOptions
         include Google::Apis::Core::Hashable
       
-        # Query optimizer statistics package to use. This parameter allows individual
-        # queries to use a different query optimizer statistics. Specifying `latest` as
-        # a value instructs Cloud Spanner to use the latest generated statistics package.
-        # If not specified, Cloud Spanner uses statistics package set at the database
-        # level options, or latest if the database option is not set. The statistics
-        # package requested by the query has to be exempt from garbage collection. This
-        # can be achieved with the following DDL statement: ``` ALTER STATISTICS SET
-        # OPTIONS (allow_gc=false) ``` The list of available statistics packages can be
-        # queried from `SPANNER_SYS.OPTIMIZER_STATISTICS_PACKAGES`. Executing a SQL
-        # statement with an invalid optimizer statistics package or with statistics
-        # package that allows garbage collection fails with an `INVALID_ARGUMENT` error.
+        # An option to control the selection of optimizer statistics package. This
+        # parameter allows individual queries to use a different query optimizer
+        # statistics package. Specifying `latest` as a value instructs Cloud Spanner to
+        # use the latest generated statistics package. If not specified, Cloud Spanner
+        # uses the statistics package set at the database level options, or the latest
+        # package if the database option is not set. The statistics package requested by
+        # the query has to be exempt from garbage collection. This can be achieved with
+        # the following DDL statement: ``` ALTER STATISTICS SET OPTIONS (allow_gc=false)
+        # ``` The list of available statistics packages can be queried from `
+        # INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an
+        # invalid optimizer statistics package or with a statistics package that allows
+        # garbage collection fails with an `INVALID_ARGUMENT` error.
         # Corresponds to the JSON property `optimizerStatisticsPackage`
         # @return [String]
         attr_accessor :optimizer_statistics_package
@@ -2673,6 +3198,11 @@ module Google
         # @return [String]
         attr_accessor :partition_token
       
+        # Common request options for various APIs.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::SpannerV1::RequestOptions]
+        attr_accessor :request_options
+      
         # If this request is resuming a previously interrupted read, `resume_token`
         # should be copied from the last PartialResultSet yielded before the
         # interruption. Doing this enables the new read to resume where the last read
@@ -2705,6 +3235,7 @@ module Google
           @key_set = args[:key_set] if args.key?(:key_set)
           @limit = args[:limit] if args.key?(:limit)
           @partition_token = args[:partition_token] if args.key?(:partition_token)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @resume_token = args[:resume_token] if args.key?(:resume_token)
           @table = args[:table] if args.key?(:table)
           @transaction = args[:transaction] if args.key?(:transaction)
@@ -2759,6 +3290,50 @@ module Google
         end
       end
       
+      # Common request options for various APIs.
+      class RequestOptions
+        include Google::Apis::Core::Hashable
+      
+        # Priority for the request.
+        # Corresponds to the JSON property `priority`
+        # @return [String]
+        attr_accessor :priority
+      
+        # 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). Legal characters for `
+        # request_tag` values are all printable characters (ASCII 32 - 126) and the
+        # length of a request_tag is limited to 50 characters. Values that exceed this
+        # limit are truncated.
+        # Corresponds to the JSON property `requestTag`
+        # @return [String]
+        attr_accessor :request_tag
+      
+        # 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. Legal characters for `
+        # transaction_tag` values are all printable characters (ASCII 32 - 126) and the
+        # length of a transaction_tag is limited to 50 characters. Values that exceed
+        # this limit are truncated.
+        # Corresponds to the JSON property `transactionTag`
+        # @return [String]
+        attr_accessor :transaction_tag
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @priority = args[:priority] if args.key?(:priority)
+          @request_tag = args[:request_tag] if args.key?(:request_tag)
+          @transaction_tag = args[:transaction_tag] if args.key?(:transaction_tag)
+        end
+      end
+      
       # Encryption configuration for the restored database.
       class RestoreDatabaseEncryptionConfig
         include Google::Apis::Core::Hashable
@@ -3029,6 +3604,87 @@ module Google
         end
       end
       
+      # Scan is a structure which describes Cloud Key Visualizer scan information.
+      class Scan
+        include Google::Apis::Core::Hashable
+      
+        # Additional information provided by the implementer.
+        # Corresponds to the JSON property `details`
+        # @return [Hash<String,Object>]
+        attr_accessor :details
+      
+        # The upper bound for when the scan is defined.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The unique name of the scan, specific to the Database service implementing
+        # this interface.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # ScanData contains Cloud Key Visualizer scan data used by the caller to
+        # construct a visualization.
+        # Corresponds to the JSON property `scanData`
+        # @return [Google::Apis::SpannerV1::ScanData]
+        attr_accessor :scan_data
+      
+        # A range of time (inclusive) for when the scan is defined. The lower bound for
+        # when the scan is defined.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @details = args[:details] if args.key?(:details)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @name = args[:name] if args.key?(:name)
+          @scan_data = args[:scan_data] if args.key?(:scan_data)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # ScanData contains Cloud Key Visualizer scan data used by the caller to
+      # construct a visualization.
+      class ScanData
+        include Google::Apis::Core::Hashable
+      
+        # Cloud Key Visualizer scan data. The range of time this information covers is
+        # captured via the above time range fields. Note, this field is not available to
+        # the ListScans method.
+        # Corresponds to the JSON property `data`
+        # @return [Google::Apis::SpannerV1::VisualizationData]
+        attr_accessor :data
+      
+        # The upper bound for when the contained data is defined.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # A range of time (inclusive) for when the contained data is defined. The lower
+        # bound for when the contained data is defined.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
       # A session in the Cloud Spanner API.
       class Session
         include Google::Apis::Core::Hashable
@@ -3907,6 +4563,16 @@ module Google
         # @return [String]
         attr_accessor :database
       
+        # The progress of the UpdateDatabaseDdl operations. Currently, only index
+        # creation statements will have a continuously updating progress. For non-index
+        # creation statements, `progress[i]` will have start time and end time populated
+        # with commit timestamp of operation, as well as a progress of 100% once the
+        # operation has completed. `progress[i]` is the operation progress for `
+        # statements[i]`.
+        # Corresponds to the JSON property `progress`
+        # @return [Array<Google::Apis::SpannerV1::OperationProgress>]
+        attr_accessor :progress
+      
         # For an update this list contains all the statements. For an individual
         # statement, this list contains only that statement.
         # Corresponds to the JSON property `statements`
@@ -3929,6 +4595,7 @@ module Google
         def update!(**args)
           @commit_timestamps = args[:commit_timestamps] if args.key?(:commit_timestamps)
           @database = args[:database] if args.key?(:database)
+          @progress = args[:progress] if args.key?(:progress)
           @statements = args[:statements] if args.key?(:statements)
           @throttled = args[:throttled] if args.key?(:throttled)
         end
@@ -4044,6 +4711,84 @@ module Google
         end
       end
       
+      # 
+      class VisualizationData
+        include Google::Apis::Core::Hashable
+      
+        # The token signifying the end of a data_source.
+        # Corresponds to the JSON property `dataSourceEndToken`
+        # @return [String]
+        attr_accessor :data_source_end_token
+      
+        # The token delimiting a datasource name from the rest of a key in a data_source.
+        # Corresponds to the JSON property `dataSourceSeparatorToken`
+        # @return [String]
+        attr_accessor :data_source_separator_token
+      
+        # The list of messages (info, alerts, ...)
+        # Corresponds to the JSON property `diagnosticMessages`
+        # @return [Array<Google::Apis::SpannerV1::DiagnosticMessage>]
+        attr_accessor :diagnostic_messages
+      
+        # We discretize the entire keyspace into buckets. Assuming each bucket has an
+        # inclusive keyrange and covers keys from k(i) ... k(n). In this case k(n) would
+        # be an end key for a given range. end_key_string is the collection of all such
+        # end keys
+        # Corresponds to the JSON property `endKeyStrings`
+        # @return [Array<String>]
+        attr_accessor :end_key_strings
+      
+        # Whether this scan contains PII.
+        # Corresponds to the JSON property `hasPii`
+        # @return [Boolean]
+        attr_accessor :has_pii
+        alias_method :has_pii?, :has_pii
+      
+        # Keys of key ranges that contribute significantly to a given metric Can be
+        # thought of as heavy hitters.
+        # Corresponds to the JSON property `indexedKeys`
+        # @return [Array<String>]
+        attr_accessor :indexed_keys
+      
+        # The token delimiting the key prefixes.
+        # Corresponds to the JSON property `keySeparator`
+        # @return [String]
+        attr_accessor :key_separator
+      
+        # The unit for the key: e.g. 'key' or 'chunk'.
+        # Corresponds to the JSON property `keyUnit`
+        # @return [String]
+        attr_accessor :key_unit
+      
+        # The list of data objects for each metric.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::SpannerV1::Metric>]
+        attr_accessor :metrics
+      
+        # The list of extracted key prefix nodes used in the key prefix hierarchy.
+        # Corresponds to the JSON property `prefixNodes`
+        # @return [Array<Google::Apis::SpannerV1::PrefixNode>]
+        attr_accessor :prefix_nodes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_source_end_token = args[:data_source_end_token] if args.key?(:data_source_end_token)
+          @data_source_separator_token = args[:data_source_separator_token] if args.key?(:data_source_separator_token)
+          @diagnostic_messages = args[:diagnostic_messages] if args.key?(:diagnostic_messages)
+          @end_key_strings = args[:end_key_strings] if args.key?(:end_key_strings)
+          @has_pii = args[:has_pii] if args.key?(:has_pii)
+          @indexed_keys = args[:indexed_keys] if args.key?(:indexed_keys)
+          @key_separator = args[:key_separator] if args.key?(:key_separator)
+          @key_unit = args[:key_unit] if args.key?(:key_unit)
+          @metrics = args[:metrics] if args.key?(:metrics)
+          @prefix_nodes = args[:prefix_nodes] if args.key?(:prefix_nodes)
+        end
+      end
+      
       # Arguments to insert, update, insert_or_update, and replace operations.
       class Write
         include Google::Apis::Core::Hashable