google-apis-spanner_v1 0.38.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.
@@ -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.38.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 = "20241218"
25
+ REVISION = "20250304"
26
26
  end
27
27
  end
28
28
  end
@@ -22,6 +22,36 @@ module Google
22
22
  module Apis
23
23
  module SpannerV1
24
24
 
25
+ class AdaptMessageRequest
26
+ class Representation < Google::Apis::Core::JsonRepresentation; end
27
+
28
+ include Google::Apis::Core::JsonObjectSupport
29
+ end
30
+
31
+ class AdaptMessageResponse
32
+ class Representation < Google::Apis::Core::JsonRepresentation; end
33
+
34
+ include Google::Apis::Core::JsonObjectSupport
35
+ end
36
+
37
+ class AdapterSession
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+
40
+ include Google::Apis::Core::JsonObjectSupport
41
+ end
42
+
43
+ class AddSplitPointsRequest
44
+ class Representation < Google::Apis::Core::JsonRepresentation; end
45
+
46
+ include Google::Apis::Core::JsonObjectSupport
47
+ end
48
+
49
+ class AddSplitPointsResponse
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
25
55
  class AsymmetricAutoscalingOption
26
56
  class Representation < Google::Apis::Core::JsonRepresentation; end
27
57
 
@@ -64,6 +94,12 @@ module Google
64
94
  include Google::Apis::Core::JsonObjectSupport
65
95
  end
66
96
 
97
+ class BackupInstancePartition
98
+ class Representation < Google::Apis::Core::JsonRepresentation; end
99
+
100
+ include Google::Apis::Core::JsonObjectSupport
101
+ end
102
+
67
103
  class BackupSchedule
68
104
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
105
 
@@ -436,6 +472,12 @@ module Google
436
472
  include Google::Apis::Core::JsonObjectSupport
437
473
  end
438
474
 
475
+ class Key
476
+ class Representation < Google::Apis::Core::JsonRepresentation; end
477
+
478
+ include Google::Apis::Core::JsonObjectSupport
479
+ end
480
+
439
481
  class KeyRange
440
482
  class Representation < Google::Apis::Core::JsonRepresentation; end
441
483
 
@@ -826,6 +868,12 @@ module Google
826
868
  include Google::Apis::Core::JsonObjectSupport
827
869
  end
828
870
 
871
+ class SplitPoints
872
+ class Representation < Google::Apis::Core::JsonRepresentation; end
873
+
874
+ include Google::Apis::Core::JsonObjectSupport
875
+ end
876
+
829
877
  class Statement
830
878
  class Representation < Google::Apis::Core::JsonRepresentation; end
831
879
 
@@ -952,6 +1000,45 @@ module Google
952
1000
  include Google::Apis::Core::JsonObjectSupport
953
1001
  end
954
1002
 
1003
+ class AdaptMessageRequest
1004
+ # @private
1005
+ class Representation < Google::Apis::Core::JsonRepresentation
1006
+ hash :attachments, as: 'attachments'
1007
+ property :payload, :base64 => true, as: 'payload'
1008
+ property :protocol, as: 'protocol'
1009
+ end
1010
+ end
1011
+
1012
+ class AdaptMessageResponse
1013
+ # @private
1014
+ class Representation < Google::Apis::Core::JsonRepresentation
1015
+ property :payload, :base64 => true, as: 'payload'
1016
+ hash :state_updates, as: 'stateUpdates'
1017
+ end
1018
+ end
1019
+
1020
+ class AdapterSession
1021
+ # @private
1022
+ class Representation < Google::Apis::Core::JsonRepresentation
1023
+ property :name, as: 'name'
1024
+ end
1025
+ end
1026
+
1027
+ class AddSplitPointsRequest
1028
+ # @private
1029
+ class Representation < Google::Apis::Core::JsonRepresentation
1030
+ property :initiator, as: 'initiator'
1031
+ collection :split_points, as: 'splitPoints', class: Google::Apis::SpannerV1::SplitPoints, decorator: Google::Apis::SpannerV1::SplitPoints::Representation
1032
+
1033
+ end
1034
+ end
1035
+
1036
+ class AddSplitPointsResponse
1037
+ # @private
1038
+ class Representation < Google::Apis::Core::JsonRepresentation
1039
+ end
1040
+ end
1041
+
955
1042
  class AsymmetricAutoscalingOption
956
1043
  # @private
957
1044
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1016,6 +1103,8 @@ module Google
1016
1103
  property :expire_time, as: 'expireTime'
1017
1104
  property :freeable_size_bytes, :numeric_string => true, as: 'freeableSizeBytes'
