google-cloud-spanner 2.31.0 → 2.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 747996c4ee90317631f8648dbc5abefec1ef5dec80ab4e867475dfc465671cf6
-  data.tar.gz: 7316c929b5c69c3595e35780fe13ced837091de64de0da2ad13e41c2ccab065e
+  metadata.gz: 5432cd1029cb3077b9eee5511329297355428098e40afa349d93fb0272b2c092
+  data.tar.gz: a70271c85a8aa155d2e66e50733c388ca7005f4ce924fb921c253e14a98b3d86
 SHA512:
-  metadata.gz: c5f2caed803fc1883c743c34b45a54383259d20749628d01af88cd94d6ac2b89195af9597d763a199b597066a1bee5999fa3b2c3e34b89b59d78c5e86a7cdee1
-  data.tar.gz: 8d40b705e2b0fa7b93f2aa334b8b034ad8cb320833d32d6c0bf7a1073966d6cc9d9b40192a86bd1d3fcacce64c020a60f7b4b4fa6b2b9ffdefbc6f308428b711
+  metadata.gz: 2191fcfe9aad61cca23733bbdfa78f359d10aa140e3fc77a53c3c4dafb5aa72ac99c94ae09437ab4b8080922610d709c634e4023657c706759180202143a00e1
+  data.tar.gz: 682e7a8b1a85c680cfaad9dc4af31c426dad9c80ac19345a034531338a6201173769e161a986a5d53a3382b0fb653f21e9274610800ee931e8d3cd7d72b62c55

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 2.33.0 (2025-12-12)
+
+#### Features
+
+* Support :UUID data type ([#139](https://github.com/googleapis/ruby-spanner/issues/139)) 
+
+### 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

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

@@ -334,6 +334,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.

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

@@ -138,6 +138,7 @@ module Google
         #   | `FLOAT64`   | `Float`        | |
         #   | `FLOAT32`   | `Float`        | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -166,6 +167,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.
@@ -489,6 +491,7 @@ module Google
         #   | `FLOAT64`   | `Float`        | |
         #   | `FLOAT32`   | `Float`        | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -517,6 +520,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.

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

@@ -180,6 +180,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -209,6 +210,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.
@@ -618,6 +620,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -648,6 +651,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.
@@ -1105,6 +1109,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}.
@@ -1161,7 +1172,7 @@ module Google
         def upsert table, rows,
                    exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
@@ -1171,7 +1182,8 @@ module Google
                            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
@@ -1257,6 +1269,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}.
         #
@@ -1312,7 +1333,7 @@ module Google
         def insert table, rows,
                    exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
@@ -1322,7 +1343,8 @@ module Google
                            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
 
@@ -1406,6 +1428,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}.
@@ -1461,7 +1491,7 @@ module Google
         def update table, rows,
                    exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
@@ -1471,7 +1501,8 @@ module Google
                            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
 
@@ -1557,6 +1588,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}.
@@ -1612,14 +1651,15 @@ module Google
         def replace table, rows,
                     exclude_txn_from_change_streams: false,
                     isolation_level: nil, commit_options: nil, request_options: nil,
-                    call_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
 
@@ -1684,6 +1724,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}.
         #
@@ -1732,7 +1781,7 @@ module Google
         def delete table, keys = [],
                    exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil
+                   call_options: nil, read_lock_mode: nil
           request_options = Convert.to_request_options \
             request_options, tag_type: :transaction_tag
 
@@ -1742,7 +1791,8 @@ module Google
                            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
 
@@ -1805,6 +1855,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}.
         #
@@ -1863,7 +1922,7 @@ module Google
         #
         def commit exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil, &block
+                   call_options: nil, read_lock_mode: nil, &block
           raise ArgumentError, "Must provide a block" unless block_given?
 
           request_options = Convert.to_request_options \
@@ -1876,6 +1935,7 @@ module Google
               commit_options: commit_options,
               request_options: request_options,
               call_options: call_options,
+              read_lock_mode: read_lock_mode,
               &block
             )
           end
@@ -2042,6 +2102,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.
@@ -2144,7 +2213,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"
@@ -2158,7 +2227,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
@@ -2175,7 +2245,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
 
@@ -2195,7 +2266,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
@@ -2216,7 +2288,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/convert.rb

@@ -261,6 +261,8 @@ module Google
               descriptor = Google::Protobuf::DescriptorPool.generated_pool.lookup(type.proto_type_fqn).msgclass
               content = Base64.decode64 value.string_value
               descriptor.decode content
+            when :UUID
+              value.string_value
             end
           end
 

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

@@ -68,6 +68,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `:PROTO`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as

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

@@ -540,12 +540,14 @@ module Google
         def commit session_name, mutations = [],
                    transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil, precommit_token: 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,
+              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
             )
@@ -640,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
@@ -649,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

@@ -135,6 +135,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -165,6 +166,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.
@@ -648,6 +650,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.
         #
@@ -684,7 +695,7 @@ module Google
         #
         def commit transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_options: nil
+                   call_options: nil, read_lock_mode: nil
           ensure_service!
           commit = Commit.new
           yield commit
@@ -698,6 +709,7 @@ module Google
                                          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,
@@ -830,6 +842,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -888,6 +901,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}.
         #
@@ -919,14 +941,15 @@ module Google
         def upsert table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_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
@@ -954,6 +977,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -1012,6 +1036,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}.
         #
@@ -1043,14 +1076,15 @@ module Google
         def insert table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_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
@@ -1077,6 +1111,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -1135,6 +1170,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}.
         #
@@ -1166,14 +1210,15 @@ module Google
         def update table, *rows,
                    transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_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
@@ -1202,6 +1247,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -1261,6 +1307,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}.
         #
@@ -1291,14 +1346,16 @@ module Google
         #
         def replace table, *rows,
                     transaction_id: nil, exclude_txn_from_change_streams: false,
-                    isolation_level: nil, 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
@@ -1364,6 +1421,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}.
         #
@@ -1392,14 +1458,15 @@ module Google
         def delete table, keys = [],
                    transaction_id: nil, exclude_txn_from_change_streams: false,
                    isolation_level: nil, commit_options: nil, request_options: nil,
-                   call_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
@@ -1423,12 +1490,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.
@@ -1444,9 +1514,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/snapshot.rb

@@ -103,6 +103,7 @@ module Google
         #   | `FLOAT32`   | `Float`        | |
         #   | `NUMERIC`   | `BigDecimal`   | |
         #   | `STRING`    | `String`       | |
+        #   | `UUID`      | `String`       | |
         #   | `DATE`      | `Date`         | |
         #   | `TIMESTAMP` | `Time`, `DateTime` | |
         #   | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
@@ -132,6 +133,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.
@@ -469,6 +471,7 @@ module Google
         #   * `:INT64`
         #   * `:STRING`
         #   * `:TIMESTAMP`
+        #   * `:UUID`
         #   * `Array` - Lists are specified by providing the type code in an
         #     array. For example, an array of integers are specified as
         #     `[:INT64]`.

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.31.0".freeze
+      VERSION = "2.33.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.31.0
+  version: 2.33.0
 platform: ruby
 authors:
 - Mike Moore