google-apis-spanner_v1 0.39.0 → 0.40.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 80aab876566e716fc6f342f93eed7c62dd1ee0bd5552d96ba479de28adde6cb2
4
- data.tar.gz: 22a06a2a63ca137eb6926e1b299c9709ceed4be566826ea6fdcb9e1921c9c576
3
+ metadata.gz: 1a50443bc6a46b5a52d114224ab619dd8b5fe0e97fbf198eade1808a8fd0f8fc
4
+ data.tar.gz: bc0d41f46eca6c234dc65a81e6a0c351c8ae6d9ca5664f86b8e97bb20084bc6b
5
5
  SHA512:
6
- metadata.gz: 8e66fb6ecfa79250487e211943073aa452ae0718fa276ed995bfc2f03c119f6cc5745380a1864840f1af9c5543d1bdb33965ef0f011b8e198515c7bb60747d26
7
- data.tar.gz: '09335b0beac3787e24364869a26288b594adef0bd1358b3569bcad38ef9143c3e04519d486e642582af3eade5e50461e1e3992a48bd5f66d8dcac81b3a87271b'
6
+ metadata.gz: 77ffd2d1ab620128564dd2d65ed20a72cab9d92d3ba82437b5488f251efad7ecce7c2b81ba2effd5291000572e406f2d7fe7bc3f6570930a554847b701979550
7
+ data.tar.gz: 847be06db5cc5516c1d976913f74d59f18c5753091dbf93c8d55fbe7db0018eb96da91e2593516892803157a3de0e5dfd9cac91cdd1cea0c42158bad2e76a610
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-spanner_v1
2
2
 
3
+ ### v0.40.0 (2025-03-16)
4
+
5
+ * Regenerated from discovery document revision 20250304
6
+
3
7
  ### v0.39.0 (2025-02-26)
4
8
 
5
9
  * Regenerated from discovery document revision 20250220
@@ -665,10 +665,10 @@ module Google
665
665
  class BatchCreateSessionsRequest
666
666
  include Google::Apis::Core::Hashable
667
667
 
668
- # Required. The number of sessions to be created in this batch call. The API may
668
+ # Required. The number of sessions to be created in this batch call. The API can
669
669
  # return fewer than the requested number of sessions. If a specific number of
670
- # sessions are desired, the client can make additional calls to
671
- # BatchCreateSessions (adjusting session_count as necessary).
670
+ # sessions are desired, the client can make additional calls to `
671
+ # BatchCreateSessions` (adjusting session_count as necessary).
672
672
  # Corresponds to the JSON property `sessionCount`
673
673
  # @return [Fixnum]
674
674
  attr_accessor :session_count
@@ -713,15 +713,15 @@ module Google
713
713
  include Google::Apis::Core::Hashable
714
714
 
715
715
  # Optional. When `exclude_txn_from_change_streams` is set to `true`: *
716
- # Modifications from all transactions in this batch write operation will not be
716
+ # Modifications from all transactions in this batch write operation are not be
717
717
  # recorded in change streams with DDL option `allow_txn_exclusion=true` that are
718
718
  # tracking columns modified by these transactions. * Modifications from all
719
- # transactions in this batch write operation will be recorded in change streams
720
- # with DDL option `allow_txn_exclusion=false or not set` that are tracking
721
- # columns modified by these transactions. When `exclude_txn_from_change_streams`
722
- # is set to `false` or not set, Modifications from all transactions in this
723
- # batch write operation will be recorded in all change streams that are tracking
724
- # columns modified by these transactions.
719
+ # transactions in this batch write operation are recorded in change streams with
720
+ # DDL option `allow_txn_exclusion=false or not set` that are tracking columns
721
+ # modified by these transactions. When `exclude_txn_from_change_streams` is set
722
+ # to `false` or not set, Modifications from all transactions in this batch write
723
+ # operation are recorded in all change streams that are tracking columns
724
+ # modified by these transactions.
725
725
  # Corresponds to the JSON property `excludeTxnFromChangeStreams`
726
726
  # @return [Boolean]
727
727
  attr_accessor :exclude_txn_from_change_streams
@@ -1223,7 +1223,7 @@ module Google
1223
1223
  include Google::Apis::Core::Hashable
1224
1224
 
1225
1225
  # Optional. The amount of latency this request is configured to incur in order
1226
- # to improve throughput. If this field is not set, Spanner assumes requests are
1226
+ # to improve throughput. If this field isn't set, Spanner assumes requests are
1227
1227
  # relatively latency sensitive and automatically determines an appropriate delay
1228
1228
  # time. You can specify a commit delay value between 0 and 500 ms.
1229
1229
  # Corresponds to the JSON property `maxCommitDelay`
@@ -1237,9 +1237,9 @@ module Google
1237
1237
  attr_accessor :mutations
1238
1238
 
1239
1239
  # When a read-write transaction is executed on a multiplexed session, this
1240
- # precommit token is sent back to the client as a part of the [Transaction]
1241
- # message in the BeginTransaction response and also as a part of the [ResultSet]
1242
- # and [PartialResultSet] responses.
1240
+ # precommit token is sent back to the client as a part of the Transaction
1241
+ # message in the BeginTransaction response and also as a part of the ResultSet
1242
+ # and PartialResultSet responses.
1243
1243
  # Corresponds to the JSON property `precommitToken`
1244
1244
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
1245
1245
  attr_accessor :precommit_token
@@ -1249,7 +1249,7 @@ module Google
1249
1249
  # @return [Google::Apis::SpannerV1::RequestOptions]
1250
1250
  attr_accessor :request_options
1251
1251
 
1252
- # If `true`, then statistics related to the transaction will be included in the
1252
+ # If `true`, then statistics related to the transaction is included in the
1253
1253
  # CommitResponse. Default value is `false`.
1254
1254
  # Corresponds to the JSON property `returnCommitStats`
1255
1255
  # @return [Boolean]
@@ -1489,9 +1489,9 @@ module Google
1489
1489
  attr_accessor :commit_timestamp
1490
1490
 
1491
1491
  # When a read-write transaction is executed on a multiplexed session, this
1492
- # precommit token is sent back to the client as a part of the [Transaction]
1493
- # message in the BeginTransaction response and also as a part of the [ResultSet]
1494
- # and [PartialResultSet] responses.
1492
+ # precommit token is sent back to the client as a part of the Transaction
1493
+ # message in the BeginTransaction response and also as a part of the ResultSet
1494
+ # and PartialResultSet responses.
1495
1495
  # Corresponds to the JSON property `precommitToken`
1496
1496
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
1497
1497
  attr_accessor :precommit_token
@@ -2435,9 +2435,9 @@ module Google
2435
2435
  end
2436
2436
  end
2437
2437
 
2438
- # The DirectedReadOptions can be used to indicate which replicas or regions
2439
- # should be used for non-transactional reads or queries. DirectedReadOptions may
2440
- # only be specified for a read-only transaction, otherwise the API will return
2438
+ # The `DirectedReadOptions` can be used to indicate which replicas or regions
2439
+ # should be used for non-transactional reads or queries. `DirectedReadOptions`
2440
+ # can only be specified for a read-only transaction, otherwise the API returns
2441
2441
  # an `INVALID_ARGUMENT` error.
2442
2442
  class DirectedReadOptions
