google-cloud-spanner-v1 1.4.0 → 1.6.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fbc12b0558397742935801d9b6e189c54ff8efbd334c65d4d4672bf3583cf043
4
- data.tar.gz: 2ed9608ca002304c2fe835a6705510c04f8b1872285be6f85156ed4cf971a461
3
+ metadata.gz: 263176d27e7a17047a1cce07d6c8d689545e041165be967c844bb4e7a0efedad
4
+ data.tar.gz: 955f9cab32b046a967e976a7fb3d9b8d85d639e83f832a4fcb4b116467afa12c
5
5
  SHA512:
6
- metadata.gz: 7d64d91e68a4af41028083a53566f4e517f62d158d176de5d579c0b296ff8f731ba421f07f236cd2e245b9a4a59f0f4f598190dadc2e53254ecc0d4f15849c3b
7
- data.tar.gz: ceb43a4790b7f0f2fc11a41f962559d98b4ca8e9814da0c141cdf5a01412fb9dfbff1938cdff3be510286e7a25e6d52d95d5b1504a89f9c934ca6e0cb378a7a4
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 2.7+.
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
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Spanner
23
23
  module V1
24
- VERSION = "1.4.0"
24
+ VERSION = "1.6.0"
25
25
  end
26
26
  end
27
27
  end
@@ -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*\xd5\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*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"
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.0
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: 2024-12-10 00:00:00.000000000 Z
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.24.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.24.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: '2.7'
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.5.23
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.