google-cloud-spanner-v1 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 074ba65a11b32fc7a462954b0a1a2b551bd9524646028884a7f91a3053f7e085
-  data.tar.gz: df7f103b0d1af51be718cecd31706b65a90cf94a635793af3ac6f37fdcb4b697
+  metadata.gz: 506e5f2c7f94609ad28e4a3d6d53a00ea9512e861999529e85cca4ab1d3a7fd1
+  data.tar.gz: c3998ce28c3c96271b0354c47cffd670ca43ac1193c33587a758da2593ba489a
 SHA512:
-  metadata.gz: d9a2738f844a34f499c8743d8fb368776f7a9d374353a2d1c91b1ab7a7d77fd0a4c7704c668c858347b0ef99db0f8abfbf165fd3e4e4fe0d654d6c811cb3e0fb
-  data.tar.gz: c8f2f845cd7be339fece8b0a62ff1be451afaf08296e7b275485823cc2639b75bb8fcb331ea779684944cf3a3c545e76da139bfa5be71f2fac9bb3593273c3f2
+  metadata.gz: e2e57a196955b402002d7a50965d08eb676360188d59e063b478635d2a972f458b7643f298414b135738b53fe1234307fefbb3cc091715437b81c6a68220fe93
+  data.tar.gz: 35c0bf23032ad50669c14e5035893d968d100e4e90639cf6ccd787a9647bace9513d8d6a44ec44a96b28adf4b4220ca29d1caad4f38e6f330d76b557f31282c1

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

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

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

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

@@ -25,6 +25,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.spanner.v1.ResultSetMetadata" do
       optional :row_type, :message, 1, "google.spanner.v1.StructType"
       optional :transaction, :message, 2, "google.spanner.v1.Transaction"
+      optional :undeclared_parameters, :message, 3, "google.spanner.v1.StructType"
     end
     add_message "google.spanner.v1.ResultSetStats" do
       optional :query_plan, :message, 1, "google.spanner.v1.QueryPlan"

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

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

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

@@ -171,6 +171,18 @@ module Google
         #   @return [::Google::Cloud::Spanner::V1::Transaction]
         #     If the read or SQL query began a transaction as a side-effect, the
         #     information about the new transaction is yielded here.
+        # @!attribute [rw] undeclared_parameters
+        #   @return [::Google::Cloud::Spanner::V1::StructType]
+        #     A SQL query can be parameterized. In PLAN mode, these parameters can be
+        #     undeclared. This indicates the field names and types for those undeclared
+        #     parameters in the SQL query. For example, a SQL query like `"SELECT * FROM
+        #     Users where UserId = @userId and UserName = @userName "` could return a
+        #     `undeclared_parameters` value like:
+        #
+        #         "fields": [
+        #           { "name": "UserId", "type": { "code": "INT64" } },
+        #           { "name": "UserName", "type": { "code": "STRING" } },
+        #         ]
         class ResultSetMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-v1
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-29 00:00:00.000000000 Z
+date: 2022-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a