google-apis-spanner_v1 0.43.0 → 0.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ff3c467cf3caa328b6c200a443e0fa97c76cf2980db9feedacb805456d0a2a9
-  data.tar.gz: 3ee51aa254b443e266973b0a7cfcc274ece131c985f3d94e464271ee694cfbf5
+  metadata.gz: 4e2b58ef928288fd71c819ed53b9067d1c538c97fbaf01523e48861bcb35024e
+  data.tar.gz: f4044cd1f853073767879aa5077872339d679792410d1ba9dd4526471a4d9acb
 SHA512:
-  metadata.gz: 4ba927505875f4f6488e4d11c353dc1837de8cf4824a6d43d85ccc96fd446e81b50561ca6ab353cbb85a74dd96220ca27c9fbcd3f2439a59cfef80e9972fd390
-  data.tar.gz: f0f369669d52f7856da3cdcbf00c5223a8ca2fa8461125cbfa4e0101f72241dfd4e72ec2f6d0d508dcc7e954f3249a8c7e5a38cfda13aa3688c0a7c0f33f8661
+  metadata.gz: 135b702bbc2e72e271723cf08bca7f311e413791dcc2fe9c8eb980e762d6421ba82ae26e84f891e0b5368626b4ccf7c1755a076702473eb9380d0d21431d57b1
+  data.tar.gz: 95c2c508c32ffa88286a3b32aa703c8c8513d83594b3cecaccecbdc139577b3957dad50246f406ba5632d33168df415a8645efdcbba7ecd7cad585d25066f4c6

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-spanner_v1
 
+### v0.45.0 (2025-10-05)
+
+* Regenerated from discovery document revision 20250920
+
+### v0.44.0 (2025-07-20)
+
+* Regenerated from discovery document revision 20250708
+
 ### v0.43.0 (2025-07-06)
 
 * Regenerated from discovery document revision 20250625

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

@@ -58,6 +58,14 @@ module Google
       class AdaptMessageResponse
         include Google::Apis::Core::Hashable
       
+        # Optional. Indicates whether this is the last AdaptMessageResponse in the
+        # stream. This field may be optionally set by the server. Clients should not
+        # rely on this field being set in all cases.
+        # Corresponds to the JSON property `last`
+        # @return [Boolean]
+        attr_accessor :last
+        alias_method :last?, :last
+      
         # Optional. Uninterpreted bytes from the underlying wire protocol.
         # Corresponds to the JSON property `payload`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -75,6 +83,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @last = args[:last] if args.key?(:last)
           @payload = args[:payload] if args.key?(:payload)
           @state_updates = args[:state_updates] if args.key?(:state_updates)
         end
@@ -408,9 +417,9 @@ module Google
         # @return [String]
         attr_accessor :incremental_backup_chain_id
       
-        # Output only. The instance partition(s) storing the backup. This is the same as
-        # the list of the instance partition(s) that the database had footprint in at
-        # the backup's `version_time`.
+        # Output only. The instance partition storing the backup. This is the same as
+        # the list of the instance partitions that the database recorded at the backup's
+        # `version_time`.
         # Corresponds to the JSON property `instancePartitions`
         # @return [Array<Google::Apis::SpannerV1::BackupInstancePartition>]
         attr_accessor :instance_partitions
@@ -712,16 +721,9 @@ module Google
       class BatchWriteRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. When `exclude_txn_from_change_streams` is set to `true`: *
-        # Modifications from all transactions in this batch write operation are not be
-        # recorded in change streams with DDL option `allow_txn_exclusion=true` that are
-        # tracking columns modified by these transactions. * Modifications from all
-        # transactions in this batch write operation are recorded in change streams with
-        # DDL option `allow_txn_exclusion=false or not set` that are tracking columns
-        # modified by these transactions. When `exclude_txn_from_change_streams` is set
-        # to `false` or not set, Modifications from all transactions in this batch write
-        # operation are recorded in all change streams that are tracking columns
-        # modified by these transactions.
+        # Optional. If you don't set the `exclude_txn_from_change_streams` option or if
+        # it's set to `false`, then any change streams monitoring columns modified by
+        # transactions will capture the updates made within that transaction.
         # Corresponds to the JSON property `excludeTxnFromChangeStreams`
         # @return [Boolean]
         attr_accessor :exclude_txn_from_change_streams
