google-cloud-spanner-v1 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80f73bcf0c62d9e0ac8b3180009f47be2bfdd94e4bb8257c5b1d0069fe8f9b77
-  data.tar.gz: c820527330eba17eb8cb8cf57e6bd86316fd02173ef08e636afda74b8e583741
+  metadata.gz: 506e5f2c7f94609ad28e4a3d6d53a00ea9512e861999529e85cca4ab1d3a7fd1
+  data.tar.gz: c3998ce28c3c96271b0354c47cffd670ca43ac1193c33587a758da2593ba489a
 SHA512:
-  metadata.gz: 40aadd7fb3c257b75747a38915e60549d4a3ab7088dc7464d6a5be497bc8d38eb6bb8b5f6d2a6c6dd9201478644b25cb30709caa71507efa3cb382879f989a29
-  data.tar.gz: b4089e4023583b4d4cf99551b75056a1eb5c732c87e71506902a1355a4c4366c766aaa81c32500867075e1b128ffb02b701535ed825ad2017f3b9225688273fe
+  metadata.gz: e2e57a196955b402002d7a50965d08eb676360188d59e063b478635d2a972f458b7643f298414b135738b53fe1234307fefbb3cc091715437b81c6a68220fe93
+  data.tar.gz: 35c0bf23032ad50669c14e5035893d968d100e4e90639cf6ccd787a9647bace9513d8d6a44ec44a96b28adf4b4220ca29d1caad4f38e6f330d76b557f31282c1

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Spanner
       module V1
-        VERSION = "0.12.0"
+        VERSION = "0.13.0"
       end
     end
   end

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

@@ -16,6 +16,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       end
     end
     add_message "google.spanner.v1.TransactionOptions.ReadWrite" do
+      optional :read_lock_mode, :enum, 1, "google.spanner.v1.TransactionOptions.ReadWrite.ReadLockMode"
+    end
+    add_enum "google.spanner.v1.TransactionOptions.ReadWrite.ReadLockMode" do
+      value :READ_LOCK_MODE_UNSPECIFIED, 0
+      value :PESSIMISTIC, 1
+      value :OPTIMISTIC, 2
     end
     add_message "google.spanner.v1.TransactionOptions.PartitionedDml" do
     end
@@ -49,6 +55,7 @@ module Google
       module V1
         TransactionOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions").msgclass
         TransactionOptions::ReadWrite = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.ReadWrite").msgclass
+        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
         Transaction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Transaction").msgclass

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

@@ -50,7 +50,8 @@ module Google
         #
         #      Queries on change streams must be performed with the snapshot read-only
         #      transaction mode, specifying a strong read. Please see
-        #      {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong} for more details.
+        #      {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong}
+        #      for more details.
         #
         #   3. Partitioned DML. This type of transaction is used to execute
         #      a single Partitioned DML statement. Partitioned DML partitions
@@ -186,7 +187,8 @@ module Google
         # Queries on change streams (see below for more details) must also specify
         # the strong read timestamp bound.
         #
-        # See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong}.
+        # See
+        # {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong}.
         #
         # Exact staleness:
         #
@@ -207,7 +209,9 @@ module Google
         # equivalent boundedly stale concurrency modes. On the other hand,
         # boundedly stale reads usually return fresher results.
         #
-        # See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions.ReadOnly.read_timestamp} and
+        # See
+        # {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions.ReadOnly.read_timestamp}
+        # and
         # {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#exact_staleness TransactionOptions.ReadOnly.exact_staleness}.
         #
         # Bounded staleness:
@@ -237,7 +241,9 @@ module Google
         # which rows will be read, it can only be used with single-use
         # read-only transactions.
         #
-        # See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions.ReadOnly.max_staleness} and
+        # See
+        # {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions.ReadOnly.max_staleness}
+        # and
         # {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#min_read_timestamp TransactionOptions.ReadOnly.min_read_timestamp}.
         #
         # Old read timestamps and garbage collection:
@@ -366,9 +372,33 @@ module Google
 
           # Message type to initiate a read-write transaction. Currently this
           # transaction type has no options.
+          # @!attribute [rw] read_lock_mode
+          #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode]
+          #     Read lock mode for the transaction.
           class ReadWrite
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # `ReadLockMode` is used to set the read lock mode for read-write
+            # transactions.
+            module ReadLockMode
+              # Default value.
+              #
+              # If the value is not specified, the pessimistic read lock is used.
+              READ_LOCK_MODE_UNSPECIFIED = 0
+
+              # Pessimistic lock mode.
+              #
+              # Read locks are acquired immediately on read.
+              PESSIMISTIC = 1
+
+              # Optimistic lock mode.
+              #
+              # 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.
+              OPTIMISTIC = 2
+            end
           end
 
           # Message type to initiate a Partitioned DML transaction.
@@ -439,7 +469,8 @@ module Google
           # @!attribute [rw] return_read_timestamp
           #   @return [::Boolean]
           #     If true, the Cloud Spanner-selected read timestamp is included in
-          #     the {::Google::Cloud::Spanner::V1::Transaction Transaction} message that describes the transaction.
+          #     the {::Google::Cloud::Spanner::V1::Transaction Transaction} message that describes
+          #     the transaction.
           class ReadOnly
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -474,7 +505,8 @@ module Google
         # {::Google::Cloud::Spanner::V1::Spanner::Client#read Read} or
         # {::Google::Cloud::Spanner::V1::Spanner::Client#execute_sql ExecuteSql} call runs.
         #
-        # See {::Google::Cloud::Spanner::V1::TransactionOptions TransactionOptions} for more information about transactions.
+        # See {::Google::Cloud::Spanner::V1::TransactionOptions TransactionOptions} for more
+        # information about transactions.
         # @!attribute [rw] single_use
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions]
         #     Execute the read or SQL query in a temporary transaction.
@@ -487,7 +519,8 @@ module Google
         #   @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}.
+        #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata.transaction},
+        #     which is a {::Google::Cloud::Spanner::V1::Transaction Transaction}.
         class TransactionSelector
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-v1
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-18 00:00:00.000000000 Z
+date: 2022-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common