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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +8 -0
- data/lib/google/apis/spanner_v1/classes.rb +437 -179
- data/lib/google/apis/spanner_v1/gem_version.rb +2 -2
- data/lib/google/apis/spanner_v1/representations.rb +118 -0
- data/lib/google/apis/spanner_v1/service.rb +148 -40
- metadata +4 -4
@@ -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
|
@@ -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,
|
2821
|
-
# groups
|
2822
|
-
# results of individual batches are streamed into the response as the
|
2823
|
-
# are applied. BatchWrite requests are not replay protected, meaning
|
2824
|
-
# mutation group
|
2825
|
-
# mutations
|
2826
|
-
# mutation
|
2827
|
-
# timestamp-based keys, it
|
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
|
2901
|
-
#
|
2902
|
-
#
|
2903
|
-
#
|
2904
|
-
#
|
2905
|
-
#
|
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
|
2945
|
-
#
|
2946
|
-
#
|
2947
|
-
#
|
2948
|
-
# 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"`.
|
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
|
2982
|
-
# asynchronously
|
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
|
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
|
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
|
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
|
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
|
3252
|
-
# to create them is deleted, is idle for too long, begins a new transaction,
|
3253
|
-
# 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
|
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
|
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
|
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
|
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.
|
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-
|
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:
|
@@ -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.
|
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: []
|