@@ -1227,6 +1229,13 @@ module Google
         # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
         attr_accessor :precommit_token
       
+        # If `TransactionOptions.isolation_level` is set to `IsolationLevel.
+        # REPEATABLE_READ`, then the snapshot timestamp is the timestamp at which all
+        # reads in the transaction ran. This timestamp is never returned.
+        # Corresponds to the JSON property `snapshotTimestamp`
+        # @return [String]
+        attr_accessor :snapshot_timestamp
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1236,6 +1245,7 @@ module Google
           @commit_stats = args[:commit_stats] if args.key?(:commit_stats)
           @commit_timestamp = args[:commit_timestamp] if args.key?(:commit_timestamp)
           @precommit_token = args[:precommit_token] if args.key?(:precommit_token)
+          @snapshot_timestamp = args[:snapshot_timestamp] if args.key?(:snapshot_timestamp)
         end
       end
       
@@ -1313,9 +1323,15 @@ module Google
         # @return [String]
         attr_accessor :encryption_type
       
-        # Optional. The Cloud KMS key that will be used to protect the backup. This
-        # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
-        # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        # Optional. This field is maintained for backwards compatibility. For new
+        # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
+        # kms_key_name` if the location of the KMS key matches the database instance's
+        # configuration (location) exactly. For example, if the KMS location is in `us-
+        # central1` or `nam3`, then the database instance must also be in `us-central1`
+        # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
+        # database. Set this field only when encryption_type is `
+        # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
+        # keyRings//cryptoKeys/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -1449,9 +1465,15 @@ module Google
         # @return [String]
         attr_accessor :encryption_type
       
-        # Optional. The Cloud KMS key that will be used to protect the backup. This
-        # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
-        # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        # Optional. This field is maintained for backwards compatibility. For new
+        # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
+        # kms_key_name` if the location of the KMS key matches the database instance's
+        # configuration (location) exactly. For example, if the KMS location is in `us-
+        # central1` or `nam3`, then the database instance must also be in `us-central1`
+        # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
+        # database. Set this field only when encryption_type is `
+        # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
+        # keyRings//cryptoKeys/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -2122,8 +2144,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The unique identifier of the database resource in the Instance. For
-        # example if the database uri is projects/foo/instances/bar/databases/baz, the
-        # id to supply here is baz.
+        # example, if the database uri is `projects/foo/instances/bar/databases/baz`,
+        # then the id to supply here is baz.
         # Corresponds to the JSON property `databaseId`
         # @return [String]
         attr_accessor :database_id
@@ -2171,23 +2193,23 @@ module Google
       class DdlStatementActionInfo
         include Google::Apis::Core::Hashable
       
-        # The action for the DDL statement, e.g. CREATE, ALTER, DROP, GRANT, etc. This
-        # field is a non-empty string.
+        # The action for the DDL statement, for example, CREATE, ALTER, DROP, GRANT, etc.
+        # This field is a non-empty string.
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
       
-        # The entity name(s) being operated on the DDL statement. E.g. 1. For statement "
-        # CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "GRANT ROLE
-        # r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "ANALYZE", `
-        # entity_names` = [].
+        # The entity names being operated on the DDL statement. For example, 1. For
+        # statement "CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "
+        # GRANT ROLE r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "
+        # ANALYZE", `entity_names` = [].
         # Corresponds to the JSON property `entityNames`
         # @return [Array<String>]
         attr_accessor :entity_names
       
-        # The entity type for the DDL statement, e.g. TABLE, INDEX, VIEW, etc. This
-        # field can be empty string for some DDL statement, e.g. for statement "ANALYZE",
-        # `entity_type` = "".
+        # The entity type for the DDL statement, for example, TABLE, INDEX, VIEW, etc.
+        # This field can be empty string for some DDL statement, for example, for
+        # statement "ANALYZE", `entity_type` = "".
         # Corresponds to the JSON property `entityType`
         # @return [String]
         attr_accessor :entity_type