2443
2443
  include Google::Apis::Core::Hashable
@@ -2448,8 +2448,8 @@ module Google
2448
2448
  # @return [Google::Apis::SpannerV1::ExcludeReplicas]
2449
2449
  attr_accessor :exclude_replicas
2450
2450
 
2451
- # An IncludeReplicas contains a repeated set of ReplicaSelection which indicates
2452
- # the order in which replicas should be considered.
2451
+ # An `IncludeReplicas` contains a repeated set of `ReplicaSelection` which
2452
+ # indicates the order in which replicas should be considered.
2453
2453
  # Corresponds to the JSON property `includeReplicas`
2454
2454
  # @return [Google::Apis::SpannerV1::IncludeReplicas]
2455
2455
  attr_accessor :include_replicas
@@ -2591,13 +2591,13 @@ module Google
2591
2591
  class ExecuteBatchDmlRequest
2592
2592
  include Google::Apis::Core::Hashable
2593
2593
 
2594
- # Optional. If set to true, this request marks the end of the transaction. The
2595
- # transaction should be committed or aborted after these statements execute, and
2596
- # attempts to execute any other requests against this transaction (including
2597
- # reads and queries) will be rejected. Setting this option may cause some error
2598
- # reporting to be deferred until commit time (e.g. validation of unique
2599
- # constraints). Given this, successful execution of statements should not be
2600
- # assumed until a subsequent Commit call completes successfully.
2594
+ # Optional. If set to `true`, this request marks the end of the transaction.
2595
+ # After these statements execute, you must commit or abort the transaction.
2596
+ # Attempts to execute any other requests against this transaction (including
2597
+ # reads and queries) are rejected. Setting this option might cause some error
2598
+ # reporting to be deferred until commit time (for example, validation of unique
2599
+ # constraints). Given this, successful execution of statements shouldn't be
2600
+ # assumed until a subsequent `Commit` call completes successfully.
2601
2601
  # Corresponds to the JSON property `lastStatements`
2602
2602
  # @return [Boolean]
2603
2603
  attr_accessor :last_statements
@@ -2610,11 +2610,11 @@ module Google
2610
2610
 
2611
2611
  # Required. A per-transaction sequence number used to identify this request.
2612
2612
  # This field makes each request idempotent such that if the request is received
2613
- # multiple times, at most one will succeed. The sequence number must be
2613
+ # multiple times, at most one succeeds. The sequence number must be
2614
2614
  # monotonically increasing within the transaction. If a request arrives for the
2615
- # first time with an out-of-order sequence number, the transaction may be
2616
- # aborted. Replays of previously handled requests will yield the same response
2617
- # as the first execution.
2615
+ # first time with an out-of-order sequence number, the transaction might be
2616
+ # aborted. Replays of previously handled requests yield the same response as the
2617
+ # first execution.
2618
2618
  # Corresponds to the JSON property `seqno`
2619
2619
  # @return [Fixnum]
2620
2620
  attr_accessor :seqno
@@ -2666,9 +2666,9 @@ module Google
2666
2666
  include Google::Apis::Core::Hashable
2667
2667
 
2668
2668
  # When a read-write transaction is executed on a multiplexed session, this
2669
- # precommit token is sent back to the client as a part of the [Transaction]
2670
- # message in the BeginTransaction response and also as a part of the [ResultSet]
2671
- # and [PartialResultSet] responses.
2669
+ # precommit token is sent back to the client as a part of the Transaction
2670
+ # message in the BeginTransaction response and also as a part of the ResultSet
2671
+ # and PartialResultSet responses.
2672
2672
  # Corresponds to the JSON property `precommitToken`
2673
2673
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
2674
2674
  attr_accessor :precommit_token
@@ -2710,39 +2710,40 @@ module Google
2710
2710
 
2711
2711
  # If this is for a partitioned query and this field is set to `true`, the
2712
2712
  # request is executed with Spanner Data Boost independent compute resources. If
2713
- # the field is set to `true` but the request does not set `partition_token`, the
2713
+ # the field is set to `true` but the request doesn't set `partition_token`, the
2714
2714
  # API returns an `INVALID_ARGUMENT` error.
2715
2715
  # Corresponds to the JSON property `dataBoostEnabled`
2716
2716
  # @return [Boolean]
2717
2717
  attr_accessor :data_boost_enabled
2718
2718
  alias_method :data_boost_enabled?, :data_boost_enabled
2719
2719
 
2720
- # The DirectedReadOptions can be used to indicate which replicas or regions
2721
- # should be used for non-transactional reads or queries. DirectedReadOptions may
2722
- # only be specified for a read-only transaction, otherwise the API will return
2720
+ # The `DirectedReadOptions` can be used to indicate which replicas or regions
2721
+ # should be used for non-transactional reads or queries. `DirectedReadOptions`
2722
+ # can only be specified for a read-only transaction, otherwise the API returns
2723
2723
  # an `INVALID_ARGUMENT` error.
2724
2724
  # Corresponds to the JSON property `directedReadOptions`
2725
2725
  # @return [Google::Apis::SpannerV1::DirectedReadOptions]
2726
2726
  attr_accessor :directed_read_options
2727
2727
 
2728
- # Optional. If set to true, this statement marks the end of the transaction. The
2729
- # transaction should be committed or aborted after this statement executes, and
2730
- # attempts to execute any other requests against this transaction (including
2731
- # reads and queries) will be rejected. For DML statements, setting this option
2732
- # may cause some error reporting to be deferred until commit time (e.g.
2728
+ # Optional. If set to `true`, this statement marks the end of the transaction.
2729
+ # After this statement executes, you must commit or abort the transaction.
2730
+ # Attempts to execute any other requests against this transaction (including
2731
+ # reads and queries) are rejected. For DML statements, setting this option might
2732
+ # cause some error reporting to be deferred until commit time (for example,
2733
2733
  # validation of unique constraints). Given this, successful execution of a DML
2734
- # statement should not be assumed until a subsequent Commit call completes
2734
+ # statement shouldn't be assumed until a subsequent `Commit` call completes
2735
2735
  # successfully.
2736
2736
  # Corresponds to the JSON property `lastStatement`
2737
2737
  # @return [Boolean]
2738
2738
  attr_accessor :last_statement
2739
2739
  alias_method :last_statement?, :last_statement
2740
2740
 
2741
- # It is not always possible for Cloud Spanner to infer the right SQL type from a
2741
+ # It isn't always possible for Cloud Spanner to infer the right SQL type from a
2742
2742
  # JSON value. For example, values of type `BYTES` and values of type `STRING`
2743
- # both appear in params as JSON strings. In these cases, `param_types` can be
2744
- # used to specify the exact SQL type for some or all of the SQL statement
2745
- # parameters. See the definition of Type for more information about SQL types.
2743
+ # both appear in params as JSON strings. In these cases, you can use `
2744
+ # param_types` to specify the exact SQL type for some or all of the SQL
2745
+ # statement parameters. See the definition of Type for more information about
2746
+ # SQL types.
2746
2747
  # Corresponds to the JSON property `paramTypes`
2747
2748
  # @return [Hash<String,Google::Apis::SpannerV1::Type>]
2748
2749
  attr_accessor :param_types
@@ -2753,16 +2754,16 @@ module Google
2753
2754
  # requirements of identifiers as specified at https://cloud.google.com/spanner/
