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 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.