google-cloud-spanner-v1 1.4.0 → 1.6.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/README.md +1 -1
- data/lib/google/cloud/spanner/v1/spanner/client.rb +11 -0
- data/lib/google/cloud/spanner/v1/version.rb +1 -1
- data/lib/google/spanner/v1/type_pb.rb +1 -1
- data/proto_docs/google/protobuf/struct.rb +12 -0
- data/proto_docs/google/spanner/v1/keys.rb +8 -0
- data/proto_docs/google/spanner/v1/mutation.rb +10 -0
- data/proto_docs/google/spanner/v1/result_set.rb +4 -0
- data/proto_docs/google/spanner/v1/spanner.rb +8 -0
- data/proto_docs/google/spanner/v1/transaction.rb +22 -0
- data/proto_docs/google/spanner/v1/type.rb +4 -0
- metadata +6 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 263176d27e7a17047a1cce07d6c8d689545e041165be967c844bb4e7a0efedad
|
4
|
+
data.tar.gz: 955f9cab32b046a967e976a7fb3d9b8d85d639e83f832a4fcb4b116467afa12c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 740038bbd4dee2ca57f46e8a8fdbab30124b9518a5ede0d4788f08413acfed6ae325c6b06f42c8ac062ab7f6380ce5bee88307bbdda0ab76bf6603fd8a2d8fab
|
7
|
+
data.tar.gz: 6ea8764ff08a7a06a25210dd1f68ea49e2889bb46b6582eed5ff2bb018491a134dc17c931128f45b8e883c6e104c6b2c5f132b03e7c75484cb69d579a9f9c156
|
data/README.md
CHANGED
@@ -85,7 +85,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
|
|
85
85
|
|
86
86
|
## Supported Ruby Versions
|
87
87
|
|
88
|
-
This library is supported on Ruby
|
88
|
+
This library is supported on Ruby 3.0+.
|
89
89
|
|
90
90
|
Google provides official support for Ruby versions that are actively supported
|
91
91
|
by Ruby Core—that is, Ruby versions that are either in normal maintenance or
|
@@ -1707,6 +1707,8 @@ module Google
|
|
1707
1707
|
# Required. The session in which the transaction to be committed is running.
|
1708
1708
|
# @param transaction_id [::String]
|
1709
1709
|
# Commit a previously-started transaction.
|
1710
|
+
#
|
1711
|
+
# Note: The following fields are mutually exclusive: `transaction_id`, `single_use_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
1710
1712
|
# @param single_use_transaction [::Google::Cloud::Spanner::V1::TransactionOptions, ::Hash]
|
1711
1713
|
# Execute mutations in a temporary transaction. Note that unlike
|
1712
1714
|
# commit of a previously-started transaction, commit with a
|
@@ -1717,6 +1719,8 @@ module Google
|
|
1717
1719
|
# executed more than once. If this is undesirable, use
|
1718
1720
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction} and
|
1719
1721
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} instead.
|
1722
|
+
#
|
1723
|
+
# Note: The following fields are mutually exclusive: `single_use_transaction`, `transaction_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
1720
1724
|
# @param mutations [::Array<::Google::Cloud::Spanner::V1::Mutation, ::Hash>]
|
1721
1725
|
# The mutations to be executed when this transaction commits. All
|
1722
1726
|
# mutations are applied atomically, in the order they appear in
|
@@ -2326,6 +2330,13 @@ module Google
|
|
2326
2330
|
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
2327
2331
|
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
2328
2332
|
# * (`nil`) indicating no credentials
|
2333
|
+
#
|
2334
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
2335
|
+
# external source for authentication to Google Cloud, you must validate it before
|
2336
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
2337
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
2338
|
+
# For more information, refer to [Validate credential configurations from external
|
2339
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
2329
2340
|
# @return [::Object]
|
2330
2341
|
# @!attribute [rw] scope
|
2331
2342
|
# The OAuth scopes
|
@@ -7,7 +7,7 @@ require 'google/protobuf'
|
|
7
7
|
require 'google/api/field_behavior_pb'
|
8
8
|
|
9
9
|
|
10
|
-
descriptor_data = "\n\x1cgoogle/spanner/v1/type.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\"\xf7\x01\n\x04Type\x12.\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCodeB\x03\xe0\x41\x02\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12>\n\x0ftype_annotation\x18\x04 \x01(\x0e\x32%.google.spanner.v1.TypeAnnotationCode\x12\x16\n\x0eproto_type_fqn\x18\x05 \x01(\t\"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\
|
10
|
+
descriptor_data = "\n\x1cgoogle/spanner/v1/type.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\"\xf7\x01\n\x04Type\x12.\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCodeB\x03\xe0\x41\x02\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12>\n\x0ftype_annotation\x18\x04 \x01(\x0e\x32%.google.spanner.v1.TypeAnnotationCode\x12\x16\n\x0eproto_type_fqn\x18\x05 \x01(\t\"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\xdf\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\x0b\n\x07\x46LOAT32\x10\x0f\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\t\x12\x0b\n\x07NUMERIC\x10\n\x12\x08\n\x04JSON\x10\x0b\x12\t\n\x05PROTO\x10\r\x12\x08\n\x04\x45NUM\x10\x0e\x12\x0c\n\x08INTERVAL\x10\x10\x12\x08\n\x04UUID\x10\x11*d\n\x12TypeAnnotationCode\x12$\n TYPE_ANNOTATION_CODE_UNSPECIFIED\x10\x00\x12\x0e\n\nPG_NUMERIC\x10\x02\x12\x0c\n\x08PG_JSONB\x10\x03\x12\n\n\x06PG_OID\x10\x04\x42\xac\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z5cloud.google.com/go/spanner/apiv1/spannerpb;spannerpb\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3"
|
11
11
|
|
12
12
|
pool = Google::Protobuf::DescriptorPool.generated_pool
|
13
13
|
|
@@ -53,21 +53,33 @@ module Google
|
|
53
53
|
# @!attribute [rw] null_value
|
54
54
|
# @return [::Google::Protobuf::NullValue]
|
55
55
|
# Represents a null value.
|
56
|
+
#
|
57
|
+
# Note: The following fields are mutually exclusive: `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
56
58
|
# @!attribute [rw] number_value
|
57
59
|
# @return [::Float]
|
58
60
|
# Represents a double value.
|
61
|
+
#
|
62
|
+
# Note: The following fields are mutually exclusive: `number_value`, `null_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
59
63
|
# @!attribute [rw] string_value
|
60
64
|
# @return [::String]
|
61
65
|
# Represents a string value.
|
66
|
+
#
|
67
|
+
# Note: The following fields are mutually exclusive: `string_value`, `null_value`, `number_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
62
68
|
# @!attribute [rw] bool_value
|
63
69
|
# @return [::Boolean]
|
64
70
|
# Represents a boolean value.
|
71
|
+
#
|
72
|
+
# Note: The following fields are mutually exclusive: `bool_value`, `null_value`, `number_value`, `string_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
65
73
|
# @!attribute [rw] struct_value
|
66
74
|
# @return [::Google::Protobuf::Struct]
|
67
75
|
# Represents a structured value.
|
76
|
+
#
|
77
|
+
# Note: The following fields are mutually exclusive: `struct_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
68
78
|
# @!attribute [rw] list_value
|
69
79
|
# @return [::Google::Protobuf::ListValue]
|
70
80
|
# Represents a repeated `Value`.
|
81
|
+
#
|
82
|
+
# Note: The following fields are mutually exclusive: `list_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
71
83
|
class Value
|
72
84
|
include ::Google::Protobuf::MessageExts
|
73
85
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -113,18 +113,26 @@ module Google
|
|
113
113
|
# @return [::Google::Protobuf::ListValue]
|
114
114
|
# If the start is closed, then the range includes all rows whose
|
115
115
|
# first `len(start_closed)` key columns exactly match `start_closed`.
|
116
|
+
#
|
117
|
+
# Note: The following fields are mutually exclusive: `start_closed`, `start_open`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
116
118
|
# @!attribute [rw] start_open
|
117
119
|
# @return [::Google::Protobuf::ListValue]
|
118
120
|
# If the start is open, then the range excludes rows whose first
|
119
121
|
# `len(start_open)` key columns exactly match `start_open`.
|
122
|
+
#
|
123
|
+
# Note: The following fields are mutually exclusive: `start_open`, `start_closed`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
120
124
|
# @!attribute [rw] end_closed
|
121
125
|
# @return [::Google::Protobuf::ListValue]
|
122
126
|
# If the end is closed, then the range includes all rows whose
|
123
127
|
# first `len(end_closed)` key columns exactly match `end_closed`.
|
128
|
+
#
|
129
|
+
# Note: The following fields are mutually exclusive: `end_closed`, `end_open`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
124
130
|
# @!attribute [rw] end_open
|
125
131
|
# @return [::Google::Protobuf::ListValue]
|
126
132
|
# If the end is open, then the range excludes rows whose first
|
127
133
|
# `len(end_open)` key columns exactly match `end_open`.
|
134
|
+
#
|
135
|
+
# Note: The following fields are mutually exclusive: `end_open`, `end_closed`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
128
136
|
class KeyRange
|
129
137
|
include ::Google::Protobuf::MessageExts
|
130
138
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -28,10 +28,14 @@ module Google
|
|
28
28
|
# @return [::Google::Cloud::Spanner::V1::Mutation::Write]
|
29
29
|
# Insert new rows in a table. If any of the rows already exist,
|
30
30
|
# the write or transaction fails with error `ALREADY_EXISTS`.
|
31
|
+
#
|
32
|
+
# Note: The following fields are mutually exclusive: `insert`, `update`, `insert_or_update`, `replace`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
31
33
|
# @!attribute [rw] update
|
32
34
|
# @return [::Google::Cloud::Spanner::V1::Mutation::Write]
|
33
35
|
# Update existing rows in a table. If any of the rows does not
|
34
36
|
# already exist, the transaction fails with error `NOT_FOUND`.
|
37
|
+
#
|
38
|
+
# Note: The following fields are mutually exclusive: `update`, `insert`, `insert_or_update`, `replace`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
35
39
|
# @!attribute [rw] insert_or_update
|
36
40
|
# @return [::Google::Cloud::Spanner::V1::Mutation::Write]
|
37
41
|
# Like {::Google::Cloud::Spanner::V1::Mutation#insert insert}, except that if the row already exists, then
|
@@ -41,6 +45,8 @@ module Google
|
|
41
45
|
# When using {::Google::Cloud::Spanner::V1::Mutation#insert_or_update insert_or_update}, just as when using {::Google::Cloud::Spanner::V1::Mutation#insert insert}, all `NOT
|
42
46
|
# NULL` columns in the table must be given a value. This holds true
|
43
47
|
# even when the row already exists and will therefore actually be updated.
|
48
|
+
#
|
49
|
+
# Note: The following fields are mutually exclusive: `insert_or_update`, `insert`, `update`, `replace`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
44
50
|
# @!attribute [rw] replace
|
45
51
|
# @return [::Google::Cloud::Spanner::V1::Mutation::Write]
|
46
52
|
# Like {::Google::Cloud::Spanner::V1::Mutation#insert insert}, except that if the row already exists, it is
|
@@ -52,10 +58,14 @@ module Google
|
|
52
58
|
# `ON DELETE CASCADE` annotation, then replacing a parent row
|
53
59
|
# also deletes the child rows. Otherwise, you must delete the
|
54
60
|
# child rows before you replace the parent row.
|
61
|
+
#
|
62
|
+
# Note: The following fields are mutually exclusive: `replace`, `insert`, `update`, `insert_or_update`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
55
63
|
# @!attribute [rw] delete
|
56
64
|
# @return [::Google::Cloud::Spanner::V1::Mutation::Delete]
|
57
65
|
# Delete rows from a table. Succeeds whether or not the named
|
58
66
|
# rows were present.
|
67
|
+
#
|
68
|
+
# Note: The following fields are mutually exclusive: `delete`, `insert`, `update`, `insert_or_update`, `replace`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
59
69
|
class Mutation
|
60
70
|
include ::Google::Protobuf::MessageExts
|
61
71
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -224,10 +224,14 @@ module Google
|
|
224
224
|
# @!attribute [rw] row_count_exact
|
225
225
|
# @return [::Integer]
|
226
226
|
# Standard DML returns an exact count of rows that were modified.
|
227
|
+
#
|
228
|
+
# Note: The following fields are mutually exclusive: `row_count_exact`, `row_count_lower_bound`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
227
229
|
# @!attribute [rw] row_count_lower_bound
|
228
230
|
# @return [::Integer]
|
229
231
|
# Partitioned DML does not offer exactly-once semantics, so it
|
230
232
|
# returns a lower bound of the rows modified.
|
233
|
+
#
|
234
|
+
# Note: The following fields are mutually exclusive: `row_count_lower_bound`, `row_count_exact`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
231
235
|
class ResultSetStats
|
232
236
|
include ::Google::Protobuf::MessageExts
|
233
237
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -251,11 +251,15 @@ module Google
|
|
251
251
|
# true and all replicas are exhausted without finding a healthy replica,
|
252
252
|
# Spanner will wait for a replica in the list to become available, requests
|
253
253
|
# may fail due to `DEADLINE_EXCEEDED` errors.
|
254
|
+
#
|
255
|
+
# Note: The following fields are mutually exclusive: `include_replicas`, `exclude_replicas`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
254
256
|
# @!attribute [rw] exclude_replicas
|
255
257
|
# @return [::Google::Cloud::Spanner::V1::DirectedReadOptions::ExcludeReplicas]
|
256
258
|
# Exclude_replicas indicates that specified replicas should be excluded
|
257
259
|
# from serving requests. Spanner will not route requests to the replicas
|
258
260
|
# in this list.
|
261
|
+
#
|
262
|
+
# Note: The following fields are mutually exclusive: `exclude_replicas`, `include_replicas`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
259
263
|
class DirectedReadOptions
|
260
264
|
include ::Google::Protobuf::MessageExts
|
261
265
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -1029,6 +1033,8 @@ module Google
|
|
1029
1033
|
# @!attribute [rw] transaction_id
|
1030
1034
|
# @return [::String]
|
1031
1035
|
# Commit a previously-started transaction.
|
1036
|
+
#
|
1037
|
+
# Note: The following fields are mutually exclusive: `transaction_id`, `single_use_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
1032
1038
|
# @!attribute [rw] single_use_transaction
|
1033
1039
|
# @return [::Google::Cloud::Spanner::V1::TransactionOptions]
|
1034
1040
|
# Execute mutations in a temporary transaction. Note that unlike
|
@@ -1040,6 +1046,8 @@ module Google
|
|
1040
1046
|
# executed more than once. If this is undesirable, use
|
1041
1047
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction} and
|
1042
1048
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} instead.
|
1049
|
+
#
|
1050
|
+
# Note: The following fields are mutually exclusive: `single_use_transaction`, `transaction_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
1043
1051
|
# @!attribute [rw] mutations
|
1044
1052
|
# @return [::Array<::Google::Cloud::Spanner::V1::Mutation>]
|
1045
1053
|
# The mutations to be executed when this transaction commits. All
|
@@ -352,6 +352,8 @@ module Google
|
|
352
352
|
# Authorization to begin a read-write transaction requires
|
353
353
|
# `spanner.databases.beginOrRollbackReadWriteTransaction` permission
|
354
354
|
# on the `session` resource.
|
355
|
+
#
|
356
|
+
# Note: The following fields are mutually exclusive: `read_write`, `partitioned_dml`, `read_only`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
355
357
|
# @!attribute [rw] partitioned_dml
|
356
358
|
# @return [::Google::Cloud::Spanner::V1::TransactionOptions::PartitionedDml]
|
357
359
|
# Partitioned DML transaction.
|
@@ -359,6 +361,8 @@ module Google
|
|
359
361
|
# Authorization to begin a Partitioned DML transaction requires
|
360
362
|
# `spanner.databases.beginPartitionedDmlTransaction` permission
|
361
363
|
# on the `session` resource.
|
364
|
+
#
|
365
|
+
# Note: The following fields are mutually exclusive: `partitioned_dml`, `read_write`, `read_only`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
362
366
|
# @!attribute [rw] read_only
|
363
367
|
# @return [::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly]
|
364
368
|
# Transaction will not write.
|
@@ -366,6 +370,8 @@ module Google
|
|
366
370
|
# Authorization to begin a read-only transaction requires
|
367
371
|
# `spanner.databases.beginReadOnlyTransaction` permission
|
368
372
|
# on the `session` resource.
|
373
|
+
#
|
374
|
+
# Note: The following fields are mutually exclusive: `read_only`, `read_write`, `partitioned_dml`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
369
375
|
# @!attribute [rw] exclude_txn_from_change_streams
|
370
376
|
# @return [::Boolean]
|
371
377
|
# When `exclude_txn_from_change_streams` is set to `true`:
|
@@ -435,6 +441,8 @@ module Google
|
|
435
441
|
# @return [::Boolean]
|
436
442
|
# Read at a timestamp where all previously committed transactions
|
437
443
|
# are visible.
|
444
|
+
#
|
445
|
+
# Note: The following fields are mutually exclusive: `strong`, `min_read_timestamp`, `max_staleness`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
438
446
|
# @!attribute [rw] min_read_timestamp
|
439
447
|
# @return [::Google::Protobuf::Timestamp]
|
440
448
|
# Executes all reads at a timestamp >= `min_read_timestamp`.
|
@@ -447,6 +455,8 @@ module Google
|
|
447
455
|
#
|
448
456
|
# A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
|
449
457
|
# Example: `"2014-10-02T15:01:23.045123456Z"`.
|
458
|
+
#
|
459
|
+
# Note: The following fields are mutually exclusive: `min_read_timestamp`, `strong`, `max_staleness`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
450
460
|
# @!attribute [rw] max_staleness
|
451
461
|
# @return [::Google::Protobuf::Duration]
|
452
462
|
# Read data at a timestamp >= `NOW - max_staleness`
|
@@ -462,6 +472,8 @@ module Google
|
|
462
472
|
#
|
463
473
|
# Note that this option can only be used in single-use
|
464
474
|
# transactions.
|
475
|
+
#
|
476
|
+
# Note: The following fields are mutually exclusive: `max_staleness`, `strong`, `min_read_timestamp`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
465
477
|
# @!attribute [rw] read_timestamp
|
466
478
|
# @return [::Google::Protobuf::Timestamp]
|
467
479
|
# Executes all reads at the given timestamp. Unlike other modes,
|
@@ -476,6 +488,8 @@ module Google
|
|
476
488
|
#
|
477
489
|
# A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
|
478
490
|
# Example: `"2014-10-02T15:01:23.045123456Z"`.
|
491
|
+
#
|
492
|
+
# Note: The following fields are mutually exclusive: `read_timestamp`, `strong`, `min_read_timestamp`, `max_staleness`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
479
493
|
# @!attribute [rw] exact_staleness
|
480
494
|
# @return [::Google::Protobuf::Duration]
|
481
495
|
# Executes all reads at a timestamp that is `exact_staleness`
|
@@ -489,6 +503,8 @@ module Google
|
|
489
503
|
#
|
490
504
|
# Useful for reading at nearby replicas without the distributed
|
491
505
|
# timestamp negotiation overhead of `max_staleness`.
|
506
|
+
#
|
507
|
+
# Note: The following fields are mutually exclusive: `exact_staleness`, `strong`, `min_read_timestamp`, `max_staleness`, `read_timestamp`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
492
508
|
# @!attribute [rw] return_read_timestamp
|
493
509
|
# @return [::Boolean]
|
494
510
|
# If true, the Cloud Spanner-selected read timestamp is included in
|
@@ -546,15 +562,21 @@ module Google
|
|
546
562
|
# Execute the read or SQL query in a temporary transaction.
|
547
563
|
# This is the most efficient way to execute a transaction that
|
548
564
|
# consists of a single SQL query.
|
565
|
+
#
|
566
|
+
# Note: The following fields are mutually exclusive: `single_use`, `id`, `begin`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
549
567
|
# @!attribute [rw] id
|
550
568
|
# @return [::String]
|
551
569
|
# Execute the read or SQL query in a previously-started transaction.
|
570
|
+
#
|
571
|
+
# Note: The following fields are mutually exclusive: `id`, `single_use`, `begin`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
552
572
|
# @!attribute [rw] begin
|
553
573
|
# @return [::Google::Cloud::Spanner::V1::TransactionOptions]
|
554
574
|
# Begin a new transaction and execute this read or SQL query in
|
555
575
|
# it. The transaction ID of the new transaction is returned in
|
556
576
|
# {::Google::Cloud::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata.transaction},
|
557
577
|
# which is a {::Google::Cloud::Spanner::V1::Transaction Transaction}.
|
578
|
+
#
|
579
|
+
# Note: The following fields are mutually exclusive: `begin`, `single_use`, `id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
558
580
|
class TransactionSelector
|
559
581
|
include ::Google::Protobuf::MessageExts
|
560
582
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -179,6 +179,10 @@ module Google
|
|
179
179
|
# For example, `P1Y2M3DT4H5M6.5S` represents time duration of 1 year, 2
|
180
180
|
# months, 3 days, 4 hours, 5 minutes, and 6.5 seconds.
|
181
181
|
INTERVAL = 16
|
182
|
+
|
183
|
+
# Encoded as `string`, in lower-case hexa-decimal format, as described
|
184
|
+
# in RFC 9562, section 4.
|
185
|
+
UUID = 17
|
182
186
|
end
|
183
187
|
|
184
188
|
# `TypeAnnotationCode` is used as a part of {::Google::Cloud::Spanner::V1::Type Type} to
|
metadata
CHANGED
@@ -1,14 +1,13 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-spanner-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.6.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
|
-
autorequire:
|
9
8
|
bindir: bin
|
10
9
|
cert_chain: []
|
11
|
-
date:
|
10
|
+
date: 2025-01-29 00:00:00.000000000 Z
|
12
11
|
dependencies:
|
13
12
|
- !ruby/object:Gem::Dependency
|
14
13
|
name: gapic-common
|
@@ -16,7 +15,7 @@ dependencies:
|
|
16
15
|
requirements:
|
17
16
|
- - ">="
|
18
17
|
- !ruby/object:Gem::Version
|
19
|
-
version: 0.
|
18
|
+
version: 0.25.0
|
20
19
|
- - "<"
|
21
20
|
- !ruby/object:Gem::Version
|
22
21
|
version: 2.a
|
@@ -26,7 +25,7 @@ dependencies:
|
|
26
25
|
requirements:
|
27
26
|
- - ">="
|
28
27
|
- !ruby/object:Gem::Version
|
29
|
-
version: 0.
|
28
|
+
version: 0.25.0
|
30
29
|
- - "<"
|
31
30
|
- !ruby/object:Gem::Version
|
32
31
|
version: 2.a
|
@@ -96,7 +95,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
|
|
96
95
|
licenses:
|
97
96
|
- Apache-2.0
|
98
97
|
metadata: {}
|
99
|
-
post_install_message:
|
100
98
|
rdoc_options: []
|
101
99
|
require_paths:
|
102
100
|
- lib
|
@@ -104,15 +102,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
104
102
|
requirements:
|
105
103
|
- - ">="
|
106
104
|
- !ruby/object:Gem::Version
|
107
|
-
version: '
|
105
|
+
version: '3.0'
|
108
106
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
109
107
|
requirements:
|
110
108
|
- - ">="
|
111
109
|
- !ruby/object:Gem::Version
|
112
110
|
version: '0'
|
113
111
|
requirements: []
|
114
|
-
rubygems_version: 3.
|
115
|
-
signing_key:
|
112
|
+
rubygems_version: 3.6.2
|
116
113
|
specification_version: 4
|
117
114
|
summary: Cloud Spanner is a managed, mission-critical, globally consistent and scalable
|
118
115
|
relational database service.
|