2754
2755
  # docs/lexical#identifiers. Parameters can appear anywhere that a literal value
2755
2756
  # is expected. The same parameter name can be used more than once, for example: `
2756
- # "WHERE id > @msg_id AND id < @msg_id + 100"` It is an error to execute a SQL
2757
+ # "WHERE id > @msg_id AND id < @msg_id + 100"` It's an error to execute a SQL
2757
2758
  # statement with unbound parameters.
2758
2759
  # Corresponds to the JSON property `params`
2759
2760
  # @return [Hash<String,Object>]
2760
2761
  attr_accessor :params
2761
2762
 
2762
- # If present, results will be restricted to the specified partition previously
2763
- # created using PartitionQuery(). There must be an exact match for the values of
2764
- # fields common to this message and the PartitionQueryRequest message used to
2765
- # create this partition_token.
2763
+ # If present, results are restricted to the specified partition previously
2764
+ # created using `PartitionQuery`. There must be an exact match for the values of
2765
+ # fields common to this message and the `PartitionQueryRequest` message used to
2766
+ # create this `partition_token`.
2766
2767
  # Corresponds to the JSON property `partitionToken`
2767
2768
  # NOTE: Values are automatically base64 encoded/decoded in the client library.
2768
2769
  # @return [String]
@@ -2796,11 +2797,11 @@ module Google
2796
2797
 
2797
2798
  # A per-transaction sequence number used to identify this request. This field
2798
2799
  # makes each request idempotent such that if the request is received multiple
2799
- # times, at most one will succeed. The sequence number must be monotonically
2800
+ # times, at most one succeeds. The sequence number must be monotonically
2800
2801
  # increasing within the transaction. If a request arrives for the first time
2801
- # with an out-of-order sequence number, the transaction may be aborted. Replays
2802
- # of previously handled requests will yield the same response as the first
2803
- # execution. Required for DML statements. Ignored for queries.
2802
+ # with an out-of-order sequence number, the transaction can be aborted. Replays
2803
+ # of previously handled requests yield the same response as the first execution.
2804
+ # Required for DML statements. Ignored for queries.
2804
2805
  # Corresponds to the JSON property `seqno`
2805
2806
  # @return [Fixnum]
2806
2807
  attr_accessor :seqno
@@ -3052,13 +3053,13 @@ module Google
3052
3053
  end
3053
3054
  end
3054
3055
 
3055
- # An IncludeReplicas contains a repeated set of ReplicaSelection which indicates
3056
- # the order in which replicas should be considered.
3056
+ # An `IncludeReplicas` contains a repeated set of `ReplicaSelection` which
3057
+ # indicates the order in which replicas should be considered.
3057
3058
  class IncludeReplicas
3058
3059
  include Google::Apis::Core::Hashable
3059
3060
 
3060
- # If true, Spanner will not route requests to a replica outside the
3061
- # include_replicas list when all of the specified replicas are unavailable or
3061
+ # If `true`, Spanner doesn't route requests to a replica outside the <`
3062
+ # include_replicas` list when all of the specified replicas are unavailable or
3062
3063
  # unhealthy. Default value is `false`.
3063
3064
  # Corresponds to the JSON property `autoFailoverDisabled`
3064
3065
  # @return [Boolean]
@@ -4450,9 +4451,9 @@ module Google
4450
4451
  end
4451
4452
 
4452
4453
  # When a read-write transaction is executed on a multiplexed session, this
4453
- # precommit token is sent back to the client as a part of the [Transaction]
4454
- # message in the BeginTransaction response and also as a part of the [ResultSet]
4455
- # and [PartialResultSet] responses.
4454
+ # precommit token is sent back to the client as a part of the Transaction
4455
+ # message in the BeginTransaction response and also as a part of the ResultSet
4456
+ # and PartialResultSet responses.
4456
4457
  class MultiplexedSessionPrecommitToken
4457
4458
  include Google::Apis::Core::Hashable
4458
4459
 
@@ -4682,15 +4683,23 @@ module Google
4682
4683
  attr_accessor :chunked_value
4683
4684
  alias_method :chunked_value?, :chunked_value
4684
4685
 
4686
+ # Optional. Indicates whether this is the last `PartialResultSet` in the stream.
4687
+ # The server might optionally set this field. Clients shouldn't rely on this
4688
+ # field being set in all cases.
4689
+ # Corresponds to the JSON property `last`
4690
+ # @return [Boolean]
4691
+ attr_accessor :last
4692
+ alias_method :last?, :last
4693
+
4685
4694
  # Metadata about a ResultSet or PartialResultSet.
4686
4695
  # Corresponds to the JSON property `metadata`
4687
4696
  # @return [Google::Apis::SpannerV1::ResultSetMetadata]
4688
4697
  attr_accessor :metadata
4689
4698
 
4690
4699
  # When a read-write transaction is executed on a multiplexed session, this
4691
- # precommit token is sent back to the client as a part of the [Transaction]
4692
- # message in the BeginTransaction response and also as a part of the [ResultSet]
4693
- # and [PartialResultSet] responses.
4700
+ # precommit token is sent back to the client as a part of the Transaction
4701
+ # message in the BeginTransaction response and also as a part of the ResultSet
4702
+ # and PartialResultSet responses.
4694
4703
  # Corresponds to the JSON property `precommitToken`
4695
4704
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
4696
4705
  attr_accessor :precommit_token
@@ -4713,37 +4722,37 @@ module Google
4713
4722
  # into many `PartialResultSet` messages to accommodate large rows and/or large
4714
4723
  # values. Every N complete values defines a row, where N is equal to the number
4715
4724
  # of entries in metadata.row_type.fields. Most values are encoded based on type
4716
- # as described here. It is possible that the last value in values is "chunked",
4725
+ # as described here. It's possible that the last value in values is "chunked",
4717
4726
  # meaning that the rest of the value is sent in subsequent `PartialResultSet`(s).
4718
4727
  # This is denoted by the chunked_value field. Two or more chunked values can be
4719
- # merged to form a complete value as follows: * `bool/number/null`: cannot be
4728
+ # merged to form a complete value as follows: * `bool/number/null`: can't be
4720
4729
  # chunked * `string`: concatenate the strings * `list`: concatenate the lists.
4721
4730
  # If the last element in a list is a `string`, `list`, or `object`, merge it
4722
4731
  # with the first element in the next list by applying these rules recursively. *
4723
4732
  # `object`: concatenate the (field name, field value) pairs. If a field name is
4724
4733
  # duplicated, then apply these rules recursively to merge the field values. Some
