google-cloud-spanner 2.30.0 → 2.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0048ff04c4a29b66a58595d58a68c5be48f765d5aa8e0f6fd5c27b0ca7b1c088'
-  data.tar.gz: 195570ee1bc8eb9b7c33d525df148aaa1a230693ae237b82f30d7e573866c3df
+  metadata.gz: 8e4f1e2c9ad4832aa5ade2d7f086d0e9fd3f8f7c01a48147f0160ab8d4ed774a
+  data.tar.gz: a2f84a797e638ad1fb7538a861cd8b153dea2d0aaab0e6a89138c9592b37edf8
 SHA512:
-  metadata.gz: 37b100e79176dfc4fa89f80832ae04f81b7f8d027704bed6e0dcf217708fcbf7be3a2632961f55eda21fd0a4de7804eb2bd6b47172fa9901039d71d9018db99d
-  data.tar.gz: 5b308e03caf25c9b91ebb4c6433cb29a9eb4e3fe2c3fedbb81f624dc88a02858564ef2e1202ec4aca01021825db99a2fcf756ef978d6d18d23012428b568fa6b
+  metadata.gz: f5e6a8a01519dc8bf7c87d81c1fd162c5297f5067c2fc7f42904aad8f59c13c322630841d20fc5433175c8cf3d4ef7afa52e01e0bf1171c35d27984e20d75d42
+  data.tar.gz: da60a3a4874ac6a695715f567baadd09de69c8691269a9dfd7c0f5011af80ff700feef8396fc79e97c22491b307c8f7e9b37742ba8bffc04706ee5560f80bbf8

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 2.32.0 (2025-12-04)
+
+#### Features
+
+* Add support for ReadLockMode ([#171](https://github.com/googleapis/ruby-spanner/issues/171)) 
+
+### 2.31.0 (2025-12-02)
+
+#### Features
+
+* Support isolation level in Transaction Options ([#206](https://github.com/googleapis/ruby-spanner/issues/206)) 
+
 ### 2.30.0 (2025-11-17)
 
 #### Features

data/lib/google/cloud/spanner/client.rb

@@ -1067,6 +1067,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1103,6 +1105,13 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
         #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
@@ -1158,16 +1167,19 @@ module Google
         #
         def upsert table, rows,
                    exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
           @pool.with_session do |session|
             session.upsert table, rows,
                            exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                           isolation_level: isolation_level,
                            commit_options: commit_options,
                            request_options: request_options,
-                           call_options: call_options
+                           call_options: call_options,
+                           read_lock_mode: read_lock_mode
           end
         end
         alias save upsert
@@ -1214,6 +1226,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1251,6 +1265,15 @@ module Google
         #       trigger a retry.
         #
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1305,16 +1328,19 @@ module Google
         #
         def insert table, rows,
                    exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
           @pool.with_session do |session|
             session.insert table, rows,
                            exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                           isolation_level: isolation_level,
                            commit_options: commit_options,
                            request_options: request_options,
-                           call_options: call_options
+                           call_options: call_options,
+                           read_lock_mode: read_lock_mode
           end
         end
 
@@ -1360,6 +1386,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1396,6 +1424,14 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
         #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
@@ -1450,16 +1486,19 @@ module Google
         #
         def update table, rows,
                    exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
           @pool.with_session do |session|
             session.update table, rows,
                            exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                           isolation_level: isolation_level,
                            commit_options: commit_options,
                            request_options: request_options,
-                           call_options: call_options
+                           call_options: call_options,
+                           read_lock_mode: read_lock_mode
           end
         end
 
@@ -1507,6 +1546,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1543,6 +1584,14 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
         #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
@@ -1597,13 +1646,16 @@ module Google
         #
         def replace table, rows,
                     exclude_txn_from_change_streams: false,
-                    commit_options: nil, request_options: nil, call_options: nil
+                    isolation_level: nil, commit_options: nil, request_options: nil,
+                    call_options: nil, read_lock_mode: nil
           @pool.with_session do |session|
             session.replace table, rows,
                             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                            isolation_level: isolation_level,
                             commit_options: commit_options,
                             request_options: request_options,
-                            call_options: call_options
+                            call_options: call_options,
+                            read_lock_mode: read_lock_mode
           end
         end
 
@@ -1630,6 +1682,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1666,6 +1720,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1713,16 +1776,19 @@ module Google
         #
         def delete table, keys = [],
                    exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
           @pool.with_session do |session|
             session.delete table, keys,
                            exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                           isolation_level: isolation_level,
                            commit_options: commit_options,
                            request_options: request_options,
-                           call_options: call_options
+                           call_options: call_options,
+                           read_lock_mode: read_lock_mode
           end
         end
 
@@ -1744,6 +1810,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1783,6 +1851,15 @@ module Google
         # @yield [commit] The block for mutating the data.
         # @yieldparam [Google::Cloud::Spanner::Commit] commit The Commit object.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1840,8 +1917,8 @@ module Google
         #   end
         #
         def commit exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil,
-                   &block
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil, &block
           raise ArgumentError, "Must provide a block" unless block_given?
 
           request_options = Convert.to_request_options \
@@ -1850,8 +1927,12 @@ module Google
           @pool.with_session do |session|
             session.commit(
               exclude_txn_from_change_streams: exclude_txn_from_change_streams,
-              commit_options: commit_options, request_options: request_options,
-              call_options: call_options, &block
+              isolation_level: isolation_level,
+              commit_options: commit_options,
+              request_options: request_options,
+              call_options: call_options,
+              read_lock_mode: read_lock_mode,
+              &block
             )
           end
         end
@@ -2017,6 +2098,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @yield [transaction] The block for reading and writing data.
         # @yieldparam [Google::Cloud::Spanner::Transaction] transaction The
         #   Transaction object.
@@ -2119,7 +2209,7 @@ module Google
         #   end
         #
         def transaction deadline: 120, exclude_txn_from_change_streams: false,
-                        commit_options: nil, request_options: nil, call_options: nil
+                        commit_options: nil, request_options: nil, call_options: nil, read_lock_mode: nil
           ensure_service!
           unless Thread.current[IS_TRANSACTION_RUNNING_KEY].nil?
             raise "Nested transactions are not allowed"
@@ -2133,7 +2223,8 @@ module Google
             request_options, tag_type: :transaction_tag
 
           @pool.with_session do |session|
-            tx = session.create_empty_transaction exclude_txn_from_change_streams: exclude_txn_from_change_streams
+            tx = session.create_empty_transaction \
+              exclude_txn_from_change_streams: exclude_txn_from_change_streams, read_lock_mode: read_lock_mode
             if request_options
               tx.transaction_tag = request_options[:transaction_tag]
             end
@@ -2150,7 +2241,8 @@ module Google
                 tx.safe_begin_transaction!(
                   exclude_from_change_streams: exclude_txn_from_change_streams,
                   request_options: request_options,
-                  call_options: call_options
+                  call_options: call_options,
+                  read_lock_mode: read_lock_mode
                 )
               end
 
@@ -2170,7 +2262,8 @@ module Google
                   commit_options: commit_options,
                   request_options: request_options,
                   call_options: call_options,
-                  precommit_token: tx.precommit_token
+                  precommit_token: tx.precommit_token,
+                  read_lock_mode: read_lock_mode
                 )
 
                 tx.precommit_token = commit_resp.precommit_token
@@ -2191,7 +2284,8 @@ module Google
               previous_transaction_id = tx.transaction_id if tx.existing_transaction?
               tx = session.create_empty_transaction(
                 exclude_txn_from_change_streams: exclude_txn_from_change_streams,
-                previous_transaction_id: previous_transaction_id
+                previous_transaction_id: previous_transaction_id,
+                read_lock_mode: read_lock_mode
               )
               if request_options
                 tx.transaction_tag = request_options[:transaction_tag]

data/lib/google/cloud/spanner/service.rb

@@ -524,6 +524,8 @@ module Google
         # @param exclude_txn_from_change_streams [::Boolean] Optional. Defaults to `false`.
         #   When `exclude_txn_from_change_streams` is set to `true`, it prevents read
         #   or write transactions from being tracked in change streams.
+        # @param isolation_level [::Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] Optional.
+        #   The isolation level for the transaction.
         # @param commit_options [::Hash, nil]  Optional. A hash of commit options.
         #   Example option: `:return_commit_stats`.
         # @param request_options [::Hash, nil] Optional. Common request options.
@@ -537,14 +539,17 @@ module Google
         # @return [::Google::Cloud::Spanner::V1::CommitResponse]
         def commit session_name, mutations = [],
                    transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil,
-                   precommit_token: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, precommit_token: nil, read_lock_mode: nil
           route_to_leader = LARHeaders.commit
           tx_opts = nil
           if transaction_id.nil?
             tx_opts = V1::TransactionOptions.new(
-              read_write: V1::TransactionOptions::ReadWrite.new,
-              exclude_txn_from_change_streams: exclude_txn_from_change_streams
+              read_write: V1::TransactionOptions::ReadWrite.new(
+                read_lock_mode: read_lock_mode
+              ),
+              exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+              isolation_level: isolation_level
             )
           end
           opts = default_options session_name: session_name,
@@ -637,7 +642,8 @@ module Google
                               call_options: nil,
                               route_to_leader: nil,
                               mutation_key: nil,
-                              previous_transaction_id: nil
+                              previous_transaction_id: nil,
+                              read_lock_mode: nil
           read_write = if previous_transaction_id.nil?
                          V1::TransactionOptions::ReadWrite.new
                        else
@@ -646,6 +652,10 @@ module Google
                          )
                        end
 
+          unless read_lock_mode.nil?
+            read_write.read_lock_mode = read_lock_mode
+          end
+
           tx_opts = V1::TransactionOptions.new(
             read_write: read_write,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams

data/lib/google/cloud/spanner/session.rb

@@ -603,6 +603,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -646,6 +648,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @yield [commit] The block for mutating the data.
         # @yieldparam [Google::Cloud::Spanner::Commit] commit The Commit object.
         #
@@ -681,7 +692,8 @@ module Google
         #   puts commit_resp.stats.mutation_count
         #
         def commit transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           ensure_service!
           commit = Commit.new
           yield commit
@@ -694,6 +706,8 @@ module Google
                                          commit.mutations,
                                          transaction_id: transaction_id,
                                          exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                                         isolation_level: isolation_level,
+                                         read_lock_mode: read_lock_mode,
                                          commit_options: commit_options,
                                          request_options: request_options,
                                          call_options: call_options,
@@ -840,6 +854,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -882,6 +898,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -912,13 +937,16 @@ module Google
         #
         def upsert table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           opts = {
             transaction_id: transaction_id,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+            isolation_level: isolation_level,
             commit_options: commit_options,
             request_options: request_options,
-            call_options: call_options
+            call_options: call_options,
+            read_lock_mode: read_lock_mode
           }
           commit(**opts) do |c|
             c.upsert table, rows
@@ -960,6 +988,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1002,6 +1032,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1032,13 +1071,16 @@ module Google
         #
         def insert table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           opts = {
             transaction_id: transaction_id,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+            isolation_level: isolation_level,
             commit_options: commit_options,
             request_options: request_options,
-            call_options: call_options
+            call_options: call_options,
+            read_lock_mode: read_lock_mode
           }
           commit(**opts) do |c|
             c.insert table, rows
@@ -1079,6 +1121,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1121,6 +1165,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1151,13 +1204,16 @@ module Google
         #
         def update table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           opts = {
             transaction_id: transaction_id,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+            isolation_level: isolation_level,
             commit_options: commit_options,
             request_options: request_options,
-            call_options: call_options
+            call_options: call_options,
+            read_lock_mode: read_lock_mode
           }
           commit(**opts) do |c|
             c.update table, rows
@@ -1200,6 +1256,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1243,6 +1301,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1273,13 +1340,16 @@ module Google
         #
         def replace table, *rows,
                     transaction_id: nil, exclude_txn_from_change_streams: false,
-                    commit_options: nil, request_options: nil, call_options: nil
+                    isolation_level: nil, commit_options: nil, request_options: nil,
+                    call_options: nil, read_lock_mode: nil
           opts = {
             transaction_id: transaction_id,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+            isolation_level: isolation_level,
             commit_options: commit_options,
             request_options: request_options,
-            call_options: call_options
+            call_options: call_options,
+            read_lock_mode: read_lock_mode
           }
           commit(**opts) do |c|
             c.replace table, rows
@@ -1301,6 +1371,8 @@ module Google
         # @param [Boolean] exclude_txn_from_change_streams If set to true,
         #   mutations will not be recorded in change streams with DDL option
         #   `allow_txn_exclusion=true`. Used if starting a new transaction.
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::IsolationLevel] isolation_level Optional. The
+        #   isolation level for the transaction.
         # @param [Hash] commit_options A hash of commit options.
         #   e.g., return_commit_stats. Commit options are optional.
         #   The following options can be provided:
@@ -1343,6 +1415,15 @@ module Google
         #     * `:retry_codes` (`Array<String>`) - The error codes that should
         #       trigger a retry.
         #
+        # @param [Google::Cloud::Spanner::V1::TransactionOptions::ReadWrite::ReadLockMode] read_lock_mode
+        #   The read lock mode for the transaction.
+        #   Can be one of the following:
+        #   * `:READ_LOCK_MODE_UNSPECIFIED` : The default unspecified read lock mode.
+        #   * `:PESSIMISTIC` : The pessimistic lock mode, where read locks are acquired immediately on read.
+        #   * `:OPTIMISTIC` : The optimistic lock mode, where locks for reads are not acquired on read
+        #       but instead on a commit to validate that the data has not changed since the transaction started.
+        #
+        #
         # @return [Time, CommitResponse] The timestamp at which the operation
         #   committed. If commit options are set it returns {CommitResponse}.
         #
@@ -1370,13 +1451,16 @@ module Google
         #
         def delete table, keys = [],
                    transaction_id: nil, exclude_txn_from_change_streams: false,
-                   commit_options: nil, request_options: nil, call_options: nil
+                   isolation_level: nil, commit_options: nil, request_options: nil,
+                   call_options: nil, read_lock_mode: nil
           opts = {
             transaction_id: transaction_id,
             exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+            isolation_level: isolation_level,
             commit_options: commit_options,
             request_options: request_options,
-            call_options: call_options
+            call_options: call_options,
+            read_lock_mode: read_lock_mode
           }
           commit(**opts) do |c|
             c.delete table, keys
@@ -1400,12 +1484,15 @@ module Google
         #   or write transactions from being tracked in change streams.
         # @private
         # @return [::Google::Cloud::Spanner::Transaction]
-        def create_transaction exclude_txn_from_change_streams: false
+        def create_transaction exclude_txn_from_change_streams: false, read_lock_mode: nil
           route_to_leader = LARHeaders.begin_transaction true
           tx_grpc = service.begin_transaction path,
                                               route_to_leader: route_to_leader,
-                                              exclude_txn_from_change_streams: exclude_txn_from_change_streams
-          Transaction.from_grpc tx_grpc, self, exclude_txn_from_change_streams: exclude_txn_from_change_streams
+                                              exclude_txn_from_change_streams: exclude_txn_from_change_streams,
+                                              read_lock_mode: read_lock_mode
+          Transaction.from_grpc \
+            tx_grpc, self,
+            exclude_txn_from_change_streams: exclude_txn_from_change_streams, read_lock_mode: read_lock_mode
         end
 
         # Creates a new empty transaction wrapper without a server-side object.
@@ -1421,9 +1508,10 @@ module Google
         #   of a new ReadWrite transaction when retry is attempted.
         # @private
         # @return [::Google::Cloud::Spanner::Transaction] The new *empty-wrapper* transaction object.
-        def create_empty_transaction exclude_txn_from_change_streams: false, previous_transaction_id: nil
+        def create_empty_transaction exclude_txn_from_change_streams: false, previous_transaction_id: nil,
+                                     read_lock_mode: nil
           Transaction.from_grpc nil, self, exclude_txn_from_change_streams: exclude_txn_from_change_streams,
-previous_transaction_id: previous_transaction_id
+previous_transaction_id: previous_transaction_id, read_lock_mode: read_lock_mode
         end
 
         # If the session is non-multiplexed, keeps the session alive by executing `"SELECT 1"`.

data/lib/google/cloud/spanner/transaction.rb

@@ -111,6 +111,9 @@ module Google
         # @return [::String, nil]
         attr_reader :previous_transaction_id
 
+        # @private Whether to add a read lock mode on the transaction.
+        attr_accessor :read_lock_mode
+
         # Creates a new `Spanner::Transaction` instance from a `V1::Transaction` object.
         # @param grpc [::Google::Cloud::Spanner::V1::Transaction] Underlying `V1::Transaction` object.
         # @param session [::Google::Cloud::Spanner::Session] The session this transaction is running in.
@@ -123,10 +126,11 @@ module Google
         #   of a new ReadWrite transaction when retry is attempted.
         # @private
         # @return [::Google::Cloud::Spanner::Transaction]
-        def initialize grpc, session, exclude_txn_from_change_streams, previous_transaction_id: nil
+        def initialize grpc, session, exclude_txn_from_change_streams, previous_transaction_id: nil, read_lock_mode: nil
           @grpc = grpc
           @session = session
           @exclude_txn_from_change_streams = exclude_txn_from_change_streams
+          @read_lock_mode = read_lock_mode
 
           # throwing away empty strings for simplicity
           unless previous_transaction_id.nil? || previous_transaction_id.empty?
@@ -136,6 +140,7 @@ module Google
           @commit = Commit.new
           @seqno = 0
           @exclude_txn_from_change_streams = false
+          @read_lock_mode = nil
 
           # Mutex to enfore thread safety for transaction creation and query executions.
           #
@@ -1250,8 +1255,10 @@ module Google
         #   of a new ReadWrite transaction when retry is attempted.
         # @private
         # @return [::Google::Cloud::Spanner::Transaction]
-        def self.from_grpc grpc, session, exclude_txn_from_change_streams: false, previous_transaction_id: nil
-          new grpc, session, exclude_txn_from_change_streams, previous_transaction_id: previous_transaction_id
+        def self.from_grpc grpc, session, exclude_txn_from_change_streams: false, previous_transaction_id: nil,
+                           read_lock_mode: nil
+          new grpc, session, exclude_txn_from_change_streams, previous_transaction_id: previous_transaction_id,
+read_lock_mode: read_lock_mode
         end
 
         ##
@@ -1278,7 +1285,8 @@ module Google
         # @private
         # @return [::Google::Cloud::Spanner::V1::Transaction, nil] The new transaction
         #   object, or `nil` if a transaction already exists.
-        def safe_begin_transaction! exclude_from_change_streams: false, request_options: nil, call_options: nil
+        def safe_begin_transaction! exclude_from_change_streams: false, request_options: nil, call_options: nil,
+                                    read_lock_mode: nil
           # If a read-write transaction on a multiplexed session commit mutations
           # without performing any reads or queries, one of the mutations from the mutation set
           # must be sent as a mutation key for `BeginTransaction`.
@@ -1299,7 +1307,8 @@ module Google
               call_options: call_options,
               route_to_leader: route_to_leader,
               mutation_key: mutation_key,
-              previous_transaction_id: previous_transaction_id
+              previous_transaction_id: previous_transaction_id,
+              read_lock_mode: read_lock_mode
             )
           end
         end
@@ -1343,7 +1352,7 @@ module Google
         #   or write transactions from being tracked in change streams.
         # @private
         # @return [::Google::Cloud::Spanner::V1::TransactionSelector]
-        def tx_selector exclude_txn_from_change_streams: false
+        def tx_selector exclude_txn_from_change_streams: false, read_lock_mode: nil
           return V1::TransactionSelector.new id: transaction_id if existing_transaction?
 
           read_write = if @previous_transaction_id.nil?
@@ -1354,6 +1363,10 @@ module Google
                          )
                        end
 
+          unless read_lock_mode.nil?
+            read_write.read_lock_mode = read_lock_mode
+          end
+
           V1::TransactionSelector.new(
             begin: V1::TransactionOptions.new(
               read_write: read_write,

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "2.30.0".freeze
+      VERSION = "2.32.0".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner
 version: !ruby/object:Gem::Version
-  version: 2.30.0
+  version: 2.32.0
 platform: ruby
 authors:
 - Mike Moore