google-cloud-spanner-v1 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb64f1bfd5d93cb49f610834908694139c4540d7aa6b012f06b609524aec2a90
-  data.tar.gz: '029130cb8fb140fee2322db3e98ac213c60d675910911f076d83dfb5fbc45b7e'
+  metadata.gz: 91e76cd39a90f6e719e44cd63c03643eb529b9c25f1a76b4aef3c98d2865cd77
+  data.tar.gz: 2ed992519fd3f919483035d21e49ff7aa156d6948809f63ffd1ecf760e9d7363
 SHA512:
-  metadata.gz: 5a2326c249ef795ee99a06efe95142203c3cbadd446828b0242f803cd4760f9d347c17059e416a5547e04b441da70d7260e455231ecd1950a81ad4bb479a2166
-  data.tar.gz: bc1af7e8c96a743d38ce177adc96cffc1940d55bd90b3a4ef632388285425ba23d39a7f4d5cc2d8c5e78626f3cb8c5c3cbd48911019960ec8a9bc736822150ad
+  metadata.gz: 1354e2699e8c0a8fa4ec909e2c25a35048e2f1a6a958a74c45cadf2553eb68e5c9020285443e1b136c829e4acad70608a2d274c65d1962411e3284f7c0ee7a73
+  data.tar.gz: 463a1418ff65f61f8eb4d7ed4c3501015627cc60b46d98adef361c170110e1cd784434e43923949d9a66137f30c8f785f4e612fb7276c7b0a0359f6f8b0a8eea

data/README.md

@@ -69,16 +69,21 @@ 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+.
+This library is supported on Ruby 2.6+.
 
 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
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 
 ## Which client should I use?
 

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.8.0"
+        VERSION = "0.10.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/api/annotations_pb'
-require 'google/protobuf/duration_pb'
-require 'google/protobuf/timestamp_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/api/annotations_pb'
-require 'google/protobuf/struct_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/api/annotations_pb'
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
 require 'google/protobuf/struct_pb'
 require 'google/spanner/v1/keys_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/api/annotations_pb'
-require 'google/protobuf/struct_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,13 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/result_set.proto
 
-require 'google/api/annotations_pb'
+require 'google/protobuf'
+
 require 'google/protobuf/struct_pb'
-require 'google/spanner/v1/commit_response_pb'
 require 'google/spanner/v1/query_plan_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/result_set.proto", :syntax => :proto3) do

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

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/spanner.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -15,7 +17,6 @@ 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/api/annotations_pb'
+require 'google/protobuf'
+
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_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,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/type.proto
 
-require 'google/api/annotations_pb'
-require 'google/api/field_behavior_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

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/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

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

@@ -29,7 +29,8 @@ 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:
         #
         #   1. Locking read-write. This type of transaction is the only way
@@ -38,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
@@ -57,11 +65,12 @@ 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
         # consistent.
@@ -72,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.
         #
@@ -84,6 +93,7 @@ module Google
         # transaction.
         #
         # 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
         # locks for all writes. Cloud Spanner can abort the transaction for any
@@ -95,7 +105,8 @@ 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
         # committing the retry, the client should execute the retry in the
@@ -110,7 +121,8 @@ module Google
         # 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
@@ -121,7 +133,8 @@ module Google
         # 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
         # reads. However, this type of transaction does not support writes.
@@ -153,13 +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
@@ -171,9 +183,13 @@ 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
@@ -194,7 +210,8 @@ 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
         # newest timestamp within the staleness bound that allows execution
@@ -223,7 +240,8 @@ 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
         # as "version GC". By default, version GC reclaims versions after they
@@ -233,7 +251,41 @@ 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,
         # scalability properties for large, table-wide operations than DML in a

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-v1
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-15 00:00:00.000000000 Z
+date: 2022-07-08 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.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -214,14 +214,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Spanner V1 API