google-cloud-spanner-v1 0.7.4 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b64f05386c2edb9c280625e5c53bbcf45f9fec1e2b32af526c0b9353910e4a86
-  data.tar.gz: 2b6d4a71cbaa6981c7a1ad4f434fdda7c37e66eb0f6271c6904afb14902a0c14
+  metadata.gz: 107c7db85e616d72c82ff72eb07655d00ae1926f99c8002bfaf81eff4fb6caba
+  data.tar.gz: 42995b967b44b04c1b8effd91d090d05627cfa1df9c5ea01b1f6f9570cbefb07
 SHA512:
-  metadata.gz: 2adb5c7f6ddabfd316314fc82150681b755ea652db640df42486dbeff625294c5f765372e783ea6964785e9860663341c665f6d5e4b8659f4bfa9b4c1c8e6cd0
-  data.tar.gz: d6d70ca8e7bf3979068c81ce7a5c2fcb2ecf1e3d4c987785255180376f78694d0234601e0a4340a438b27933789a85ccf53445c9a40b903c2564a288390fc215
+  metadata.gz: a0f052167fd7a336f1566d4d9aefc9ff84e2e1b745b1c6999deae77d62900e82538943f7a25899390ddf6771ac08260ff0d1947cd10a8089eeabf73050156378
+  data.tar.gz: f0a3fed751f4d1af95465f51d4f94a6d423544fd28a6183b6ccfffe3ac423f2146f981b894a6600c2c8c214efa25f98828028cfa071cead7fa940bf77088fc83

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Spanner::V1::CreateSessionRequest.new # (request fiel
 response = client.create_session request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-spanner-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-spanner-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/spanner)
@@ -69,6 +69,11 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.5+.

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

@@ -255,7 +255,7 @@ module Google
             #   @param database [::String]
             #     Required. The database in which the new session is created.
             #   @param session [::Google::Cloud::Spanner::V1::Session, ::Hash]
-            #     The session to create.
+            #     Required. The session to create.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Spanner::V1::Session]

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Spanner
       module V1
-        VERSION = "0.7.4"
+        VERSION = "0.9.0"
       end
     end
   end

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

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/spanner/v1"
       #     client = ::Google::Cloud::Spanner::V1::Spanner::Client.new
       #

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

@@ -1,11 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/commit_response.proto
 
-require 'google/protobuf/duration_pb'
-require 'google/protobuf/timestamp_pb'
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
+require 'google/protobuf/timestamp_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/commit_response.proto", :syntax => :proto3) do
     add_message "google.spanner.v1.CommitResponse" do

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

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/keys.proto
 
-require 'google/protobuf/struct_pb'
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
+require 'google/protobuf/struct_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/keys.proto", :syntax => :proto3) do
     add_message "google.spanner.v1.KeyRange" do

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

@@ -1,10 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/mutation.proto
 
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
 require 'google/protobuf/struct_pb'
 require 'google/spanner/v1/keys_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/mutation.proto", :syntax => :proto3) do

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

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/query_plan.proto
 
-require 'google/protobuf/struct_pb'
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
+require 'google/protobuf/struct_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/query_plan.proto", :syntax => :proto3) do
     add_message "google.spanner.v1.PlanNode" do

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

@@ -1,12 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/result_set.proto
 
+require 'google/protobuf'
+
 require 'google/protobuf/struct_pb'
 require 'google/spanner/v1/query_plan_pb'
 require 'google/spanner/v1/transaction_pb'
 require 'google/spanner/v1/type_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/result_set.proto", :syntax => :proto3) do

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

@@ -1,7 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/spanner.proto
 
-require 'google/spanner/v1/commit_response_pb'
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -10,12 +11,12 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
+require 'google/spanner/v1/commit_response_pb'
 require 'google/spanner/v1/keys_pb'
 require 'google/spanner/v1/mutation_pb'
 require 'google/spanner/v1/result_set_pb'
 require 'google/spanner/v1/transaction_pb'
 require 'google/spanner/v1/type_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/spanner.proto", :syntax => :proto3) do