@@ -3373,12 +3395,12 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. This field is maintained for backwards compatibility. For new
-        # callers, we recommend using `kms_key_names` to specify the KMS key. `
-        # kms_key_name` should only be used if the location of the KMS key matches the
-        # database instance’s configuration (location) exactly. E.g. The KMS location is
-        # in us-central1 or nam3 and the database instance is also in us-central1 or
-        # nam3. The Cloud KMS key to be used for encrypting and decrypting the database.
-        # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
+        # kms_key_name` if the location of the KMS key matches the database instance's
+        # configuration (location) exactly. For example, if the KMS location is in `us-
+        # central1` or `nam3`, then the database instance must also be in `us-central1`
+        # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
+        # database. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -3552,7 +3574,7 @@ module Google
       class InstanceReplicaSelection
         include Google::Apis::Core::Hashable
       
-        # Required. Name of the location of the replicas (e.g., "us-central1").
+        # Required. Name of the location of the replicas (for example, "us-central1").
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -5963,8 +5985,13 @@ module Google
         # @return [String]
         attr_accessor :encryption_type
       
-        # Optional. The Cloud KMS key that will be used to encrypt/decrypt the restored
-        # database. This field should be set only when encryption_type is `
+        # Optional. This field is maintained for backwards compatibility. For new
+        # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
+        # kms_key_name` if the location of the KMS key matches the database instance's
+        # configuration (location) exactly. For example, if the KMS location is in `us-
+        # central1` or `nam3`, then the database instance must also be in `us-central1`
+        # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
+        # database. Set this field only when encryption_type is `
         # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
         # keyRings//cryptoKeys/`.
         # Corresponds to the JSON property `kmsKeyName`
@@ -6474,11 +6501,11 @@ module Google
       class SingleRegionQuorum
         include Google::Apis::Core::Hashable
       
-        # Required. The location of the serving region, e.g. "us-central1". The location
-        # must be one of the regions within the dual-region instance configuration of
-        # your database. The list of valid locations is available using the
-        # GetInstanceConfig API. This should only be used if you plan to change quorum
-        # to the single-region quorum type.
+        # Required. The location of the serving region, for example, "us-central1". The
+        # location must be one of the regions within the dual-region instance
+        # configuration of your database. The list of valid locations is available using
+        # the GetInstanceConfig API. This should only be used if you plan to change
+        # quorum to the single-region quorum type.
         # Corresponds to the JSON property `servingLocation`
         # @return [String]
         attr_accessor :serving_location
@@ -6891,9 +6918,9 @@ module Google
         # @return [Array<String>]
         attr_accessor :statements
       
-        # Output only. When true, indicates that the operation is throttled e.g. due to
-        # resource constraints. When resources become available the operation will
-        # resume and this field will be false again.
+        # Output only. When true, indicates that the operation is throttled, for example,
+        # due to resource constraints. When resources become available the operation
+        # will resume and this field will be false again.
         # Corresponds to the JSON property `throttled`
         # @return [Boolean]
         attr_accessor :throttled
@@ -6918,13 +6945,13 @@ module Google
       # all at once, to the database schema at some point (or points) in the future.
       # The server checks that the statements are executable (syntactically valid,
       # name tables that exist, etc.) before enqueueing them, but they may still fail
-      # upon later execution (e.g., if a statement from another batch of statements is
-      # applied first and it conflicts in some way, or if there is some data-related
-      # problem like a `NULL` value in a column to which `NOT NULL` would be added).
-      # If a statement fails, all subsequent statements in the batch are automatically
-      # cancelled. Each batch of statements is assigned a name which can be used with
-      # the Operations API to monitor progress. See the operation_id field for more
-      # details.
+      # upon later execution (for example, if a statement from another batch of
+      # statements is applied first and it conflicts in some way, or if there is some
+      # data-related problem like a `NULL` value in a column to which `NOT NULL` would
+      # be added). If a statement fails, all subsequent statements in the batch are
+      # automatically cancelled. Each batch of statements is assigned a name which can
+      # be used with the Operations API to monitor progress. See the operation_id
+      # field for more details.
       class UpdateDatabaseDdlRequest
         include Google::Apis::Core::Hashable
       

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SpannerV1
       # Version of the google-apis-spanner_v1 gem