1018
1105
  property :incremental_backup_chain_id, as: 'incrementalBackupChainId'
1106
+ collection :instance_partitions, as: 'instancePartitions', class: Google::Apis::SpannerV1::BackupInstancePartition, decorator: Google::Apis::SpannerV1::BackupInstancePartition::Representation
1107
+
1019
1108
  property :max_expire_time, as: 'maxExpireTime'
1020
1109
  property :name, as: 'name'
1021
1110
  property :oldest_version_time, as: 'oldestVersionTime'
@@ -1037,6 +1126,13 @@ module Google
1037
1126
  end
1038
1127
  end
1039
1128
 
1129
+ class BackupInstancePartition
1130
+ # @private
1131
+ class Representation < Google::Apis::Core::JsonRepresentation
1132
+ property :instance_partition, as: 'instancePartition'
1133
+ end
1134
+ end
1135
+
1040
1136
  class BackupSchedule
1041
1137
  # @private
1042
1138
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1469,6 +1565,7 @@ module Google
1469
1565
  class ExecuteBatchDmlRequest
1470
1566
  # @private
1471
1567
  class Representation < Google::Apis::Core::JsonRepresentation
1568
+ property :last_statements, as: 'lastStatements'
1472
1569
  property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
1473
1570
 
1474
1571
  property :seqno, :numeric_string => true, as: 'seqno'
@@ -1497,6 +1594,7 @@ module Google
1497
1594
  property :data_boost_enabled, as: 'dataBoostEnabled'
1498
1595
  property :directed_read_options, as: 'directedReadOptions', class: Google::Apis::SpannerV1::DirectedReadOptions, decorator: Google::Apis::SpannerV1::DirectedReadOptions::Representation
1499
1596
 
1597
+ property :last_statement, as: 'lastStatement'
1500
1598
  hash :param_types, as: 'paramTypes', class: Google::Apis::SpannerV1::Type, decorator: Google::Apis::SpannerV1::Type::Representation
1501
1599
 
1502
1600
  hash :params, as: 'params'
@@ -1689,6 +1787,13 @@ module Google
1689
1787
  end
1690
1788
  end
1691
1789
 
1790
+ class Key
1791
+ # @private
1792
+ class Representation < Google::Apis::Core::JsonRepresentation
1793
+ collection :key_parts, as: 'keyParts'
1794
+ end
1795
+ end
1796
+
1692
1797
  class KeyRange
1693
1798
  # @private
1694
1799
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1993,6 +2098,7 @@ module Google
1993
2098
  # @private
1994
2099
  class Representation < Google::Apis::Core::JsonRepresentation
1995
2100
  property :chunked_value, as: 'chunkedValue'
2101
+ property :last, as: 'last'
1996
2102
  property :metadata, as: 'metadata', class: Google::Apis::SpannerV1::ResultSetMetadata, decorator: Google::Apis::SpannerV1::ResultSetMetadata::Representation
1997
2103
 
1998
2104
  property :precommit_token, as: 'precommitToken', class: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken, decorator: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken::Representation
@@ -2372,6 +2478,17 @@ module Google
2372
2478
  end
2373
2479
  end
2374
2480
 
2481
+ class SplitPoints
2482
+ # @private
2483
+ class Representation < Google::Apis::Core::JsonRepresentation
2484
+ property :expire_time, as: 'expireTime'
2485
+ property :index, as: 'index'
2486
+ collection :keys, as: 'keys', class: Google::Apis::SpannerV1::Key, decorator: Google::Apis::SpannerV1::Key::Representation
2487
+
2488
+ property :table, as: 'table'
2489
+ end
2490
+ end
2491
+
2375
2492
  class Statement
2376
2493
  # @private
2377
2494
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2427,6 +2544,7 @@ module Google
2427
2544
  # @private
2428
2545
  class Representation < Google::Apis::Core::JsonRepresentation
2429
2546
  property :exclude_txn_from_change_streams, as: 'excludeTxnFromChangeStreams'
2547
+ property :isolation_level, as: 'isolationLevel'
2430
2548
  property :partitioned_dml, as: 'partitionedDml', class: Google::Apis::SpannerV1::PartitionedDml, decorator: Google::Apis::SpannerV1::PartitionedDml::Representation
2431
2549
 
2432
2550
  property :read_only, as: 'readOnly', class: Google::Apis::SpannerV1::ReadOnly, decorator: Google::Apis::SpannerV1::ReadOnly::Representation
@@ -1734,6 +1734,40 @@ module Google
1734
1734
  execute_or_queue_command(command, &block)
1735
1735
  end
1736
1736
 
