RubyGems - google-cloud-spanner-v1 - Versions diffs - 1.5.0 → 1.7.0 - Mend

google-cloud-spanner-v1 1.5.0 → 1.7.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.

Files changed (14) hide show

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/result_set_pb.rb +1 -1
data/lib/google/spanner/v1/transaction_pb.rb +2 -1
data/proto_docs/google/api/client.rb +14 -0
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 +58 -47
data/proto_docs/google/spanner/v1/spanner.rb +8 -0
data/proto_docs/google/spanner/v1/transaction.rb +70 -1
metadata +6 -9

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30491544a9cee28d7b28d3ddc25097db8bb8289cb9b2c1b19e333ac3f9c1a3b3
-  data.tar.gz: 07632e9e7590d1dff77707dac90aba899c80476684346df58b5382983fbe6fda
+  metadata.gz: f1667e8dd7541d5f00dbd8ec7ffce37dab1a398d914a19c04f4005ec53206bbd
+  data.tar.gz: a6f63d4162d5e539ad5ba4bd6bf0075c2e7b8d27b14090a41c2a6a6882246660
 SHA512:
-  metadata.gz: 871fc2729d63b8df0b4166735de5ec86e73a715b4bbfa437f85f1d75173788a560a4628a6b27f7692c753b306c1adacaa3d5b9e585adcd725c7012a73eb2fb6d
-  data.tar.gz: 5bf61407575d29405288136ea494d7d00baff111d9210fc22c0d2f935e8f54793818255c17cf3659b458acde56da5df72d9530094f15065a4f42d5cac034e694
+  metadata.gz: bb1658b52163c6e7cfcd933d2edea3e9052a49f44b401d4750a9968be5701bcee94e1439edb8ae6e3abe42ba697c5a4788c16184ff7bdd917e1d5e52bede6db1
+  data.tar.gz: 7b3060171334a765b030e17363576eabc013f6e0fbfeb1290c5aeb471dd7dad760a7a122d63ad27c7f7dd76e7b4d5c35d87fe442e60dc526383894601f38f6bd

data/README.md CHANGED Viewed

@@ -85,7 +85,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
 ## Supported Ruby Versions
-This library is supported on Ruby 2.7+.
+This library is supported on Ruby 3.0+.
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or

data/lib/google/cloud/spanner/v1/spanner/client.rb CHANGED Viewed

@@ -1707,6 +1707,8 @@ module Google
             #     Required. The session in which the transaction to be committed is running.
             #   @param transaction_id [::String]
             #     Commit a previously-started transaction.
+            #
+            #     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.
             #   @param single_use_transaction [::Google::Cloud::Spanner::V1::TransactionOptions, ::Hash]
             #     Execute mutations in a temporary transaction. Note that unlike
             #     commit of a previously-started transaction, commit with a
@@ -1717,6 +1719,8 @@ module Google
             #     executed more than once. If this is undesirable, use
             #     {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction} and
             #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} instead.
+            #
+            #     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.
             #   @param mutations [::Array<::Google::Cloud::Spanner::V1::Mutation, ::Hash>]
             #     The mutations to be executed when this transaction commits. All
             #     mutations are applied atomically, in the order they appear in
@@ -2326,6 +2330,13 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
+            #
+            #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+            #   external source for authentication to Google Cloud, you must validate it before
+            #   providing it to a Google API client library. Providing an unvalidated credential
+            #   configuration to Google APIs can compromise the security of your systems and data.
+            #   For more information, refer to [Validate credential configurations from external
+            #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
             #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes

data/lib/google/cloud/spanner/v1/version.rb CHANGED Viewed

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Spanner
       module V1
-        VERSION = "1.5.0"
+        VERSION = "1.7.0"
       end
     end
   end

data/lib/google/spanner/v1/result_set_pb.rb CHANGED Viewed

@@ -11,7 +11,7 @@ require 'google/spanner/v1/transaction_pb'
 require 'google/spanner/v1/type_pb'
-descriptor_data = "\n\"google/spanner/v1/result_set.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\"google/spanner/v1/query_plan.proto\x1a#google/spanner/v1/transaction.proto\x1a\x1cgoogle/spanner/v1/type.proto\"\xf2\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats\x12Q\n\x0fprecommit_token\x18\x05 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitTokenB\x03\xe0\x41\x01\"\xa4\x02\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats\x12Q\n\x0fprecommit_token\x18\x08 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitTokenB\x03\xe0\x41\x01\"\xb7\x01\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction\x12<\n\x15undeclared_parameters\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\xb4\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z5cloud.google.com/go/spanner/apiv1/spannerpb;spannerpb\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3"
+descriptor_data = "\n\"google/spanner/v1/result_set.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\"google/spanner/v1/query_plan.proto\x1a#google/spanner/v1/transaction.proto\x1a\x1cgoogle/spanner/v1/type.proto\"\xf2\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats\x12Q\n\x0fprecommit_token\x18\x05 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitTokenB\x03\xe0\x41\x01\"\xb7\x02\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats\x12Q\n\x0fprecommit_token\x18\x08 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitTokenB\x03\xe0\x41\x01\x12\x11\n\x04last\x18\t \x01(\x08\x42\x03\xe0\x41\x01\"\xb7\x01\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction\x12<\n\x15undeclared_parameters\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\xb1\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\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"
 pool = Google::Protobuf::DescriptorPool.generated_pool

data/lib/google/spanner/v1/transaction_pb.rb CHANGED Viewed

@@ -9,7 +9,7 @@ require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
-descriptor_data = "\n#google/spanner/v1/transaction.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xce\x06\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x12\'\n\x1f\x65xclude_txn_from_change_streams\x18\x05 \x01(\x08\x1a\xec\x01\n\tReadWrite\x12T\n\x0eread_lock_mode\x18\x01 \x01(\x0e\x32<.google.spanner.v1.TransactionOptions.ReadWrite.ReadLockMode\x12\x38\n+multiplexed_session_previous_transaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x01\"O\n\x0cReadLockMode\x12\x1e\n\x1aREAD_LOCK_MODE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bPESSIMISTIC\x10\x01\x12\x0e\n\nOPTIMISTIC\x10\x02\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode\"\x9b\x01\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12L\n\x0fprecommit_token\x18\x03 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitToken\"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selector\"L\n MultiplexedSessionPrecommitToken\x12\x17\n\x0fprecommit_token\x18\x01 \x01(\x0c\x12\x0f\n\x07seq_num\x18\x02 \x01(\x05\x42\xb3\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\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"
+descriptor_data = "\n#google/spanner/v1/transaction.proto\x12\x11google.spanner.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xf7\x07\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x12\'\n\x1f\x65xclude_txn_from_change_streams\x18\x05 \x01(\x08\x12M\n\x0fisolation_level\x18\x06 \x01(\x0e\x32\x34.google.spanner.v1.TransactionOptions.IsolationLevel\x1a\xec\x01\n\tReadWrite\x12T\n\x0eread_lock_mode\x18\x01 \x01(\x0e\x32<.google.spanner.v1.TransactionOptions.ReadWrite.ReadLockMode\x12\x38\n+multiplexed_session_previous_transaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x01\"O\n\x0cReadLockMode\x12\x1e\n\x1aREAD_LOCK_MODE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bPESSIMISTIC\x10\x01\x12\x0e\n\nOPTIMISTIC\x10\x02\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_bound\"X\n\x0eIsolationLevel\x12\x1f\n\x1bISOLATION_LEVEL_UNSPECIFIED\x10\x00\x12\x10\n\x0cSERIALIZABLE\x10\x01\x12\x13\n\x0fREPEATABLE_READ\x10\x02\x42\x06\n\x04mode\"\x9b\x01\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12L\n\x0fprecommit_token\x18\x03 \x01(\x0b\x32\x33.google.spanner.v1.MultiplexedSessionPrecommitToken\"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selector\"L\n MultiplexedSessionPrecommitToken\x12\x17\n\x0fprecommit_token\x18\x01 \x01(\x0c\x12\x0f\n\x07seq_num\x18\x02 \x01(\x05\x42\xb3\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\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"
 pool = Google::Protobuf::DescriptorPool.generated_pool
@@ -46,6 +46,7 @@ module Google
         TransactionOptions::ReadWrite::ReadLockMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.ReadWrite.ReadLockMode").enummodule
         TransactionOptions::PartitionedDml = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.PartitionedDml").msgclass
         TransactionOptions::ReadOnly = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.ReadOnly").msgclass
+        TransactionOptions::IsolationLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.IsolationLevel").enummodule
         Transaction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Transaction").msgclass
         TransactionSelector = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionSelector").msgclass
         MultiplexedSessionPrecommitToken = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.MultiplexedSessionPrecommitToken").msgclass

data/proto_docs/google/api/client.rb CHANGED Viewed

@@ -221,6 +221,12 @@ module Google
       #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
       #     enabled by default 1 month after launching the feature in preview
       #     packages.
+      # @!attribute [rw] unversioned_package_disabled
+      #   @return [::Boolean]
+      #     Disables generation of an unversioned Python package for this client
+      #     library. This means that the module names will need to be versioned in
+      #     import statements. For example `import google.cloud.library_v2` instead
+      #     of `import google.cloud.library`.
       class ExperimentalFeatures
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -409,6 +415,14 @@ module Google
     #   @return [::Array<::String>]
     #     An allowlist of the fully qualified names of RPCs that should be included
     #     on public client surfaces.
+    # @!attribute [rw] generate_omitted_as_internal
+    #   @return [::Boolean]
+    #     Setting this to true indicates to the client generators that methods
+    #     that would be excluded from the generation should instead be generated
+    #     in a way that indicates these methods should not be consumed by
+    #     end users. How this is expressed is up to individual language
+    #     implementations to decide. Some examples may be: added annotations,
+    #     obfuscated identifiers, or other language idiomatic patterns.
     class SelectiveGapicGeneration
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/struct.rb CHANGED Viewed

@@ -53,21 +53,33 @@ module Google
     # @!attribute [rw] null_value
     #   @return [::Google::Protobuf::NullValue]
     #     Represents a null value.
+    #
+    #     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.
     # @!attribute [rw] number_value
     #   @return [::Float]
     #     Represents a double value.
+    #
+    #     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.
     # @!attribute [rw] string_value
     #   @return [::String]
     #     Represents a string value.
+    #
+    #     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.
     # @!attribute [rw] bool_value
     #   @return [::Boolean]
     #     Represents a boolean value.
+    #
+    #     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.
     # @!attribute [rw] struct_value
     #   @return [::Google::Protobuf::Struct]
     #     Represents a structured value.
+    #
+    #     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.
     # @!attribute [rw] list_value
     #   @return [::Google::Protobuf::ListValue]
     #     Represents a repeated `Value`.
+    #
+    #     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.
     class Value
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/v1/keys.rb CHANGED Viewed

@@ -113,18 +113,26 @@ module Google
         #   @return [::Google::Protobuf::ListValue]
         #     If the start is closed, then the range includes all rows whose
         #     first `len(start_closed)` key columns exactly match `start_closed`.
+        #
+        #     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.
         # @!attribute [rw] start_open
         #   @return [::Google::Protobuf::ListValue]
         #     If the start is open, then the range excludes rows whose first
         #     `len(start_open)` key columns exactly match `start_open`.
+        #
+        #     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.
         # @!attribute [rw] end_closed
         #   @return [::Google::Protobuf::ListValue]
         #     If the end is closed, then the range includes all rows whose
         #     first `len(end_closed)` key columns exactly match `end_closed`.
+        #
+        #     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.
         # @!attribute [rw] end_open
         #   @return [::Google::Protobuf::ListValue]
         #     If the end is open, then the range excludes rows whose first
         #     `len(end_open)` key columns exactly match `end_open`.
+        #
+        #     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.
         class KeyRange
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/v1/mutation.rb CHANGED Viewed

@@ -28,10 +28,14 @@ module Google
         #   @return [::Google::Cloud::Spanner::V1::Mutation::Write]
         #     Insert new rows in a table. If any of the rows already exist,
         #     the write or transaction fails with error `ALREADY_EXISTS`.
+        #
+        #     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.
         # @!attribute [rw] update
         #   @return [::Google::Cloud::Spanner::V1::Mutation::Write]
         #     Update existing rows in a table. If any of the rows does not
         #     already exist, the transaction fails with error `NOT_FOUND`.
+        #
+        #     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.
         # @!attribute [rw] insert_or_update
         #   @return [::Google::Cloud::Spanner::V1::Mutation::Write]
         #     Like {::Google::Cloud::Spanner::V1::Mutation#insert insert}, except that if the row already exists, then
@@ -41,6 +45,8 @@ module Google
         #     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
         #     NULL` columns in the table must be given a value. This holds true
         #     even when the row already exists and will therefore actually be updated.
+        #
+        #     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.
         # @!attribute [rw] replace
         #   @return [::Google::Cloud::Spanner::V1::Mutation::Write]
         #     Like {::Google::Cloud::Spanner::V1::Mutation#insert insert}, except that if the row already exists, it is
@@ -52,10 +58,14 @@ module Google
         #     `ON DELETE CASCADE` annotation, then replacing a parent row
         #     also deletes the child rows. Otherwise, you must delete the
         #     child rows before you replace the parent row.
+        #
+        #     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.
         # @!attribute [rw] delete
         #   @return [::Google::Cloud::Spanner::V1::Mutation::Delete]
         #     Delete rows from a table. Succeeds whether or not the named
         #     rows were present.
+        #
+        #     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.
         class Mutation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/v1/result_set.rb CHANGED Viewed

@@ -29,11 +29,10 @@ module Google
         # @!attribute [rw] rows
         #   @return [::Array<::Google::Protobuf::ListValue>]
         #     Each element in `rows` is a row whose format is defined by
-        #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#row_type metadata.row_type}. The ith element
-        #     in each row matches the ith field in
-        #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#row_type metadata.row_type}. Elements are
-        #     encoded based on type as described
-        #     {::Google::Cloud::Spanner::V1::TypeCode here}.
+        #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#row_type metadata.row_type}. The ith
+        #     element in each row matches the ith field in
+        #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#row_type metadata.row_type}. Elements
+        #     are encoded based on type as described {::Google::Cloud::Spanner::V1::TypeCode here}.
         # @!attribute [rw] stats
         #   @return [::Google::Cloud::Spanner::V1::ResultSetStats]
         #     Query plan and execution statistics for the SQL statement that
@@ -41,18 +40,16 @@ module Google
         #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode}.
         #     DML statements always produce stats containing the number of rows
         #     modified, unless executed using the
-        #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest::QueryMode::PLAN ExecuteSqlRequest.QueryMode.PLAN} {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode}.
-        #     Other fields may or may not be populated, based on the
+        #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest::QueryMode::PLAN ExecuteSqlRequest.QueryMode.PLAN}
+        #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode}.
+        #     Other fields might or might not be populated, based on the
         #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode}.
         # @!attribute [rw] precommit_token
         #   @return [::Google::Cloud::Spanner::V1::MultiplexedSessionPrecommitToken]
-        #     Optional. A precommit token will be included if the read-write transaction
-        #     is on a multiplexed session.
-        #     The precommit token with the highest sequence number from this transaction
-        #     attempt should be passed to the
+        #     Optional. A precommit token is included if the read-write transaction is on
+        #     a multiplexed session. Pass the precommit token with the highest sequence
+        #     number from this transaction attempt to the
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} request for this transaction.
-        #     This feature is not yet supported and will result in an UNIMPLEMENTED
-        #     error.
         class ResultSet
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -76,13 +73,14 @@ module Google
         #     Most values are encoded based on type as described
         #     {::Google::Cloud::Spanner::V1::TypeCode here}.
         #
-        #     It is possible that the last value in values is "chunked",
+        #     It's possible that the last value in values is "chunked",
         #     meaning that the rest of the value is sent in subsequent
-        #     `PartialResultSet`(s). This is denoted by the {::Google::Cloud::Spanner::V1::PartialResultSet#chunked_value chunked_value}
-        #     field. Two or more chunked values can be merged to form a
-        #     complete value as follows:
+        #     `PartialResultSet`(s). This is denoted by the
+        #     {::Google::Cloud::Spanner::V1::PartialResultSet#chunked_value chunked_value} field.
+        #     Two or more chunked values can be merged to form a complete value as
+        #     follows:
         #
-        #       * `bool/number/null`: cannot be chunked
+        #       * `bool/number/null`: can't be chunked
         #       * `string`: concatenate the strings
         #       * `list`: concatenate the lists. If the last element in a list is a
         #         `string`, `list`, or `object`, merge it with the first element in
@@ -93,28 +91,28 @@ module Google
         #
         #     Some examples of merging:
         #
-        #         # Strings are concatenated.
+        #         Strings are concatenated.
         #         "foo", "bar" => "foobar"
         #
-        #         # Lists of non-strings are concatenated.
+        #         Lists of non-strings are concatenated.
         #         [2, 3], [4] => [2, 3, 4]
         #
-        #         # Lists are concatenated, but the last and first elements are merged
-        #         # because they are strings.
+        #         Lists are concatenated, but the last and first elements are merged
+        #         because they are strings.
         #         ["a", "b"], ["c", "d"] => ["a", "bc", "d"]
         #
-        #         # Lists are concatenated, but the last and first elements are merged
-        #         # because they are lists. Recursively, the last and first elements
-        #         # of the inner lists are merged because they are strings.
+        #         Lists are concatenated, but the last and first elements are merged
+        #         because they are lists. Recursively, the last and first elements
+        #         of the inner lists are merged because they are strings.
         #         ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]
         #
-        #         # Non-overlapping object fields are combined.
+        #         Non-overlapping object fields are combined.
         #         {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}
         #
-        #         # Overlapping object fields are merged.
+        #         Overlapping object fields are merged.
         #         {"a": "1"}, {"a": "2"} => {"a": "12"}
         #
-        #         # Examples of merging objects containing lists of strings.
+        #         Examples of merging objects containing lists of strings.
         #         {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}
         #
         #     For a more complete example, suppose a streaming SQL query is
@@ -130,7 +128,6 @@ module Google
         #         {
         #           "values": ["orl"]
         #           "chunked_value": true
-        #           "resume_token": "Bqp2..."
         #         }
         #         {
         #           "values": ["d"]
@@ -140,11 +137,17 @@ module Google
         #     This sequence of `PartialResultSet`s encodes two rows, one
         #     containing the field value `"Hello"`, and a second containing the
         #     field value `"World" = "W" + "orl" + "d"`.
+        #
+        #     Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
+        #     resumed from a previously yielded `resume_token`. For the above sequence of
+        #     `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
+        #     yields results from the `PartialResultSet` with value "orl".
         # @!attribute [rw] chunked_value
         #   @return [::Boolean]
-        #     If true, then the final value in {::Google::Cloud::Spanner::V1::PartialResultSet#values values} is chunked, and must
-        #     be combined with more values from subsequent `PartialResultSet`s
-        #     to obtain a complete field value.
+        #     If true, then the final value in
+        #     {::Google::Cloud::Spanner::V1::PartialResultSet#values values} is chunked, and must be
+        #     combined with more values from subsequent `PartialResultSet`s to obtain a
+        #     complete field value.
         # @!attribute [rw] resume_token
         #   @return [::String]
         #     Streaming calls might be interrupted for a variety of reasons, such
@@ -156,29 +159,31 @@ module Google
         #   @return [::Google::Cloud::Spanner::V1::ResultSetStats]
         #     Query plan and execution statistics for the statement that produced this
         #     streaming result set. These can be requested by setting
-        #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode} and are sent
-        #     only once with the last response in the stream.
-        #     This field will also be present in the last response for DML
-        #     statements.
+        #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest.query_mode}
+        #     and are sent only once with the last response in the stream. This field is
+        #     also present in the last response for DML statements.
         # @!attribute [rw] precommit_token
         #   @return [::Google::Cloud::Spanner::V1::MultiplexedSessionPrecommitToken]
-        #     Optional. A precommit token will be included if the read-write transaction
-        #     is on a multiplexed session.
-        #     The precommit token with the highest sequence number from this transaction
-        #     attempt should be passed to the
+        #     Optional. A precommit token is included if the read-write transaction
+        #     has multiplexed sessions enabled. Pass the precommit token with the highest
+        #     sequence number from this transaction attempt to the
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} request for this transaction.
-        #     This feature is not yet supported and will result in an UNIMPLEMENTED
-        #     error.
+        # @!attribute [rw] last
+        #   @return [::Boolean]
+        #     Optional. Indicates whether this is the last `PartialResultSet` in the
+        #     stream. The server might optionally set this field. Clients shouldn't rely
+        #     on this field being set in all cases.
         class PartialResultSet
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
-        # Metadata about a {::Google::Cloud::Spanner::V1::ResultSet ResultSet} or {::Google::Cloud::Spanner::V1::PartialResultSet PartialResultSet}.
+        # Metadata about a {::Google::Cloud::Spanner::V1::ResultSet ResultSet} or
+        # {::Google::Cloud::Spanner::V1::PartialResultSet PartialResultSet}.
         # @!attribute [rw] row_type
         #   @return [::Google::Cloud::Spanner::V1::StructType]
         #     Indicates the field names and types for the rows in the result
-        #     set.  For example, a SQL query like `"SELECT UserId, UserName FROM
+        #     set. For example, a SQL query like `"SELECT UserId, UserName FROM
         #     Users"` could return a `row_type` value like:
         #
         #         "fields": [
@@ -206,10 +211,12 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
-        # Additional statistics about a {::Google::Cloud::Spanner::V1::ResultSet ResultSet} or {::Google::Cloud::Spanner::V1::PartialResultSet PartialResultSet}.
+        # Additional statistics about a {::Google::Cloud::Spanner::V1::ResultSet ResultSet} or
+        # {::Google::Cloud::Spanner::V1::PartialResultSet PartialResultSet}.
         # @!attribute [rw] query_plan
         #   @return [::Google::Cloud::Spanner::V1::QueryPlan]
-        #     {::Google::Cloud::Spanner::V1::QueryPlan QueryPlan} for the query associated with this result.
+        #     {::Google::Cloud::Spanner::V1::QueryPlan QueryPlan} for the query associated with this
+        #     result.
         # @!attribute [rw] query_stats
         #   @return [::Google::Protobuf::Struct]
         #     Aggregated statistics from the execution of the query. Only present when
@@ -224,10 +231,14 @@ module Google
         # @!attribute [rw] row_count_exact
         #   @return [::Integer]
         #     Standard DML returns an exact count of rows that were modified.
+        #
+        #     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.
         # @!attribute [rw] row_count_lower_bound
         #   @return [::Integer]
-        #     Partitioned DML does not offer exactly-once semantics, so it
+        #     Partitioned DML doesn't offer exactly-once semantics, so it
         #     returns a lower bound of the rows modified.
+        #
+        #     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.
         class ResultSetStats
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/v1/spanner.rb CHANGED Viewed

@@ -251,11 +251,15 @@ module Google
         #     true and all replicas are exhausted without finding a healthy replica,
         #     Spanner will wait for a replica in the list to become available, requests
         #     may fail due to `DEADLINE_EXCEEDED` errors.
+        #
+        #     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.
         # @!attribute [rw] exclude_replicas
         #   @return [::Google::Cloud::Spanner::V1::DirectedReadOptions::ExcludeReplicas]
         #     Exclude_replicas indicates that specified replicas should be excluded
         #     from serving requests. Spanner will not route requests to the replicas
         #     in this list.
+        #
+        #     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.
         class DirectedReadOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1029,6 +1033,8 @@ module Google
         # @!attribute [rw] transaction_id
         #   @return [::String]
         #     Commit a previously-started transaction.
+        #
+        #     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.
         # @!attribute [rw] single_use_transaction
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions]
         #     Execute mutations in a temporary transaction. Note that unlike
@@ -1040,6 +1046,8 @@ module Google
         #     executed more than once. If this is undesirable, use
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction} and
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} instead.
+        #
+        #     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.
         # @!attribute [rw] mutations
         #   @return [::Array<::Google::Cloud::Spanner::V1::Mutation>]
         #     The mutations to be executed when this transaction commits. All

data/proto_docs/google/spanner/v1/transaction.rb CHANGED Viewed

@@ -352,6 +352,8 @@ module Google
         #     Authorization to begin a read-write transaction requires
         #     `spanner.databases.beginOrRollbackReadWriteTransaction` permission
         #     on the `session` resource.
+        #
+        #     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.
         # @!attribute [rw] partitioned_dml
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::PartitionedDml]
         #     Partitioned DML transaction.
@@ -359,6 +361,8 @@ module Google
         #     Authorization to begin a Partitioned DML transaction requires
         #     `spanner.databases.beginPartitionedDmlTransaction` permission
         #     on the `session` resource.
+        #
+        #     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.
         # @!attribute [rw] read_only
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly]
         #     Transaction will not write.
@@ -366,6 +370,8 @@ module Google
         #     Authorization to begin a read-only transaction requires
         #     `spanner.databases.beginReadOnlyTransaction` permission
         #     on the `session` resource.
+        #
+        #     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.
         # @!attribute [rw] exclude_txn_from_change_streams
         #   @return [::Boolean]
         #     When `exclude_txn_from_change_streams` is set to `true`:
@@ -382,6 +388,9 @@ module Google
         #     `exclude_txn_from_change_streams` may only be specified for read-write or
         #     partitioned-dml transactions, otherwise the API will return an
         #     `INVALID_ARGUMENT` error.
+        # @!attribute [rw] isolation_level
+        #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel]
+        #     Isolation level for the transaction.
         class TransactionOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -407,12 +416,23 @@ module Google
             module ReadLockMode
               # Default value.
               #
-              # If the value is not specified, the pessimistic read lock is used.
+              # * If isolation level is `REPEATABLE_READ`, then it is an error to
+              #   specify `read_lock_mode`. Locking semantics default to `OPTIMISTIC`.
+              #   No validation checks are done for reads, except for:
+              #     1. reads done as part of queries that use `SELECT FOR UPDATE`
+              #     2. reads done as part of statements with a `LOCK_SCANNED_RANGES`
+              #        hint
+              #     3. reads done as part of DML statements
+              #   to validate that the data that was served at the snapshot time is
+              #   unchanged at commit time.
+              # * At all other isolation levels, if `read_lock_mode` is the default
+              #   value, then pessimistic read lock is used.
               READ_LOCK_MODE_UNSPECIFIED = 0
               # Pessimistic lock mode.
               #
               # Read locks are acquired immediately on read.
+              # Semantics described only applies to `SERIALIZABLE` isolation.
               PESSIMISTIC = 1
               # Optimistic lock mode.
@@ -420,6 +440,7 @@ module Google
               # Locks for reads within the transaction are not acquired on read.
               # Instead the locks are acquired on a commit to validate that
               # read/queried data has not changed since the transaction started.
+              # Semantics described only applies to `SERIALIZABLE` isolation.
               OPTIMISTIC = 2
             end
           end
@@ -435,6 +456,8 @@ module Google
           #   @return [::Boolean]
           #     Read at a timestamp where all previously committed transactions
           #     are visible.
+          #
+          #     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.
           # @!attribute [rw] min_read_timestamp
           #   @return [::Google::Protobuf::Timestamp]
           #     Executes all reads at a timestamp >= `min_read_timestamp`.
@@ -447,6 +470,8 @@ module Google
           #
           #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
           #     Example: `"2014-10-02T15:01:23.045123456Z"`.
+          #
+          #     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.
           # @!attribute [rw] max_staleness
           #   @return [::Google::Protobuf::Duration]
           #     Read data at a timestamp >= `NOW - max_staleness`
@@ -462,6 +487,8 @@ module Google
           #
           #     Note that this option can only be used in single-use
           #     transactions.
+          #
+          #     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.
           # @!attribute [rw] read_timestamp
           #   @return [::Google::Protobuf::Timestamp]
           #     Executes all reads at the given timestamp. Unlike other modes,
@@ -476,6 +503,8 @@ module Google
           #
           #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
           #     Example: `"2014-10-02T15:01:23.045123456Z"`.
+          #
+          #     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.
           # @!attribute [rw] exact_staleness
           #   @return [::Google::Protobuf::Duration]
           #     Executes all reads at a timestamp that is `exact_staleness`
@@ -489,6 +518,8 @@ module Google
           #
           #     Useful for reading at nearby replicas without the distributed
           #     timestamp negotiation overhead of `max_staleness`.
+          #
+          #     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.
           # @!attribute [rw] return_read_timestamp
           #   @return [::Boolean]
           #     If true, the Cloud Spanner-selected read timestamp is included in
@@ -498,6 +529,38 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+          # `IsolationLevel` is used when setting `isolation_level` for a transaction.
+          module IsolationLevel
+            # Default value.
+            #
+            # If the value is not specified, the `SERIALIZABLE` isolation level is
+            # used.
+            ISOLATION_LEVEL_UNSPECIFIED = 0
+            # All transactions appear as if they executed in a serial order, even if
+            # some of the reads, writes, and other operations of distinct transactions
+            # actually occurred in parallel. Spanner assigns commit timestamps that
+            # reflect the order of committed transactions to implement this property.
+            # Spanner offers a stronger guarantee than serializability called external
+            # consistency. For further details, please refer to
+            # https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability.
+            SERIALIZABLE = 1
+            # All reads performed during the transaction observe a consistent snapshot
+            # of the database, and the transaction will only successfully commit in the
+            # absence of conflicts between its updates and any concurrent updates that
+            # have occurred since that snapshot. Consequently, in contrast to
+            # `SERIALIZABLE` transactions, only write-write conflicts are detected in
+            # snapshot transactions.
+            #
+            # This isolation level does not support Read-only and Partitioned DML
+            # transactions.
+            #
+            # When `REPEATABLE_READ` is specified on a read-write transaction, the
+            # locking semantics default to `OPTIMISTIC`.
+            REPEATABLE_READ = 2
+          end
         end
         # A transaction.
@@ -546,15 +609,21 @@ module Google
         #     Execute the read or SQL query in a temporary transaction.
         #     This is the most efficient way to execute a transaction that
         #     consists of a single SQL query.
+        #
+        #     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.
         # @!attribute [rw] id
         #   @return [::String]
         #     Execute the read or SQL query in a previously-started transaction.
+        #
+        #     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.
         # @!attribute [rw] begin
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions]
         #     Begin a new transaction and execute this read or SQL query in
         #     it. The transaction ID of the new transaction is returned in
         #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata.transaction},
         #     which is a {::Google::Cloud::Spanner::V1::Transaction Transaction}.
+        #
+        #     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.
         class TransactionSelector
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata CHANGED Viewed

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-v1
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Google LLC
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-11 00:00:00.000000000 Z
+date: 2025-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.24.0
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.24.0
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -96,7 +95,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -104,15 +102,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.5
 specification_version: 4
 summary: Cloud Spanner is a managed, mission-critical, globally consistent and scalable
   relational database service.