4725
- # examples of merging: # Strings are concatenated. "foo", "bar" => "foobar" #
4726
- # Lists of non-strings are concatenated. [2, 3], [4] => [2, 3, 4] # Lists are
4727
- # concatenated, but the last and first elements are merged # because they are
4728
- # strings. ["a", "b"], ["c", "d"] => ["a", "bc", "d"] # Lists are concatenated,
4729
- # but the last and first elements are merged # because they are lists.
4730
- # Recursively, the last and first elements # of the inner lists are merged
4731
- # because they are strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"],
4732
- # "e"] # Non-overlapping object fields are combined. `"a": "1"`, `"b": "2"` => `
4733
- # "a": "1", "b": 2"` # Overlapping object fields are merged. `"a": "1"`, `"a": "
4734
- # 2"` => `"a": "12"` # Examples of merging objects containing lists of strings. `
4735
- # "a": ["1"]`, `"a": ["2"]` => `"a": ["12"]` For a more complete example,
4736
- # suppose a streaming SQL query is yielding a result set whose rows contain a
4737
- # single string field. The following `PartialResultSet`s might be yielded: ` "
4738
- # metadata": ` ... ` "values": ["Hello", "W"] "chunked_value": true "
4739
- # resume_token": "Af65..." ` ` "values": ["orl"] "chunked_value": true ` ` "
4740
- # values": ["d"] "resume_token": "Zx1B..." ` This sequence of `PartialResultSet`
4741
- # s encodes two rows, one containing the field value `"Hello"`, and a second
4742
- # containing the field value `"World" = "W" + "orl" + "d"`. Not all `
4743
- # PartialResultSet`s contain a `resume_token`. Execution can only be resumed
4744
- # from a previously yielded `resume_token`. For the above sequence of `
4745
- # PartialResultSet`s, resuming the query with `"resume_token": "Af65..."` will
4746
- # yield results from the `PartialResultSet` with value `["orl"]`.
4734
+ # examples of merging: Strings are concatenated. "foo", "bar" => "foobar" Lists
4735
+ # of non-strings are concatenated. [2, 3], [4] => [2, 3, 4] Lists are
4736
+ # concatenated, but the last and first elements are merged because they are
4737
+ # strings. ["a", "b"], ["c", "d"] => ["a", "bc", "d"] Lists are concatenated,
4738
+ # but the last and first elements are merged because they are lists. Recursively,
4739
+ # the last and first elements of the inner lists are merged because they are
4740
+ # strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"] Non-
4741
+ # overlapping object fields are combined. `"a": "1"`, `"b": "2"` => `"a": "1", "
4742
+ # b": 2"` Overlapping object fields are merged. `"a": "1"`, `"a": "2"` => `"a": "
4743
+ # 12"` Examples of merging objects containing lists of strings. `"a": ["1"]`, `"
4744
+ # a": ["2"]` => `"a": ["12"]` For a more complete example, suppose a streaming
4745
+ # SQL query is yielding a result set whose rows contain a single string field.
4746
+ # The following `PartialResultSet`s might be yielded: ` "metadata": ` ... ` "
4747
+ # values": ["Hello", "W"] "chunked_value": true "resume_token": "Af65..." ` ` "
4748
+ # values": ["orl"] "chunked_value": true ` ` "values": ["d"] "resume_token": "
4749
+ # Zx1B..." ` This sequence of `PartialResultSet`s encodes two rows, one
4750
+ # containing the field value `"Hello"`, and a second containing the field value `
4751
+ # "World" = "W" + "orl" + "d"`. Not all `PartialResultSet`s contain a `
4752
+ # resume_token`. Execution can only be resumed from a previously yielded `
4753
+ # resume_token`. For the above sequence of `PartialResultSet`s, resuming the
4754
+ # query with `"resume_token": "Af65..."` yields results from the `
4755
+ # PartialResultSet` with value "orl".
4747
4756
  # Corresponds to the JSON property `values`
4748
4757
  # @return [Array<Object>]
4749
4758
  attr_accessor :values
@@ -4755,6 +4764,7 @@ module Google
4755
4764
  # Update properties of this object
4756
4765
  def update!(**args)
4757
4766
  @chunked_value = args[:chunked_value] if args.key?(:chunked_value)
4767
+ @last = args[:last] if args.key?(:last)
4758
4768
  @metadata = args[:metadata] if args.key?(:metadata)
4759
4769
  @precommit_token = args[:precommit_token] if args.key?(:precommit_token)
4760
4770
  @resume_token = args[:resume_token] if args.key?(:resume_token)
@@ -4767,8 +4777,8 @@ module Google
4767
4777
  class Partition
4768
4778
  include Google::Apis::Core::Hashable
4769
4779
 
4770
- # This token can be passed to Read, StreamingRead, ExecuteSql, or
4771
- # ExecuteStreamingSql requests to restrict the results to those identified by
4780
+ # This token can be passed to `Read`, `StreamingRead`, `ExecuteSql`, or `
4781
+ # ExecuteStreamingSql` requests to restrict the results to those identified by
4772
4782
  # this partition token.
4773
4783
  # Corresponds to the JSON property `partitionToken`
4774
4784
  # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -4785,24 +4795,24 @@ module Google
4785
4795
  end
4786
4796
  end
4787
4797
 
4788
- # Options for a PartitionQueryRequest and PartitionReadRequest.
4798
+ # Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
4789
4799
  class PartitionOptions
4790
4800
  include Google::Apis::Core::Hashable
4791
4801
 
4792
- # **Note:** This hint is currently ignored by PartitionQuery and PartitionRead
4793
- # requests. The desired maximum number of partitions to return. For example,
4794
- # this may be set to the number of workers available. The default for this
4795
- # option is currently 10,000. The maximum value is currently 200,000. This is
4796
- # only a hint. The actual number of partitions returned may be smaller or larger
4797
- # than this maximum count request.
4802
+ # **Note:** This hint is currently ignored by `PartitionQuery` and `
4803
+ # PartitionRead` requests. The desired maximum number of partitions to return.
4804
+ # For example, this might be set to the number of workers available. The default
4805
+ # for this option is currently 10,000. The maximum value is currently 200,000.
4806
+ # This is only a hint. The actual number of partitions returned can be smaller
4807
+ # or larger than this maximum count request.
4798
4808
  # Corresponds to the JSON property `maxPartitions`
4799
4809
  # @return [Fixnum]
4800
4810
  attr_accessor :max_partitions
4801
4811
 
4802
- # **Note:** This hint is currently ignored by PartitionQuery and PartitionRead
4803
- # requests. The desired data size for each partition generated. The default for
4804
- # this option is currently 1 GiB. This is only a hint. The actual size of each
4805
- # partition may be smaller or larger than this size request.
4812
+ # **Note:** This hint is currently ignored by `PartitionQuery` and `
4813
+ # PartitionRead` requests. The desired data size for each partition generated.
4814
+ # The default for this option is currently 1 GiB. This is only a hint. The
4815
+ # actual size of each partition can be smaller or larger than this size request.
4806
4816
  # Corresponds to the JSON property `partitionSizeBytes`
4807
4817
  # @return [Fixnum]
4808
4818
  attr_accessor :partition_size_bytes
@@ -4822,7 +4832,7 @@ module Google
4822
4832
  class PartitionQueryRequest
4823
4833
  include Google::Apis::Core::Hashable
4824
4834
 
4825
- # It is not always possible for Cloud Spanner to infer the right SQL type from a
4835
+ # It isn't always possible for Cloud Spanner to infer the right SQL type from a
4826
4836
  # JSON value. For example, values of type `BYTES` and values of type `STRING`
4827
4837
  # both appear in params as JSON strings. In these cases, `param_types` can be
4828
4838
  # used to specify the exact SQL type for some or all of the SQL query parameters.
@@ -4836,25 +4846,25 @@ module Google
4836
4846
  # name (for example, `@firstName`). Parameter names can contain letters, numbers,