-      GEM_VERSION = "0.43.0"
+      GEM_VERSION = "0.45.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250625"
+      REVISION = "20250920"
     end
   end
 end

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

@@ -1090,6 +1090,7 @@ module Google
       class AdaptMessageResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :last, as: 'last'
           property :payload, :base64 => true, as: 'payload'
           hash :state_updates, as: 'stateUpdates'
         end
@@ -1377,6 +1378,7 @@ module Google
           property :commit_timestamp, as: 'commitTimestamp'
           property :precommit_token, as: 'precommitToken', class: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken, decorator: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken::Representation
       
+          property :snapshot_timestamp, as: 'snapshotTimestamp'
         end
       end
       

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

@@ -1169,11 +1169,10 @@ module Google
         # delete the backup. There can be only one pending backup creation per database.
         # Backup creation of different databases can run concurrently.
         # @param [String] parent
-        #   Required. The name of the instance in which the backup will be created. This
-        #   must be the same instance that contains the database the backup will be
-        #   created from. The backup will be stored in the location(s) specified in the
-        #   instance configuration of this instance. Values are of the form `projects//
-        #   instances/`.
+        #   Required. The name of the instance in which the backup is created. This must
+        #   be the same instance that contains the database the backup is created from.
+        #   The backup will be stored in the locations specified in the instance
+        #   configuration of this instance. Values are of the form `projects//instances/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @param [String] backup_id
         #   Required. The id of the backup to be created. The `backup_id` appended to `
@@ -1181,9 +1180,15 @@ module Google
         # @param [String] encryption_config_encryption_type
         #   Required. The encryption type of the backup.
         # @param [String] encryption_config_kms_key_name
-        #   Optional. The Cloud KMS key that will be used to protect the backup. This
-        #   field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
-        #   Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        #   Optional. This field is maintained for backwards compatibility. For new
+        #   callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
+        #   kms_key_name` if the location of the KMS key matches the database instance's
+        #   configuration (location) exactly. For example, if the KMS location is in `us-
+        #   central1` or `nam3`, then the database instance must also be in `us-central1`
+        #   or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
+        #   database. Set this field only when encryption_type is `
+        #   CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
+        #   keyRings//cryptoKeys/`.
         # @param [Array<String>, String] encryption_config_kms_key_names
         #   Optional. Specifies the KMS configuration for the one or more keys used to
         #   protect the backup. Values are of the form `projects//locations//keyRings//
@@ -1406,11 +1411,11 @@ module Google
         #   the form `projects//instances/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @param [String] update_mask
-        #   Required. A mask specifying which fields (e.g. `expire_time`) in the Backup
-        #   resource should be updated. This mask is relative to the Backup resource, not
-        #   to the request message. The field mask must always be specified; this prevents
-        #   any future fields from being erased accidentally by clients that do not know
-        #   about them.
+        #   Required. A mask specifying which fields (for example, `expire_time`) in the
+        #   backup resource should be updated. This mask is relative to the backup
+        #   resource, not to the request message. The field mask must always be specified;
+        #   this prevents any future fields from being erased accidentally by clients that
+        #   do not know about them.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2252,7 +2257,7 @@ module Google
         # Updates the schema of a Cloud Spanner database by creating/altering/dropping
         # tables, columns, indexes, etc. The returned long-running operation will have a
         # name of the format `/operations/` and can be used to track execution of the
-        # schema change(s). The metadata field type is UpdateDatabaseDdlMetadata. The
+        # schema changes. The metadata field type is UpdateDatabaseDdlMetadata. The
         # operation has no response.
         # @param [String] database
         #   Required. The database to update.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.43.0
+  version: 0.45.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.43.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.45.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
 rdoc_options: []
 require_paths: