google-cloud-spanner-v1 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30491544a9cee28d7b28d3ddc25097db8bb8289cb9b2c1b19e333ac3f9c1a3b3
-  data.tar.gz: 07632e9e7590d1dff77707dac90aba899c80476684346df58b5382983fbe6fda
+  metadata.gz: 263176d27e7a17047a1cce07d6c8d689545e041165be967c844bb4e7a0efedad
+  data.tar.gz: 955f9cab32b046a967e976a7fb3d9b8d85d639e83f832a4fcb4b116467afa12c
 SHA512:
-  metadata.gz: 871fc2729d63b8df0b4166735de5ec86e73a715b4bbfa437f85f1d75173788a560a4628a6b27f7692c753b306c1adacaa3d5b9e585adcd725c7012a73eb2fb6d
-  data.tar.gz: 5bf61407575d29405288136ea494d7d00baff111d9210fc22c0d2f935e8f54793818255c17cf3659b458acde56da5df72d9530094f15065a4f42d5cac034e694
+  metadata.gz: 740038bbd4dee2ca57f46e8a8fdbab30124b9518a5ede0d4788f08413acfed6ae325c6b06f42c8ac062ab7f6380ce5bee88307bbdda0ab76bf6603fd8a2d8fab
+  data.tar.gz: 6ea8764ff08a7a06a25210dd1f68ea49e2889bb46b6582eed5ff2bb018491a134dc17c931128f45b8e883c6e104c6b2c5f132b03e7c75484cb69d579a9f9c156

data/README.md

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

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

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

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

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

data/proto_docs/google/protobuf/struct.rb

@@ -53,21 +53,33 @@ module Google
     # @!attribute [rw] null_value
     #   @return [::Google::Protobuf::NullValue]
     #     Represents a null value.
+    #
+    #     Note: The following fields are mutually exclusive: `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] number_value
     #   @return [::Float]
     #     Represents a double value.
+    #
+    #     Note: The following fields are mutually exclusive: `number_value`, `null_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] string_value
     #   @return [::String]
     #     Represents a string value.
+    #
+    #     Note: The following fields are mutually exclusive: `string_value`, `null_value`, `number_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] bool_value
     #   @return [::Boolean]
     #     Represents a boolean value.
+    #
+    #     Note: The following fields are mutually exclusive: `bool_value`, `null_value`, `number_value`, `string_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] struct_value
     #   @return [::Google::Protobuf::Struct]
     #     Represents a structured value.
+    #
+    #     Note: The following fields are mutually exclusive: `struct_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] list_value
     #   @return [::Google::Protobuf::ListValue]
     #     Represents a repeated `Value`.
+    #
+    #     Note: The following fields are mutually exclusive: `list_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     class Value
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -113,18 +113,26 @@ module Google
         #   @return [::Google::Protobuf::ListValue]
         #     If the start is closed, then the range includes all rows whose
         #     first `len(start_closed)` key columns exactly match `start_closed`.
+        #
+        #     Note: The following fields are mutually exclusive: `start_closed`, `start_open`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] start_open
         #   @return [::Google::Protobuf::ListValue]
         #     If the start is open, then the range excludes rows whose first
         #     `len(start_open)` key columns exactly match `start_open`.
+        #
+        #     Note: The following fields are mutually exclusive: `start_open`, `start_closed`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] end_closed
         #   @return [::Google::Protobuf::ListValue]
         #     If the end is closed, then the range includes all rows whose
         #     first `len(end_closed)` key columns exactly match `end_closed`.
+        #
+        #     Note: The following fields are mutually exclusive: `end_closed`, `end_open`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] end_open
         #   @return [::Google::Protobuf::ListValue]
         #     If the end is open, then the range excludes rows whose first
         #     `len(end_open)` key columns exactly match `end_open`.
+        #
+        #     Note: The following fields are mutually exclusive: `end_open`, `end_closed`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class KeyRange
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

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

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

@@ -224,10 +224,14 @@ module Google
         # @!attribute [rw] row_count_exact
         #   @return [::Integer]
         #     Standard DML returns an exact count of rows that were modified.
+        #
+        #     Note: The following fields are mutually exclusive: `row_count_exact`, `row_count_lower_bound`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] row_count_lower_bound
         #   @return [::Integer]
         #     Partitioned DML does not offer exactly-once semantics, so it
         #     returns a lower bound of the rows modified.
+        #
+        #     Note: The following fields are mutually exclusive: `row_count_lower_bound`, `row_count_exact`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class ResultSetStats
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

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

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

@@ -352,6 +352,8 @@ module Google
         #     Authorization to begin a read-write transaction requires
         #     `spanner.databases.beginOrRollbackReadWriteTransaction` permission
         #     on the `session` resource.
+        #
+        #     Note: The following fields are mutually exclusive: `read_write`, `partitioned_dml`, `read_only`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] partitioned_dml
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::PartitionedDml]
         #     Partitioned DML transaction.
@@ -359,6 +361,8 @@ module Google
         #     Authorization to begin a Partitioned DML transaction requires
         #     `spanner.databases.beginPartitionedDmlTransaction` permission
         #     on the `session` resource.
+        #
+        #     Note: The following fields are mutually exclusive: `partitioned_dml`, `read_write`, `read_only`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] read_only
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly]
         #     Transaction will not write.
@@ -366,6 +370,8 @@ module Google
         #     Authorization to begin a read-only transaction requires
         #     `spanner.databases.beginReadOnlyTransaction` permission
         #     on the `session` resource.
+        #
+        #     Note: The following fields are mutually exclusive: `read_only`, `read_write`, `partitioned_dml`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] exclude_txn_from_change_streams
         #   @return [::Boolean]
         #     When `exclude_txn_from_change_streams` is set to `true`:
@@ -435,6 +441,8 @@ module Google
           #   @return [::Boolean]
           #     Read at a timestamp where all previously committed transactions
           #     are visible.
+          #
+          #     Note: The following fields are mutually exclusive: `strong`, `min_read_timestamp`, `max_staleness`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] min_read_timestamp
           #   @return [::Google::Protobuf::Timestamp]
           #     Executes all reads at a timestamp >= `min_read_timestamp`.
@@ -447,6 +455,8 @@ module Google
           #
           #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
           #     Example: `"2014-10-02T15:01:23.045123456Z"`.
+          #
+          #     Note: The following fields are mutually exclusive: `min_read_timestamp`, `strong`, `max_staleness`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] max_staleness
           #   @return [::Google::Protobuf::Duration]
           #     Read data at a timestamp >= `NOW - max_staleness`
@@ -462,6 +472,8 @@ module Google
           #
           #     Note that this option can only be used in single-use
           #     transactions.
+          #
+          #     Note: The following fields are mutually exclusive: `max_staleness`, `strong`, `min_read_timestamp`, `read_timestamp`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] read_timestamp
           #   @return [::Google::Protobuf::Timestamp]
           #     Executes all reads at the given timestamp. Unlike other modes,
@@ -476,6 +488,8 @@ module Google
           #
           #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
           #     Example: `"2014-10-02T15:01:23.045123456Z"`.
+          #
+          #     Note: The following fields are mutually exclusive: `read_timestamp`, `strong`, `min_read_timestamp`, `max_staleness`, `exact_staleness`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] exact_staleness
           #   @return [::Google::Protobuf::Duration]
           #     Executes all reads at a timestamp that is `exact_staleness`
@@ -489,6 +503,8 @@ module Google
           #
           #     Useful for reading at nearby replicas without the distributed
           #     timestamp negotiation overhead of `max_staleness`.
+          #
+          #     Note: The following fields are mutually exclusive: `exact_staleness`, `strong`, `min_read_timestamp`, `max_staleness`, `read_timestamp`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] return_read_timestamp
           #   @return [::Boolean]
           #     If true, the Cloud Spanner-selected read timestamp is included in
@@ -546,15 +562,21 @@ module Google
         #     Execute the read or SQL query in a temporary transaction.
         #     This is the most efficient way to execute a transaction that
         #     consists of a single SQL query.
+        #
+        #     Note: The following fields are mutually exclusive: `single_use`, `id`, `begin`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] id
         #   @return [::String]
         #     Execute the read or SQL query in a previously-started transaction.
+        #
+        #     Note: The following fields are mutually exclusive: `id`, `single_use`, `begin`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] begin
         #   @return [::Google::Cloud::Spanner::V1::TransactionOptions]
         #     Begin a new transaction and execute this read or SQL query in
         #     it. The transaction ID of the new transaction is returned in
         #     {::Google::Cloud::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata.transaction},
         #     which is a {::Google::Cloud::Spanner::V1::Transaction Transaction}.
+        #
+        #     Note: The following fields are mutually exclusive: `begin`, `single_use`, `id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class TransactionSelector
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

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