4837
4847
  # and underscores. Parameters can appear anywhere that a literal value is
4838
4848
  # expected. The same parameter name can be used more than once, for example: `"
4839
- # WHERE id > @msg_id AND id < @msg_id + 100"` It is an error to execute a SQL
4849
+ # WHERE id > @msg_id AND id < @msg_id + 100"` It's an error to execute a SQL
4840
4850
  # statement with unbound parameters.
4841
4851
  # Corresponds to the JSON property `params`
4842
4852
  # @return [Hash<String,Object>]
4843
4853
  attr_accessor :params
4844
4854
 
4845
- # Options for a PartitionQueryRequest and PartitionReadRequest.
4855
+ # Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
4846
4856
  # Corresponds to the JSON property `partitionOptions`
4847
4857
  # @return [Google::Apis::SpannerV1::PartitionOptions]
4848
4858
  attr_accessor :partition_options
4849
4859
 
4850
4860
  # Required. The query request to generate partitions for. The request fails if
4851
- # the query is not root partitionable. For a query to be root partitionable, it
4861
+ # the query isn't root partitionable. For a query to be root partitionable, it
4852
4862
  # needs to satisfy a few conditions. For example, if the query execution plan
4853
4863
  # contains a distributed union operator, then it must be the first operator in
4854
4864
  # the plan. For more information about other conditions, see [Read data in
4855
4865
  # parallel](https://cloud.google.com/spanner/docs/reads#read_data_in_parallel).
4856
4866
  # The query request must not contain DML commands, such as `INSERT`, `UPDATE`,
4857
- # or `DELETE`. Use `ExecuteStreamingSql` with a PartitionedDml transaction for
4867
+ # or `DELETE`. Use `ExecuteStreamingSql` with a `PartitionedDml` transaction for
4858
4868
  # large, partition-friendly DML operations.
4859
4869
  # Corresponds to the JSON property `sql`
4860
4870
  # @return [String]
@@ -4905,7 +4915,7 @@ module Google
4905
4915
  # @return [Google::Apis::SpannerV1::KeySet]
4906
4916
  attr_accessor :key_set
4907
4917
 
4908
- # Options for a PartitionQueryRequest and PartitionReadRequest.
4918
+ # Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
4909
4919
  # Corresponds to the JSON property `partitionOptions`
4910
4920
  # @return [Google::Apis::SpannerV1::PartitionOptions]
4911
4921
  attr_accessor :partition_options
@@ -5206,10 +5216,10 @@ module Google
5206
5216
  # statistics package. Specifying `latest` as a value instructs Cloud Spanner to
5207
5217
  # use the latest generated statistics package. If not specified, Cloud Spanner
5208
5218
  # uses the statistics package set at the database level options, or the latest
5209
- # package if the database option is not set. The statistics package requested by
5219
+ # package if the database option isn't set. The statistics package requested by
5210
5220
  # the query has to be exempt from garbage collection. This can be achieved with
5211
- # the following DDL statement: ``` ALTER STATISTICS SET OPTIONS (allow_gc=false)
5212
- # ``` The list of available statistics packages can be queried from `
5221
+ # the following DDL statement: ```sql ALTER STATISTICS SET OPTIONS (allow_gc=
5222
+ # false) ``` The list of available statistics packages can be queried from `
5213
5223
  # INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an
5214
5224
  # invalid optimizer statistics package or with a statistics package that allows
5215
5225
  # garbage collection fails with an `INVALID_ARGUMENT` error.
@@ -5223,8 +5233,8 @@ module Google
5223
5233
  # optimizer version. If not specified, Cloud Spanner uses the optimizer version
5224
5234
  # set at the database level options. Any other positive integer (from the list
5225
5235
  # of supported optimizer versions) overrides the default optimizer version for
5226
- # query execution. The list of supported optimizer versions can be queried from
5227
- # SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an
5236
+ # query execution. The list of supported optimizer versions can be queried from `
5237
+ # SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS`. Executing a SQL statement with an
5228
5238
  # invalid optimizer version fails with an `INVALID_ARGUMENT` error. See https://
5229
5239
  # cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more
5230
5240
  # information on managing the query optimizer. The `optimizer_version` statement
@@ -5424,16 +5434,16 @@ module Google
5424
5434
 
5425
5435
  # If this is for a partitioned read and this field is set to `true`, the request
5426
5436
  # is executed with Spanner Data Boost independent compute resources. If the
5427
- # field is set to `true` but the request does not set `partition_token`, the API
5437
+ # field is set to `true` but the request doesn't set `partition_token`, the API
5428
5438
  # returns an `INVALID_ARGUMENT` error.
5429
5439
  # Corresponds to the JSON property `dataBoostEnabled`
5430
5440
  # @return [Boolean]
5431
5441
  attr_accessor :data_boost_enabled
5432
5442
  alias_method :data_boost_enabled?, :data_boost_enabled
5433
5443
 
5434
- # The DirectedReadOptions can be used to indicate which replicas or regions
5435
- # should be used for non-transactional reads or queries. DirectedReadOptions may
5436
- # only be specified for a read-only transaction, otherwise the API will return
5444
+ # The `DirectedReadOptions` can be used to indicate which replicas or regions
5445
+ # should be used for non-transactional reads or queries. `DirectedReadOptions`
5446
+ # can only be specified for a read-only transaction, otherwise the API returns
5437
5447
  # an `INVALID_ARGUMENT` error.
5438
5448
  # Corresponds to the JSON property `directedReadOptions`
5439
5449
  # @return [Google::Apis::SpannerV1::DirectedReadOptions]
@@ -5456,7 +5466,7 @@ module Google
5456
5466
  attr_accessor :key_set
5457
5467
 
5458
5468
  # If greater than zero, only the first `limit` rows are yielded. If `limit` is
5459
- # zero, the default is no limit. A limit cannot be specified if `partition_token`
5469
+ # zero, the default is no limit. A limit can't be specified if `partition_token`
5460
5470
  # is set.
5461
5471
  # Corresponds to the JSON property `limit`
5462
5472
  # @return [Fixnum]
@@ -5468,18 +5478,18 @@ module Google
5468
5478
  # @return [String]
5469
5479
  attr_accessor :lock_hint
5470
5480
 
5471
- # Optional. Order for the returned rows. By default, Spanner will return result
5472
- # rows in primary key order except for PartitionRead requests. For applications
5473
- # that do not require rows to be returned in primary key (`ORDER_BY_PRIMARY_KEY`)
5481
+ # Optional. Order for the returned rows. By default, Spanner returns result rows
5482
+ # in primary key order except for PartitionRead requests. For applications that
5483
+ # don't require rows to be returned in primary key (`ORDER_BY_PRIMARY_KEY`)
5474
5484
  # order, setting `ORDER_BY_NO_ORDER` option allows Spanner to optimize row
5475
- # retrieval, resulting in lower latencies in certain cases (e.g. bulk point
5476
- # lookups).
5485
+ # retrieval, resulting in lower latencies in certain cases (for example, bulk
5486
+ # point lookups).
5477
5487
  # Corresponds to the JSON property `orderBy`
5478
5488
  # @return [String]
5479
5489
  attr_accessor :order_by
5480
5490
 