1737
+ # Adds split points to specified tables, indexes of a database.
1738
+ # @param [String] database
1739
+ # Required. The database on whose tables/indexes split points are to be added.
1740
+ # Values are of the form `projects//instances//databases/`.
1741
+ # @param [Google::Apis::SpannerV1::AddSplitPointsRequest] add_split_points_request_object
1742
+ # @param [String] fields
1743
+ # Selector specifying which fields to include in a partial response.
1744
+ # @param [String] quota_user
1745
+ # Available to use for quota purposes for server-side applications. Can be any
1746
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1747
+ # @param [Google::Apis::RequestOptions] options
1748
+ # Request-specific options
1749
+ #
1750
+ # @yield [result, err] Result & error if block supplied
1751
+ # @yieldparam result [Google::Apis::SpannerV1::AddSplitPointsResponse] parsed result object
1752
+ # @yieldparam err [StandardError] error object if request failed
1753
+ #
1754
+ # @return [Google::Apis::SpannerV1::AddSplitPointsResponse]
1755
+ #
1756
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1757
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1758
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1759
+ def add_database_split_points(database, add_split_points_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1760
+ command = make_simple_command(:post, 'v1/{+database}:addSplitPoints', options)
1761
+ command.request_representation = Google::Apis::SpannerV1::AddSplitPointsRequest::Representation
1762
+ command.request_object = add_split_points_request_object
1763
+ command.response_representation = Google::Apis::SpannerV1::AddSplitPointsResponse::Representation
1764
+ command.response_class = Google::Apis::SpannerV1::AddSplitPointsResponse
1765
+ command.params['database'] = database unless database.nil?
1766
+ command.query['fields'] = fields unless fields.nil?
1767
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1768
+ execute_or_queue_command(command, &block)
1769
+ end
1770
+
1737
1771
  # `ChangeQuorum` is strictly restricted to databases that use dual-region
1738
1772
  # instance configurations. Initiates a background operation to change the quorum
1739
1773
  # of a database from dual-region mode to single-region mode or vice versa. The
@@ -2779,6 +2813,76 @@ module Google
2779
2813
  execute_or_queue_command(command, &block)
2780
2814
  end
2781
2815
 
2816
+ # Handles a single message from the client and returns the result as a stream.
2817
+ # The server will interpret the message frame and respond with message frames to
2818
+ # the client.
2819
+ # @param [String] name
2820
+ # Required. The database session in which the adapter request is processed.
2821
+ # @param [Google::Apis::SpannerV1::AdaptMessageRequest] adapt_message_request_object
2822
+ # @param [String] fields
2823
+ # Selector specifying which fields to include in a partial response.
2824
+ # @param [String] quota_user
2825
+ # Available to use for quota purposes for server-side applications. Can be any
2826
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2827
+ # @param [Google::Apis::RequestOptions] options
2828
+ # Request-specific options
2829
+ #
2830
+ # @yield [result, err] Result & error if block supplied
2831
+ # @yieldparam result [Google::Apis::SpannerV1::AdaptMessageResponse] parsed result object
2832
+ # @yieldparam err [StandardError] error object if request failed
2833
+ #
2834
+ # @return [Google::Apis::SpannerV1::AdaptMessageResponse]
2835
+ #
2836
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2837
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2838
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2839
+ def adapt_session_message(name, adapt_message_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2840
+ command = make_simple_command(:post, 'v1/{+name}:adaptMessage', options)
2841
+ command.request_representation = Google::Apis::SpannerV1::AdaptMessageRequest::Representation
2842
+ command.request_object = adapt_message_request_object
2843
+ command.response_representation = Google::Apis::SpannerV1::AdaptMessageResponse::Representation
2844
+ command.response_class = Google::Apis::SpannerV1::AdaptMessageResponse
2845
+ command.params['name'] = name unless name.nil?
2846
+ command.query['fields'] = fields unless fields.nil?
2847
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2848
+ execute_or_queue_command(command, &block)
2849
+ end
2850
+
2851
+ # Creates a new session to be used for requests made by the adapter. A session
2852
+ # identifies a specific incarnation of a database resource and is meant to be
2853
+ # reused across many `AdaptMessage` calls.
2854
+ # @param [String] parent
2855
+ # Required. The database in which the new session is created.
2856
+ # @param [Google::Apis::SpannerV1::AdapterSession] adapter_session_object
2857
+ # @param [String] fields
2858
+ # Selector specifying which fields to include in a partial response.
2859
+ # @param [String] quota_user
2860
+ # Available to use for quota purposes for server-side applications. Can be any
2861
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2862
+ # @param [Google::Apis::RequestOptions] options
2863
+ # Request-specific options
2864
+ #
2865
+ # @yield [result, err] Result & error if block supplied
2866
+ # @yieldparam result [Google::Apis::SpannerV1::AdapterSession] parsed result object
2867
+ # @yieldparam err [StandardError] error object if request failed
2868
+ #
2869
+ # @return [Google::Apis::SpannerV1::AdapterSession]
2870
+ #
2871
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2872
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2873
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2874
+ def adapter_project_instance_database_session(parent, adapter_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2875
+ command = make_simple_command(:post, 'v1/{+parent}/sessions:adapter', options)
2876
+ command.request_representation = Google::Apis::SpannerV1::AdapterSession::Representation
2877
+ command.request_object = adapter_session_object
2878
+ command.response_representation = Google::Apis::SpannerV1::AdapterSession::Representation
2879
+ command.response_class = Google::Apis::SpannerV1::AdapterSession
2880
+ command.params['parent'] = parent unless parent.nil?
2881
+ command.query['fields'] = fields unless fields.nil?
2882
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2883
+ execute_or_queue_command(command, &block)
2884
+ end
2885
+
2782
2886
  # Creates multiple new sessions. This API can be used to initialize a session
2783
2887
  # cache on the clients. See https://goo.gl/TgSFN2 for best practices on session
2784
2888
  # cache management.
@@ -2817,15 +2921,15 @@ module Google
2817
2921
  # Batches the supplied mutation groups in a collection of efficient transactions.
2818
2922
  # All mutations in a group are committed atomically. However, mutations across
2819
2923
  # groups can be committed non-atomically in an unspecified order and thus, they
2820
- # must be independent of each other. Partial failure is possible, i.e., some
2821
- # groups may have been committed successfully, while some may have failed. The
2822
- # results of individual batches are streamed into the response as the batches
2823
- # are applied. BatchWrite requests are not replay protected, meaning that each
2824
- # mutation group may be applied more than once. Replays of non-idempotent
2825
- # mutations may have undesirable effects. For example, replays of an insert
2826
- # mutation may produce an already exists error or if you use generated or commit
2827
- # timestamp-based keys, it may result in additional rows being added to the
2828
- # 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
2829
2933
  # idempotent to avoid this issue.
2830
2934
  # @param [String] session
2831
2935
  # Required. The session in which the batch request is to be run.
@@ -2897,12 +3001,12 @@ module Google
2897
3001
  # rows in the database. `Commit` might return an `ABORTED` error. This can occur
2898
3002
  # at any time; commonly, the cause is conflicts with concurrent transactions.
2899
3003
  # However, it can also happen for a variety of other reasons. If `Commit`
2900
- # returns `ABORTED`, the caller should re-attempt the transaction from the
2901
- # beginning, re-using the same session. On very rare occasions, `Commit` might
2902
- # return `UNKNOWN`. This can happen, for example, if the client job experiences
2903
- # a 1+ hour networking failure. At that point, Cloud Spanner has lost track of
2904
- # the transaction outcome and we recommend that you perform another read from
2905
- # 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.
2906
3010
  # @param [String] session
2907
3011
  # Required. The session in which the transaction to be committed is running.
2908
3012
  # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
@@ -2941,11 +3045,12 @@ module Google
2941
3045
  # transaction at a time. To execute multiple concurrent read-write/write-only
2942
3046
  # transactions, create multiple sessions. Note that standalone reads and queries
2943
3047
  # use a transaction internally, and count toward the one transaction limit.
2944
- # Active sessions use additional server resources, so it is a good idea to
2945
- # delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner
2946
- # may delete sessions for which no operations are sent for more than an hour. If
2947
- # a session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be
2948
- # 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"`.
2949
3054
  # @param [String] database
2950
3055
  # Required. The database in which the new session is created.
2951
3056
  # @param [Google::Apis::SpannerV1::CreateSessionRequest] create_session_request_object
@@ -2978,9 +3083,9 @@ module Google
2978
3083
  execute_or_queue_command(command, &block)
2979
3084
  end
2980
3085
 
2981
- # Ends a session, releasing server resources associated with it. This will
2982
- # asynchronously trigger cancellation of any operations that are running with
2983
- # 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.
2984
3089
  # @param [String] name
2985
3090
  # Required. The name of the session to delete.
2986
3091
  # @param [String] fields
@@ -3050,12 +3155,14 @@ module Google
3050
3155
  end
3051
3156
 
3052
3157
  # Executes an SQL statement, returning all results in a single reply. This
3053
- # 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
3054
3159
  # yields more data than that, the query fails with a `FAILED_PRECONDITION` error.
3055
3160
  # Operations inside read-write transactions might return `ABORTED`. If this
3056
3161
  # occurs, the application should restart the transaction from the beginning. See
3057
3162
  # Transaction for more details. Larger result sets can be fetched in streaming
3058
- # fashion by calling ExecuteStreamingSql instead.
3163
+ # fashion by calling ExecuteStreamingSql instead. The query string can be SQL or
3164
+ # [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/
3165
+ # standard-sql/graph-intro).
3059
3166
  # @param [String] session
3060
3167
  # Required. The session in which the SQL query should be performed.
3061
3168
  # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
@@ -3091,7 +3198,8 @@ module Google
3091
3198
  # Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql,
3092
3199
  # there is no limit on the size of the returned result set. However, no
3093
3200
  # individual row in the result set can exceed 100 MiB, and no column value can
3094
- # exceed 10 MiB.
3201
+ # exceed 10 MiB. The query string can be SQL or [Graph Query Language (GQL)](
3202
+ # https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
3095
3203
  # @param [String] session
3096
3204
  # Required. The session in which the SQL query should be performed.
3097
3205
  # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
@@ -3124,7 +3232,7 @@ module Google
3124
3232
  execute_or_queue_command(command, &block)
3125
3233
  end
3126
3234
 
3127
- # 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
3128
3236
  # mainly useful for determining whether a session is still alive.
3129
3237
  # @param [String] name
3130
3238
  # Required. The name of the session to retrieve.
@@ -3203,11 +3311,11 @@ module Google
3203
3311
  # Creates a set of partition tokens that can be used to execute a query
3204
3312
  # operation in parallel. Each of the returned partition tokens can be used by
3205
3313
  # ExecuteStreamingSql to specify a subset of the query result to read. The same
3206
- # session and read-only transaction must be used by the PartitionQueryRequest
3207
- # 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
3208
3316
  # partition tokens. Partition tokens become invalid when the session used to
3209
3317
  # create them is deleted, is idle for too long, begins a new transaction, or
3210
- # 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
3211
3319
  # query, and the whole operation must be restarted from the beginning.
3212
3320
  # @param [String] session
3213
3321
  # Required. The session used to create the partitions.
@@ -3244,13 +3352,13 @@ module Google
3244
3352
  # Creates a set of partition tokens that can be used to execute a read operation
3245
3353
  # in parallel. Each of the returned partition tokens can be used by
3246
3354
  # StreamingRead to specify a subset of the read result to read. The same session
3247
- # and read-only transaction must be used by the PartitionReadRequest used to
3248
- # create the partition tokens and the ReadRequests that use the partition tokens.
3249
- # There are no ordering guarantees on rows returned among the returned
3250
- # partition tokens, or even within each individual StreamingRead call issued
3251
- # with a partition_token. Partition tokens become invalid when the session used
3252
- # to create them is deleted, is idle for too long, begins a new transaction, or
3253
- # 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
3254
3362
  # read, and the whole operation must be restarted from the beginning.
3255
3363
  # @param [String] session
3256
3364
  # Required. The session used to create the partitions.
@@ -3285,7 +3393,7 @@ module Google
3285
3393
  end
3286
3394
 
3287
3395
  # Reads rows from the database using key lookups and scans, as a simple key/
3288
- # 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
3289
3397
  # result set larger than 10 MiB; if the read matches more data than that, the
3290
3398
  # read fails with a `FAILED_PRECONDITION` error. Reads inside read-write
3291
3399
  # transactions might return `ABORTED`. If this occurs, the application should
@@ -3324,11 +3432,11 @@ module Google
3324
3432
  execute_or_queue_command(command, &block)
3325
3433
  end
3326
3434
 
3327
- # 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
3328
3436
  # call this for any transaction that includes one or more Read or ExecuteSql
3329
3437
  # requests and ultimately decides not to commit. `Rollback` returns `OK` if it
3330
3438
  # successfully aborts the transaction, the transaction was already aborted, or
3331
- # the transaction is not found. `Rollback` never returns `ABORTED`.
3439
+ # the transaction isn't found. `Rollback` never returns `ABORTED`.
3332
3440
  # @param [String] session
3333
3441
  # Required. The session in which the transaction to roll back is running.
3334
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.38.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-01-12 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.38.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:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
73
73
  - !ruby/object:Gem::Version
74
74
  version: '0'
75
75
  requirements: []
76
- rubygems_version: 3.6.2
76
+ rubygems_version: 3.6.5
77
77
  specification_version: 4
78
78
  summary: Simple REST client for Cloud Spanner API V1
79
79
  test_files: []