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:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 1a50443bc6a46b5a52d114224ab619dd8b5fe0e97fbf198eade1808a8fd0f8fc
|
4
|
+
data.tar.gz: bc0d41f46eca6c234dc65a81e6a0c351c8ae6d9ca5664f86b8e97bb20084bc6b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 77ffd2d1ab620128564dd2d65ed20a72cab9d92d3ba82437b5488f251efad7ecce7c2b81ba2effd5291000572e406f2d7fe7bc3f6570930a554847b701979550
|
7
|
+
data.tar.gz: 847be06db5cc5516c1d976913f74d59f18c5753091dbf93c8d55fbe7db0018eb96da91e2593516892803157a3de0e5dfd9cac91cdd1cea0c42158bad2e76a610
|
data/CHANGELOG.md
CHANGED
@@ -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
|
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
|
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
|
720
|
-
#
|
721
|
-
#
|
722
|
-
#
|
723
|
-
#
|
724
|
-
#
|
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
|
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
|
1241
|
-
# message in the BeginTransaction response and also as a part of the
|
1242
|
-
# and
|
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
|
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
|
1493
|
-
# message in the BeginTransaction response and also as a part of the
|
1494
|
-
# and
|
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
|
2440
|
-
# only be specified for a read-only transaction, otherwise the API
|
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
|
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
|
2595
|
-
#
|
2596
|
-
#
|
2597
|
-
# reads and queries)
|
2598
|
-
# reporting to be deferred until commit time (
|
2599
|
-
# constraints). Given this, successful execution of statements
|
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
|
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
|
2616
|
-
# aborted. Replays of previously handled requests
|
2617
|
-
#
|
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
|
2670
|
-
# message in the BeginTransaction response and also as a part of the
|
2671
|
-
# and
|
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
|
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
|
2722
|
-
# only be specified for a read-only transaction, otherwise the API
|
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
|
2729
|
-
#
|
2730
|
-
#
|
2731
|
-
# reads and queries)
|
2732
|
-
#
|
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
|
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
|
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,
|
2744
|
-
#
|
2745
|
-
# parameters. See the definition of Type for more information about
|
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
|
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
|
2763
|
-
# created using PartitionQuery
|
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
|
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
|
2802
|
-
# of previously handled requests
|
2803
|
-
#
|
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
|
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
|
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
|
4454
|
-
# message in the BeginTransaction response and also as a part of the
|
4455
|
-
# and
|
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
|
4692
|
-
# message in the BeginTransaction response and also as a part of the
|
4693
|
-
# and
|
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
|
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`:
|
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:
|
4726
|
-
#
|
4727
|
-
# concatenated, but the last and first elements are merged
|
4728
|
-
# strings. ["a", "b"], ["c", "d"] => ["a", "bc", "d"]
|
4729
|
-
# but the last and first elements are merged
|
4730
|
-
#
|
4731
|
-
#
|
4732
|
-
#
|
4733
|
-
#
|
4734
|
-
#
|
4735
|
-
#
|
4736
|
-
#
|
4737
|
-
#
|
4738
|
-
#
|
4739
|
-
#
|
4740
|
-
#
|
4741
|
-
#
|
4742
|
-
#
|
4743
|
-
#
|
4744
|
-
#
|
4745
|
-
#
|
4746
|
-
#
|
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
|
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
|
4793
|
-
# requests. The desired maximum number of partitions to return.
|
4794
|
-
# this
|
4795
|
-
# option is currently 10,000. The maximum value is currently 200,000.
|
4796
|
-
# only a hint. The actual number of partitions returned
|
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
|
4803
|
-
# requests. The desired data size for each partition generated.
|
4804
|
-
# this option is currently 1 GiB. This is only a hint. The
|
4805
|
-
# partition
|
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
|
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
|
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
|
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
|
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=
|
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
|
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
|
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
|
5436
|
-
# only be specified for a read-only transaction, otherwise the API
|
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
|
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
|
5472
|
-
#
|
5473
|
-
#
|
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 (
|
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
|
5482
|
-
# created using PartitionRead
|
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
|
5640
|
-
#
|
5641
|
-
# replica(s) in nearest available location
|
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"
|
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,
|
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
|
5679
|
-
# for a read or query that belongs to a transaction. This field is
|
5680
|
-
# requests where it's not applicable (
|
5681
|
-
# request_tag` values are all printable characters (ASCII
|
5682
|
-
# length of a request_tag is limited to 50 characters. Values
|
5683
|
-
# limit are truncated. Any leading underscore (_) characters
|
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
|
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
|
5697
|
-
#
|
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
|
5893
|
-
# message in the BeginTransaction response and also as a part of the
|
5894
|
-
# and
|
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
|
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
|
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
|
6127
|
-
# for multiple, concurrent read-only operations. Don't use them for read-
|
6128
|
-
# transactions, partitioned reads, or partitioned queries. Use `sessions.
|
6129
|
-
# to create multiplexed sessions. Don't use BatchCreateSessions to
|
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
|
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
|
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
|
6449
|
-
# message in the BeginTransaction response and also as a part of the
|
6450
|
-
# and
|
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.
|
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 = "
|
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,
|
2925
|
-
# groups
|
2926
|
-
# results of individual batches are streamed into the response as the
|
2927
|
-
# are applied. BatchWrite requests are not replay protected, meaning
|
2928
|
-
# mutation group
|
2929
|
-
# mutations
|
2930
|
-
# mutation
|
2931
|
-
# timestamp-based keys, it
|
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
|
3005
|
-
#
|
3006
|
-
#
|
3007
|
-
#
|
3008
|
-
#
|
3009
|
-
#
|
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
|
3049
|
-
#
|
3050
|
-
#
|
3051
|
-
#
|
3052
|
-
# kept alive by sending a trivial SQL query periodically,
|
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
|
3086
|
-
# asynchronously
|
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
|
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
|
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
|
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
|
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
|
3359
|
-
# to create them is deleted, is idle for too long, begins a new transaction,
|
3360
|
-
# becomes too old. When any of these happen, it
|
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
|
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
|
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
|
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.
|
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-
|
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.
|
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:
|