5481
- # If present, results will be restricted to the specified partition previously
5482
- # created using PartitionRead(). There must be an exact match for the values of
5491
+ # If present, results are restricted to the specified partition previously
5492
+ # created using `PartitionRead`. There must be an exact match for the values of
5483
5493
  # fields common to this message and the PartitionReadRequest message used to
5484
5494
  # create this partition_token.
5485
5495
  # Corresponds to the JSON property `partitionToken`
@@ -5636,15 +5646,15 @@ module Google
5636
5646
  # following fields for replica selection: * `location` - The location must be
5637
5647
  # one of the regions within the multi-region configuration of your database. * `
5638
5648
  # type` - The type of the replica. Some examples of using replica_selectors are:
5639
- # * `location:us-east1` --> The "us-east1" replica(s) of any available type will
5640
- # be used to process the request. * `type:READ_ONLY` --> The "READ_ONLY" type
5641
- # replica(s) in nearest available location will be used to process the request. *
5649
+ # * `location:us-east1` --> The "us-east1" replica(s) of any available type is
5650
+ # used to process the request. * `type:READ_ONLY` --> The "READ_ONLY" type
5651
+ # replica(s) in the nearest available location are used to process the request. *
5642
5652
  # `location:us-east1 type:READ_ONLY` --> The "READ_ONLY" type replica(s) in
5643
- # location "us-east1" will be used to process the request.
5653
+ # location "us-east1" is used to process the request.
5644
5654
  class ReplicaSelection
5645
5655
  include Google::Apis::Core::Hashable
5646
5656
 
5647
- # The location or region of the serving requests, e.g. "us-east1".
5657
+ # The location or region of the serving requests, for example, "us-east1".
5648
5658
  # Corresponds to the JSON property `location`
5649
5659
  # @return [String]
5650
5660
  attr_accessor :location
@@ -5675,26 +5685,26 @@ module Google
5675
5685
  attr_accessor :priority
5676
5686
 
5677
5687
  # A per-request tag which can be applied to queries or reads, used for
5678
- # statistics collection. Both request_tag and transaction_tag can be specified
5679
- # for a read or query that belongs to a transaction. This field is ignored for
5680
- # requests where it's not applicable (e.g. CommitRequest). Legal characters for `
5681
- # request_tag` values are all printable characters (ASCII 32 - 126) and the
5682
- # length of a request_tag is limited to 50 characters. Values that exceed this
5683
- # limit are truncated. Any leading underscore (_) characters will be removed
5684
- # from the string.
5688
+ # statistics collection. Both `request_tag` and `transaction_tag` can be
5689
+ # specified for a read or query that belongs to a transaction. This field is
5690
+ # ignored for requests where it's not applicable (for example, `CommitRequest`).
5691
+ # Legal characters for `request_tag` values are all printable characters (ASCII
5692
+ # 32 - 126) and the length of a request_tag is limited to 50 characters. Values
5693
+ # that exceed this limit are truncated. Any leading underscore (_) characters
5694
+ # are removed from the string.
5685
5695
  # Corresponds to the JSON property `requestTag`
5686
5696
  # @return [String]
5687
5697
  attr_accessor :request_tag
5688
5698
 
5689
- # A tag used for statistics collection about this transaction. Both request_tag
5690
- # and transaction_tag can be specified for a read or query that belongs to a
5699
+ # A tag used for statistics collection about this transaction. Both `request_tag`
5700
+ # and `transaction_tag` can be specified for a read or query that belongs to a
5691
5701
  # transaction. The value of transaction_tag should be the same for all requests
5692
5702
  # belonging to the same transaction. If this request doesn't belong to any
5693
- # transaction, transaction_tag will be ignored. Legal characters for `
5703
+ # transaction, `transaction_tag` is ignored. Legal characters for `
5694
5704
  # transaction_tag` values are all printable characters (ASCII 32 - 126) and the
5695
- # length of a transaction_tag is limited to 50 characters. Values that exceed
5696
- # this limit are truncated. Any leading underscore (_) characters will be
5697
- # removed from the string.
5705
+ # length of a `transaction_tag` is limited to 50 characters. Values that exceed
5706
+ # this limit are truncated. Any leading underscore (_) characters are removed
5707
+ # from the string.
5698
5708
  # Corresponds to the JSON property `transactionTag`
5699
5709
  # @return [String]
5700
5710
  attr_accessor :transaction_tag
@@ -5889,9 +5899,9 @@ module Google
5889
5899
  attr_accessor :metadata
5890
5900
 
5891
5901
  # When a read-write transaction is executed on a multiplexed session, this
5892
- # precommit token is sent back to the client as a part of the [Transaction]
5893
- # message in the BeginTransaction response and also as a part of the [ResultSet]
5894
- # and [PartialResultSet] responses.
5902
+ # precommit token is sent back to the client as a part of the Transaction
5903
+ # message in the BeginTransaction response and also as a part of the ResultSet
5904
+ # and PartialResultSet responses.
5895
5905
  # Corresponds to the JSON property `precommitToken`
5896
5906
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
5897
5907
  attr_accessor :precommit_token
@@ -5973,7 +5983,7 @@ module Google
5973
5983
  # @return [Fixnum]
5974
5984
  attr_accessor :row_count_exact
5975
5985
 
5976
- # Partitioned DML does not offer exactly-once semantics, so it returns a lower
5986
+ # Partitioned DML doesn't offer exactly-once semantics, so it returns a lower
5977
5987
  # bound of the rows modified.
5978
5988
  # Corresponds to the JSON property `rowCountLowerBound`
5979
5989
  # @return [Fixnum]
@@ -6097,7 +6107,7 @@ module Google
6097
6107
  class Session
6098
6108
  include Google::Apis::Core::Hashable
6099
6109
 
6100
- # Output only. The approximate timestamp when the session is last used. It is
6110
+ # Output only. The approximate timestamp when the session is last used. It's
6101
6111
  # typically earlier than the actual last use time.
6102
6112
  # Corresponds to the JSON property `approximateLastUseTime`
6103
6113
  # @return [String]
@@ -6123,11 +6133,11 @@ module Google
6123
6133
  # @return [Hash<String,String>]
6124
6134
  attr_accessor :labels
6125
6135
 
6126
- # Optional. If true, specifies a multiplexed session. Use a multiplexed session
6127
- # for multiple, concurrent read-only operations. Don't use them for read-write
6128
- # transactions, partitioned reads, or partitioned queries. Use `sessions.create`
6129
- # to create multiplexed sessions. Don't use BatchCreateSessions to create a
6130
- # multiplexed session. You can't delete or list multiplexed sessions.
6136
+ # Optional. If `true`, specifies a multiplexed session. Use a multiplexed
6137
+ # session for multiple, concurrent read-only operations. Don't use them for read-
6138
+ # write transactions, partitioned reads, or partitioned queries. Use `sessions.
6139
+ # create` to create multiplexed sessions. Don't use BatchCreateSessions to
6140
+ # create a multiplexed session. You can't delete or list multiplexed sessions.
6131
6141
  # Corresponds to the JSON property `multiplexed`
6132
6142
  # @return [Boolean]
6133
6143
  attr_accessor :multiplexed
@@ -6294,7 +6304,7 @@ module Google
6294
6304
  class Statement
6295
6305
  include Google::Apis::Core::Hashable
6296
6306
 