@@ -36,6 +37,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :labels, :string, :string, 2
       optional :create_time, :message, 3, "google.protobuf.Timestamp"
       optional :approximate_last_use_time, :message, 4, "google.protobuf.Timestamp"
+      optional :creator_role, :string, 5
     end
     add_message "google.spanner.v1.GetSessionRequest" do
       optional :name, :string, 1

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

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/transaction.proto
 
+require 'google/protobuf'
+
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/transaction.proto", :syntax => :proto3) do

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

@@ -1,16 +1,17 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/type.proto
 
-require 'google/api/field_behavior_pb'
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
+require 'google/api/field_behavior_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/v1/type.proto", :syntax => :proto3) do
     add_message "google.spanner.v1.Type" do
       optional :code, :enum, 1, "google.spanner.v1.TypeCode"
       optional :array_element_type, :message, 2, "google.spanner.v1.Type"
       optional :struct_type, :message, 3, "google.spanner.v1.StructType"
+      optional :type_annotation, :enum, 4, "google.spanner.v1.TypeAnnotationCode"
     end
     add_message "google.spanner.v1.StructType" do
       repeated :fields, :message, 1, "google.spanner.v1.StructType.Field"
@@ -33,6 +34,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :NUMERIC, 10
       value :JSON, 11
     end
+    add_enum "google.spanner.v1.TypeAnnotationCode" do
+      value :TYPE_ANNOTATION_CODE_UNSPECIFIED, 0
+      value :PG_NUMERIC, 2
+    end
   end
 end
 
@@ -44,6 +49,7 @@ module Google
         StructType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType").msgclass
         StructType::Field = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType.Field").msgclass
         TypeCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TypeCode").enummodule
+        TypeAnnotationCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TypeAnnotationCode").enummodule
       end
     end
   end

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/struct.rb

@@ -46,8 +46,8 @@ module Google
 
     # `Value` represents a dynamically typed value which can be either
     # null, a number, a string, a boolean, a recursive struct value, or a
-    # list of values. A producer of value is expected to set one of that
-    # variants, absence of any variant indicates an error.
+    # list of values. A producer of value is expected to set one of these
+    # variants. Absence of any variant indicates an error.
     #
     # The JSON representation for `Value` is JSON value.
     # @!attribute [rw] null_value

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

@@ -41,9 +41,9 @@ module Google
           #     `mutation_count` value can help you maximize the number of mutations
           #     in a transaction and minimize the number of API round trips. You can
           #     also monitor this value to prevent transactions from exceeding the system
-          #     [limit](http://cloud.google.com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data).
+          #     [limit](https://cloud.google.com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data).
           #     If the number of mutations exceeds the limit, the server returns
-          #     [INVALID_ARGUMENT](http://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT).
+          #     [INVALID_ARGUMENT](https://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT).
           class CommitStats
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -27,7 +27,7 @@ module Google
         #     Required. The database in which the new session is created.
         # @!attribute [rw] session
         #   @return [::Google::Cloud::Spanner::V1::Session]
-        #     The session to create.
+        #     Required. The session to create.
         class CreateSessionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -83,6 +83,9 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The approximate timestamp when the session is last used. It is
         #     typically earlier than the actual last use time.
+        # @!attribute [rw] creator_role
+        #   @return [::String]
+        #     The database role which created this session.
         class Session
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -174,6 +177,7 @@ module Google
         #     Legal characters for `request_tag` values are all printable characters
         #     (ASCII 32 - 126) and the length of a request_tag is limited to 50
         #     characters. Values that exceed this limit are truncated.
+        #     Any leading underscore (_) characters will be removed from the string.
         # @!attribute [rw] transaction_tag
         #   @return [::String]
         #     A tag used for statistics collection about this transaction.
@@ -181,11 +185,12 @@ module Google
         #     that belongs to a transaction.
         #     The value of transaction_tag should be the same for all requests belonging
         #     to the same transaction.
-        #     If this request doesn’t belong to any transaction, transaction_tag will be
+        #     If this request doesn't belong to any transaction, transaction_tag will be
         #     ignored.
         #     Legal characters for `transaction_tag` values are all printable characters
         #     (ASCII 32 - 126) and the length of a transaction_tag is limited to 50
         #     characters. Values that exceed this limit are truncated.
+        #     Any leading underscore (_) characters will be removed from the string.
         class RequestOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -21,8 +21,7 @@ module Google
   module Cloud
     module Spanner
       module V1
-        # # Transactions
-        #
+        # Transactions:
         #
         # Each session can have at most one active transaction at a time (note that
         # standalone reads and queries use a transaction internally and do count
@@ -30,7 +29,7 @@ module Google
         # completed, the session can immediately be re-used for the next transaction.
         # It is not necessary to create a new session for each transaction.
         #
-        # # Transaction Modes
+        # Transaction modes:
         #
         # Cloud Spanner supports three transaction modes:
         #
@@ -40,11 +39,18 @@ module Google
         #      Locking read-write transactions may abort, requiring the
         #      application to retry.
         #
-        #   2. Snapshot read-only. This transaction type provides guaranteed
-        #      consistency across several reads, but does not allow
-        #      writes. Snapshot read-only transactions can be configured to
-        #      read at timestamps in the past. Snapshot read-only
-        #      transactions do not need to be committed.
+        #   2. Snapshot read-only. Snapshot read-only transactions provide guaranteed
+        #      consistency across several reads, but do not allow
+        #      writes. Snapshot read-only transactions can be configured to read at
+        #      timestamps in the past, or configured to perform a strong read
+        #      (where Spanner will select a timestamp such that the read is
+        #      guaranteed to see the effects of all transactions that have committed
+        #      before the start of the read). Snapshot read-only transactions do not
+        #      need to be committed.
+        #
+        #      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.
         #
         #   3. Partitioned DML. This type of transaction is used to execute
         #      a single Partitioned DML statement. Partitioned DML partitions
@@ -59,11 +65,11 @@ module Google
         # not conflict with read-write transactions. As a consequence of not
         # taking locks, they also do not abort, so retry loops are not needed.
         #
-        # Transactions may only read/write data in a single database. They
-        # may, however, read/write data in different tables within that
+        # Transactions may only read-write data in a single database. They
+        # may, however, read-write data in different tables within that
         # database.
         #
-        # ## Locking Read-Write Transactions
+        # Locking read-write transactions:
         #
         # Locking transactions may be used to atomically read-modify-write
         # data anywhere in a database. This type of transaction is externally
@@ -75,7 +81,7 @@ module Google
         # active as long as the transaction continues to do reads, and the
         # transaction has not been terminated by
         # {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} or
-        # {::Google::Cloud::Spanner::V1::Spanner::Client#rollback Rollback}.  Long periods of
+        # {::Google::Cloud::Spanner::V1::Spanner::Client#rollback Rollback}. Long periods of
         # inactivity at the client may cause Cloud Spanner to release a
         # transaction's locks and abort it.
         #
@@ -86,7 +92,7 @@ module Google
         # {::Google::Cloud::Spanner::V1::Spanner::Client#rollback Rollback} request to abort the
         # transaction.
         #
-        # ## Semantics
+        # Semantics:
         #
         # Cloud Spanner can commit the transaction if all read locks it acquired
         # are still valid at commit time, and it is able to acquire write
@@ -99,7 +105,7 @@ module Google
         # use Cloud Spanner locks for any sort of mutual exclusion other than
         # between Cloud Spanner transactions themselves.
         #
-        # ## Retrying Aborted Transactions
+        # Retrying aborted transactions:
         #
         # When a transaction aborts, the application can choose to retry the
         # whole transaction again. To maximize the chances of successfully
@@ -108,26 +114,26 @@ module Google
         # priority increases with each consecutive abort, meaning that each
         # attempt has a slightly better chance of success than the previous.
         #
-        # Under some circumstances (e.g., many transactions attempting to
+        # Under some circumstances (for example, many transactions attempting to
         # modify the same row(s)), a transaction can abort many times in a
         # short period before successfully committing. Thus, it is not a good
         # idea to cap the number of retries a transaction can attempt;
-        # instead, it is better to limit the total amount of wall time spent
+        # instead, it is better to limit the total amount of time spent
         # retrying.
         #
-        # ## Idle Transactions
+        # Idle transactions:
         #
         # A transaction is considered idle if it has no outstanding reads or
         # SQL queries and has not started a read or SQL query within the last 10
         # seconds. Idle transactions can be aborted by Cloud Spanner so that they
-        # don't hold on to locks indefinitely. In that case, the commit will
-        # fail with error `ABORTED`.
+        # don't hold on to locks indefinitely. If an idle transaction is aborted, the
+        # commit will fail with error `ABORTED`.
         #
         # If this behavior is undesirable, periodically executing a simple
-        # SQL query in the transaction (e.g., `SELECT 1`) prevents the
+        # SQL query in the transaction (for example, `SELECT 1`) prevents the
         # transaction from becoming idle.
         #
-        # ## Snapshot Read-Only Transactions
+        # Snapshot read-only transactions:
         #
         # Snapshot read-only transactions provides a simpler method than
         # locking read-write transactions for doing several consistent
@@ -160,14 +166,12 @@ module Google
         #
         # If the Cloud Spanner database to be read is geographically distributed,
         # stale read-only transactions can execute more quickly than strong
-        # or read-write transaction, because they are able to execute far
+        # or read-write transactions, because they are able to execute far
         # from the leader replica.
         #
         # Each type of timestamp bound is discussed in detail below.
         #
-        # ## Strong
-        #
-        # Strong reads are guaranteed to see the effects of all transactions
+        # Strong: Strong reads are guaranteed to see the effects of all transactions
         # that have committed before the start of the read. Furthermore, all
         # rows yielded by a single read are consistent with each other -- if
         # any part of the read observes a transaction, all parts of the read
@@ -179,15 +183,18 @@ module Google
         # reads should be executed within a transaction or at an exact read
         # timestamp.
         #
+        # 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}.
         #
-        # ## Exact Staleness
+        # Exact staleness:
         #
         # These timestamp bounds execute reads at a user-specified
         # timestamp. Reads at a timestamp are guaranteed to see a consistent
         # prefix of the global transaction history: they observe
-        # modifications done by all transactions with a commit timestamp <=
-        # the read timestamp, and observe none of the modifications done by
+        # modifications done by all transactions with a commit timestamp less than or
+        # equal to the read timestamp, and observe none of the modifications done by
         # transactions with a larger commit timestamp. They will block until
         # all conflicting transactions that may be assigned commit timestamps
         # <= the read timestamp have finished.
@@ -203,7 +210,7 @@ module Google
         # 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
+        # Bounded staleness:
         #
         # Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
         # subject to a user-provided staleness bound. Cloud Spanner chooses the
@@ -233,7 +240,7 @@ module Google
         # 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
+        # Old read timestamps and garbage collection:
         #
         # Cloud Spanner continuously garbage collects deleted and overwritten data
         # in the background to reclaim storage space. This process is known
@@ -244,7 +251,40 @@ module Google
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
         #
-        # ## Partitioned DML Transactions
+        # You can configure and extend the `VERSION_RETENTION_PERIOD` of a
+        # database up to a period as long as one week, which allows Cloud Spanner
+        # to perform reads up to one week in the past.
+        #
+        # Querying change Streams:
+        #
+        # A Change Stream is a schema object that can be configured to watch data
+        # changes on the entire database, a set of tables, or a set of columns
+        # in a database.
+        #
+        # When a change stream is created, Spanner automatically defines a
+        # corresponding SQL Table-Valued Function (TVF) that can be used to query
+        # the change records in the associated change stream using the
+        # ExecuteStreamingSql API. The name of the TVF for a change stream is
+        # generated from the name of the change stream: READ_<change_stream_name>.
+        #
+        # All queries on change stream TVFs must be executed using the
+        # ExecuteStreamingSql API with a single-use read-only transaction with a
+        # strong read-only timestamp_bound. The change stream TVF allows users to
+        # specify the start_timestamp and end_timestamp for the time range of
+        # interest. All change records within the retention period is accessible
+        # using the strong read-only timestamp_bound. All other TransactionOptions
+        # are invalid for change stream queries.
+        #
+        # In addition, if TransactionOptions.read_only.return_read_timestamp is set
+        # to true, a special value of 2^63 - 2 will be returned in the
+        # {::Google::Cloud::Spanner::V1::Transaction Transaction} message that describes the
+        # transaction, instead of a valid read timestamp. This special value should be
+        # discarded and not used for any subsequent queries.
+        #
+        # Please see https://cloud.google.com/spanner/docs/change-streams
+        # for more details on how to query the change stream TVFs.
+        #
+        # Partitioned DML transactions:
         #
         # Partitioned DML transactions are used to execute DML statements with a
         # different execution strategy that provides different, and often better,

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

@@ -34,6 +34,14 @@ module Google
         #   @return [::Google::Cloud::Spanner::V1::StructType]
         #     If {::Google::Cloud::Spanner::V1::Type#code code} == {::Google::Cloud::Spanner::V1::TypeCode::STRUCT STRUCT}, then `struct_type`
         #     provides type information for the struct's fields.
+        # @!attribute [rw] type_annotation
+        #   @return [::Google::Cloud::Spanner::V1::TypeAnnotationCode]
+        #     The {::Google::Cloud::Spanner::V1::TypeAnnotationCode TypeAnnotationCode} that disambiguates SQL type that Spanner will
+        #     use to represent values of this type during query processing. This is
+        #     necessary for some type codes because a single {::Google::Cloud::Spanner::V1::TypeCode TypeCode} can be mapped
+        #     to different SQL types depending on the SQL dialect. {::Google::Cloud::Spanner::V1::Type#type_annotation type_annotation}
+        #     typically is not needed to process the content of a value (it doesn't
+        #     affect serialization) and clients can ignore it on the read path.
         class Type
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -132,15 +140,34 @@ module Google
           # <br>(ExponentIndicator is `"e"` or `"E"`)
           NUMERIC = 10
 
-          # Encoded as a JSON-formatted 'string' as described in RFC 7159. The
-          # following rules will be applied when parsing JSON input:
-          # - Whitespace will be stripped from the document.
-          # - If a JSON object has duplicate keys, only the first key will be
-          #   preserved.
+          # Encoded as a JSON-formatted `string` as described in RFC 7159. The
+          # following rules are applied when parsing JSON input:
+          #
+          # - Whitespace characters are not preserved.
+          # - If a JSON object has duplicate keys, only the first key is preserved.
           # - Members of a JSON object are not guaranteed to have their order
-          #   preserved. JSON array elements will have their order preserved.
+          #   preserved.
+          # - JSON array elements will have their order preserved.
           JSON = 11
         end
+
+        # `TypeAnnotationCode` is used as a part of {::Google::Cloud::Spanner::V1::Type Type} to
+        # disambiguate SQL types that should be used for a given Cloud Spanner value.
+        # Disambiguation is needed because the same Cloud Spanner type can be mapped to
+        # different SQL types depending on SQL dialect. TypeAnnotationCode doesn't
+        # affect the way value is serialized.
+        module TypeAnnotationCode
+          # Not specified.
+          TYPE_ANNOTATION_CODE_UNSPECIFIED = 0
+
+          # PostgreSQL compatible NUMERIC type. This annotation needs to be applied to
+          # {::Google::Cloud::Spanner::V1::Type Type} instances having {::Google::Cloud::Spanner::V1::TypeCode::NUMERIC NUMERIC}
+          # type code to specify that values of this type should be treated as
+          # PostgreSQL NUMERIC values. Currently this annotation is always needed for
+          # {::Google::Cloud::Spanner::V1::TypeCode::NUMERIC NUMERIC} when a client interacts with PostgreSQL-enabled
+          # Spanner databases.
+          PG_NUMERIC = 2
+        end
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-v1
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -221,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Spanner V1 API