6297
- # It is not always possible for Cloud Spanner to infer the right SQL type from a
6307
+ # It isn't always possible for Cloud Spanner to infer the right SQL type from a
6298
6308
  # JSON value. For example, values of type `BYTES` and values of type `STRING`
6299
6309
  # both appear in params as JSON strings. In these cases, `param_types` can be
6300
6310
  # used to specify the exact SQL type for some or all of the SQL statement
@@ -6308,7 +6318,7 @@ module Google
6308
6318
  # name (for example, `@firstName`). Parameter names can contain letters, numbers,
6309
6319
  # and underscores. Parameters can appear anywhere that a literal value is
6310
6320
  # expected. The same parameter name can be used more than once, for example: `"
6311
- # WHERE id > @msg_id AND id < @msg_id + 100"` It is an error to execute a SQL
6321
+ # WHERE id > @msg_id AND id < @msg_id + 100"` It's an error to execute a SQL
6312
6322
  # statement with unbound parameters.
6313
6323
  # Corresponds to the JSON property `params`
6314
6324
  # @return [Hash<String,Object>]
@@ -6445,9 +6455,9 @@ module Google
6445
6455
  attr_accessor :id
6446
6456
 
6447
6457
  # When a read-write transaction is executed on a multiplexed session, this
6448
- # precommit token is sent back to the client as a part of the [Transaction]
6449
- # message in the BeginTransaction response and also as a part of the [ResultSet]
6450
- # and [PartialResultSet] responses.
6458
+ # precommit token is sent back to the client as a part of the Transaction
6459
+ # message in the BeginTransaction response and also as a part of the ResultSet
6460
+ # and PartialResultSet responses.
6451
6461
  # Corresponds to the JSON property `precommitToken`
6452
6462
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
6453
6463
  attr_accessor :precommit_token
@@ -6683,6 +6693,11 @@ module Google
6683
6693
  attr_accessor :exclude_txn_from_change_streams
6684
6694
  alias_method :exclude_txn_from_change_streams?, :exclude_txn_from_change_streams
6685
6695
 
6696
+ # Isolation level for the transaction.
6697
+ # Corresponds to the JSON property `isolationLevel`
6698
+ # @return [String]
6699
+ attr_accessor :isolation_level
6700
+
6686
6701
  # Message type to initiate a Partitioned DML transaction.
6687
6702
  # Corresponds to the JSON property `partitionedDml`
6688
6703
  # @return [Google::Apis::SpannerV1::PartitionedDml]
@@ -6706,6 +6721,7 @@ module Google
6706
6721
  # Update properties of this object
6707
6722
  def update!(**args)
6708
6723
  @exclude_txn_from_change_streams = args[:exclude_txn_from_change_streams] if args.key?(:exclude_txn_from_change_streams)
6724
+ @isolation_level = args[:isolation_level] if args.key?(:isolation_level)
6709
6725
  @partitioned_dml = args[:partitioned_dml] if args.key?(:partitioned_dml)
6710
6726
  @read_only = args[:read_only] if args.key?(:read_only)
6711
6727
  @read_write = args[:read_write] if args.key?(:read_write)
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SpannerV1
18
18
  # Version of the google-apis-spanner_v1 gem
19
- GEM_VERSION = "0.39.0"
19
+ GEM_VERSION = "0.40.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.16.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250220"
25
+ REVISION = "20250304"
26
26
  end
27
27
  end
28
28
  end
@@ -2098,6 +2098,7 @@ module Google
2098
2098
  # @private
2099
2099
  class Representation < Google::Apis::Core::JsonRepresentation
2100
2100
  property :chunked_value, as: 'chunkedValue'
2101
+ property :last, as: 'last'
2101
2102
  property :metadata, as: 'metadata', class: Google::Apis::SpannerV1::ResultSetMetadata, decorator: Google::Apis::SpannerV1::ResultSetMetadata::Representation
2102
2103
 
2103
2104
  property :precommit_token, as: 'precommitToken', class: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken, decorator: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken::Representation
@@ -2543,6 +2544,7 @@ module Google
2543
2544
  # @private
2544
2545
  class Representation < Google::Apis::Core::JsonRepresentation
2545
2546
  property :exclude_txn_from_change_streams, as: 'excludeTxnFromChangeStreams'
2547
+ property :isolation_level, as: 'isolationLevel'
2546
2548
  property :partitioned_dml, as: 'partitionedDml', class: Google::Apis::SpannerV1::PartitionedDml, decorator: Google::Apis::SpannerV1::PartitionedDml::Representation
2547
2549
 
2548
2550
  property :read_only, as: 'readOnly', class: Google::Apis::SpannerV1::ReadOnly, decorator: Google::Apis::SpannerV1::ReadOnly::Representation
@@ -2921,15 +2921,15 @@ module Google
2921
2921
  # Batches the supplied mutation groups in a collection of efficient transactions.
2922
2922
  # All mutations in a group are committed atomically. However, mutations across
2923
2923
  # groups can be committed non-atomically in an unspecified order and thus, they
2924
- # must be independent of each other. Partial failure is possible, i.e., some
2925
- # groups may have been committed successfully, while some may have failed. The
2926
- # results of individual batches are streamed into the response as the batches
2927
- # are applied. BatchWrite requests are not replay protected, meaning that each
2928
- # mutation group may be applied more than once. Replays of non-idempotent
2929
- # mutations may have undesirable effects. For example, replays of an insert
2930
- # mutation may produce an already exists error or if you use generated or commit
2931
- # timestamp-based keys, it may result in additional rows being added to the
2932
- # mutation's table. We recommend structuring your mutation groups to be
2924
+ # must be independent of each other. Partial failure is possible, that is, some
2925
+ # groups might have been committed successfully, while some might have failed.
2926
+ # The results of individual batches are streamed into the response as the
2927
+ # batches are applied. `BatchWrite` requests are not replay protected, meaning
2928
+ # that each mutation group can be applied more than once. Replays of non-
2929
+ # idempotent mutations can have undesirable effects. For example, replays of an
2930
+ # insert mutation can produce an already exists error or if you use generated or
2931
+ # commit timestamp-based keys, it can result in additional rows being added to
2932
+ # the mutation's table. We recommend structuring your mutation groups to be
2933
2933
  # idempotent to avoid this issue.
2934
2934
  # @param [String] session
2935
2935
  # Required. The session in which the batch request is to be run.
@@ -3001,12 +3001,12 @@ module Google
3001
3001
  # rows in the database. `Commit` might return an `ABORTED` error. This can occur
3002
3002
  # at any time; commonly, the cause is conflicts with concurrent transactions.
3003
3003
  # However, it can also happen for a variety of other reasons. If `Commit`
3004
- # returns `ABORTED`, the caller should re-attempt the transaction from the
3005
- # beginning, re-using the same session. On very rare occasions, `Commit` might
3006
- # return `UNKNOWN`. This can happen, for example, if the client job experiences
3007
- # a 1+ hour networking failure. At that point, Cloud Spanner has lost track of
3008
- # the transaction outcome and we recommend that you perform another read from
3009
- # the database to see the state of things as they are now.
3004
+ # returns `ABORTED`, the caller should retry the transaction from the beginning,
3005
+ # reusing the same session. On very rare occasions, `Commit` might return `
3006
+ # UNKNOWN`. This can happen, for example, if the client job experiences a 1+
3007
+ # hour networking failure. At that point, Cloud Spanner has lost track of the
3008
+ # transaction outcome and we recommend that you perform another read from the
3009
+ # database to see the state of things as they are now.
3010
3010
  # @param [String] session
3011
3011
  # Required. The session in which the transaction to be committed is running.
3012
3012
  # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
@@ -3045,11 +3045,12 @@ module Google
3045
3045
  # transaction at a time. To execute multiple concurrent read-write/write-only
3046
3046
  # transactions, create multiple sessions. Note that standalone reads and queries
3047
3047
  # use a transaction internally, and count toward the one transaction limit.
3048
- # Active sessions use additional server resources, so it is a good idea to
3049
- # delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner
3050
- # may delete sessions for which no operations are sent for more than an hour. If
3051
- # a session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be
3052
- # kept alive by sending a trivial SQL query periodically, e.g., `"SELECT 1"`.
3048
+ # Active sessions use additional server resources, so it's a good idea to delete
3049
+ # idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner can
3050
+ # delete sessions when no operations are sent for more than an hour. If a
3051
+ # session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be
3052
+ # kept alive by sending a trivial SQL query periodically, for example, `"SELECT
3053
+ # 1"`.
3053
3054
  # @param [String] database
3054
3055
  # Required. The database in which the new session is created.
3055
3056
  # @param [Google::Apis::SpannerV1::CreateSessionRequest] create_session_request_object
@@ -3082,9 +3083,9 @@ module Google
3082
3083
  execute_or_queue_command(command, &block)
3083
3084
  end
3084
3085
 
3085
- # Ends a session, releasing server resources associated with it. This will
3086
- # asynchronously trigger cancellation of any operations that are running with
3087
- # this session.
3086
+ # Ends a session, releasing server resources associated with it. This
3087
+ # asynchronously triggers the cancellation of any operations that are running
3088
+ # with this session.
3088
3089
  # @param [String] name
3089
3090
  # Required. The name of the session to delete.
3090
3091
  # @param [String] fields
@@ -3154,7 +3155,7 @@ module Google
3154
3155
  end
3155
3156
 
3156
3157
  # Executes an SQL statement, returning all results in a single reply. This
3157
- # method cannot be used to return a result set larger than 10 MiB; if the query
3158
+ # method can't be used to return a result set larger than 10 MiB; if the query
3158
3159
  # yields more data than that, the query fails with a `FAILED_PRECONDITION` error.
3159
3160
  # Operations inside read-write transactions might return `ABORTED`. If this
3160
3161
  # occurs, the application should restart the transaction from the beginning. See
@@ -3231,7 +3232,7 @@ module Google
3231
3232
  execute_or_queue_command(command, &block)
3232
3233
  end
3233
3234
 
3234
- # Gets a session. Returns `NOT_FOUND` if the session does not exist. This is
3235
+ # Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is
3235
3236
  # mainly useful for determining whether a session is still alive.
3236
3237
  # @param [String] name
3237
3238
  # Required. The name of the session to retrieve.
@@ -3310,11 +3311,11 @@ module Google
3310
3311
  # Creates a set of partition tokens that can be used to execute a query
3311
3312
  # operation in parallel. Each of the returned partition tokens can be used by
3312
3313
  # ExecuteStreamingSql to specify a subset of the query result to read. The same
3313
- # session and read-only transaction must be used by the PartitionQueryRequest
3314
- # used to create the partition tokens and the ExecuteSqlRequests that use the
3314
+ # session and read-only transaction must be used by the `PartitionQueryRequest`
3315
+ # used to create the partition tokens and the `ExecuteSqlRequests` that use the
3315
3316
  # partition tokens. Partition tokens become invalid when the session used to
3316
3317
  # create them is deleted, is idle for too long, begins a new transaction, or
3317
- # becomes too old. When any of these happen, it is not possible to resume the
3318
+ # becomes too old. When any of these happen, it isn't possible to resume the
3318
3319
  # query, and the whole operation must be restarted from the beginning.
3319
3320
  # @param [String] session
3320
3321
  # Required. The session used to create the partitions.
@@ -3351,13 +3352,13 @@ module Google
3351
3352
  # Creates a set of partition tokens that can be used to execute a read operation
3352
3353
  # in parallel. Each of the returned partition tokens can be used by
3353
3354
  # StreamingRead to specify a subset of the read result to read. The same session
3354
- # and read-only transaction must be used by the PartitionReadRequest used to
3355
- # create the partition tokens and the ReadRequests that use the partition tokens.
3356
- # There are no ordering guarantees on rows returned among the returned
3357
- # partition tokens, or even within each individual StreamingRead call issued
3358
- # with a partition_token. Partition tokens become invalid when the session used
3359
- # to create them is deleted, is idle for too long, begins a new transaction, or
3360
- # becomes too old. When any of these happen, it is not possible to resume the
3355
+ # and read-only transaction must be used by the `PartitionReadRequest` used to
3356
+ # create the partition tokens and the `ReadRequests` that use the partition
3357
+ # tokens. There are no ordering guarantees on rows returned among the returned
3358
+ # partition tokens, or even within each individual `StreamingRead` call issued
3359
+ # with a `partition_token`. Partition tokens become invalid when the session
3360
+ # used to create them is deleted, is idle for too long, begins a new transaction,
3361
+ # or becomes too old. When any of these happen, it isn't possible to resume the
3361
3362
  # read, and the whole operation must be restarted from the beginning.
3362
3363
  # @param [String] session
3363
3364
  # Required. The session used to create the partitions.
@@ -3392,7 +3393,7 @@ module Google
3392
3393
  end
3393
3394
 
3394
3395
  # Reads rows from the database using key lookups and scans, as a simple key/
3395
- # value style alternative to ExecuteSql. This method cannot be used to return a
3396
+ # value style alternative to ExecuteSql. This method can't be used to return a
3396
3397
  # result set larger than 10 MiB; if the read matches more data than that, the
3397
3398
  # read fails with a `FAILED_PRECONDITION` error. Reads inside read-write
3398
3399
  # transactions might return `ABORTED`. If this occurs, the application should
@@ -3431,11 +3432,11 @@ module Google
3431
3432
  execute_or_queue_command(command, &block)
3432
3433
  end
3433
3434
 
3434
- # Rolls back a transaction, releasing any locks it holds. It is a good idea to
3435
+ # Rolls back a transaction, releasing any locks it holds. It's a good idea to
3435
3436
  # call this for any transaction that includes one or more Read or ExecuteSql
3436
3437
  # requests and ultimately decides not to commit. `Rollback` returns `OK` if it
3437
3438
  # successfully aborts the transaction, the transaction was already aborted, or
3438
- # the transaction is not found. `Rollback` never returns `ABORTED`.
3439
+ # the transaction isn't found. `Rollback` never returns `ABORTED`.
3439
3440
  # @param [String] session
3440
3441
  # Required. The session in which the transaction to roll back is running.
3441
3442
  # @param [Google::Apis::SpannerV1::RollbackRequest] rollback_request_object
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-spanner_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.39.0
4
+ version: 0.40.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-03-02 00:00:00.000000000 Z
10
+ date: 2025-03-16 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.39.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.40.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
62
62
  rdoc_options: []
63
63
  require_paths: