google-cloud-spanner-v1 0.2.1 → 0.5.0

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

@@ -33,3 +33,6 @@ module Google
     end
   end
 end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/cloud/spanner/v1/_helpers" if ::File.file? helper_path

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

@@ -63,7 +63,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -71,49 +71,49 @@ module Google
                 default_config.rpcs.create_session.timeout = 30.0
                 default_config.rpcs.create_session.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.batch_create_sessions.timeout = 60.0
                 default_config.rpcs.batch_create_sessions.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.get_session.timeout = 30.0
                 default_config.rpcs.get_session.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.list_sessions.timeout = 3600.0
                 default_config.rpcs.list_sessions.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.delete_session.timeout = 30.0
                 default_config.rpcs.delete_session.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.execute_sql.timeout = 30.0
                 default_config.rpcs.execute_sql.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.execute_streaming_sql.timeout = 3600.0
@@ -121,17 +121,17 @@ module Google
                 default_config.rpcs.execute_batch_dml.timeout = 30.0
                 default_config.rpcs.execute_batch_dml.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.read.timeout = 30.0
                 default_config.rpcs.read.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.streaming_read.timeout = 3600.0
@@ -139,41 +139,41 @@ module Google
                 default_config.rpcs.begin_transaction.timeout = 30.0
                 default_config.rpcs.begin_transaction.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.commit.timeout = 3600.0
                 default_config.rpcs.commit.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.rollback.timeout = 30.0
                 default_config.rpcs.rollback.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.partition_query.timeout = 30.0
                 default_config.rpcs.partition_query.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.partition_read.timeout = 30.0
                 default_config.rpcs.partition_read.retry_policy = {
                   initial_delay: 0.25,
-                  max_delay:     32.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+              max_delay: 32.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config
@@ -237,7 +237,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -686,8 +692,9 @@ module Google
             #     Parameter names and values that bind to placeholders in the SQL string.
             #
             #     A parameter placeholder consists of the `@` character followed by the
-            #     parameter name (for example, `@firstName`). Parameter names can contain
-            #     letters, numbers, and underscores.
+            #     parameter name (for example, `@firstName`). Parameter names must conform
+            #     to the naming requirements of identifiers as specified at
+            #     https://cloud.google.com/spanner/docs/lexical#identifiers.
             #
             #     Parameters can appear anywhere that a literal value is expected.  The same
             #     parameter name can be used more than once, for example:
@@ -820,8 +827,9 @@ module Google
             #     Parameter names and values that bind to placeholders in the SQL string.
             #
             #     A parameter placeholder consists of the `@` character followed by the
-            #     parameter name (for example, `@firstName`). Parameter names can contain
-            #     letters, numbers, and underscores.
+            #     parameter name (for example, `@firstName`). Parameter names must conform
+            #     to the naming requirements of identifiers as specified at
+            #     https://cloud.google.com/spanner/docs/lexical#identifiers.
             #
             #     Parameters can appear anywhere that a literal value is expected.  The same
             #     parameter name can be used more than once, for example:
@@ -1322,6 +1330,12 @@ module Google
             # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
             # the transaction from the beginning, re-using the same session.
             #
+            # On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
+            # for example, if the client job experiences a 1+ hour networking failure.
+            # At that point, Cloud Spanner has lost track of the transaction outcome and
+            # we recommend that you perform another read from the database to see the
+            # state of things as they are now.
+            #
             # @overload commit(request, options = nil)
             #   Pass arguments to `commit` via a request object, either of type
             #   {::Google::Cloud::Spanner::V1::CommitRequest} or an equivalent Hash.
@@ -1332,7 +1346,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload commit(session: nil, transaction_id: nil, single_use_transaction: nil, mutations: nil)
+            # @overload commit(session: nil, transaction_id: nil, single_use_transaction: nil, mutations: nil, return_commit_stats: nil)
             #   Pass arguments to `commit` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1355,6 +1369,10 @@ module Google
             #     The mutations to be executed when this transaction commits. All
             #     mutations are applied atomically, in the order they appear in
             #     this list.
+            #   @param return_commit_stats [::Boolean]
+            #     If `true`, then statistics related to the transaction will be included in
+            #     the {::Google::Cloud::Spanner::V1::CommitResponse#commit_stats CommitResponse}. Default value is
+            #     `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Spanner::V1::CommitResponse]
@@ -1775,14 +1793,14 @@ module Google
 
               config_attr :endpoint,      "spanner.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -1803,7 +1821,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -1815,7 +1833,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -1904,35 +1922,35 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  create_session_config = parent_rpcs&.create_session if parent_rpcs&.respond_to? :create_session
+                  create_session_config = parent_rpcs.create_session if parent_rpcs.respond_to? :create_session
                   @create_session = ::Gapic::Config::Method.new create_session_config
-                  batch_create_sessions_config = parent_rpcs&.batch_create_sessions if parent_rpcs&.respond_to? :batch_create_sessions
+                  batch_create_sessions_config = parent_rpcs.batch_create_sessions if parent_rpcs.respond_to? :batch_create_sessions
                   @batch_create_sessions = ::Gapic::Config::Method.new batch_create_sessions_config
-                  get_session_config = parent_rpcs&.get_session if parent_rpcs&.respond_to? :get_session
+                  get_session_config = parent_rpcs.get_session if parent_rpcs.respond_to? :get_session
                   @get_session = ::Gapic::Config::Method.new get_session_config
-                  list_sessions_config = parent_rpcs&.list_sessions if parent_rpcs&.respond_to? :list_sessions
+                  list_sessions_config = parent_rpcs.list_sessions if parent_rpcs.respond_to? :list_sessions
                   @list_sessions = ::Gapic::Config::Method.new list_sessions_config
-                  delete_session_config = parent_rpcs&.delete_session if parent_rpcs&.respond_to? :delete_session
+                  delete_session_config = parent_rpcs.delete_session if parent_rpcs.respond_to? :delete_session
                   @delete_session = ::Gapic::Config::Method.new delete_session_config
-                  execute_sql_config = parent_rpcs&.execute_sql if parent_rpcs&.respond_to? :execute_sql
+                  execute_sql_config = parent_rpcs.execute_sql if parent_rpcs.respond_to? :execute_sql
                   @execute_sql = ::Gapic::Config::Method.new execute_sql_config
-                  execute_streaming_sql_config = parent_rpcs&.execute_streaming_sql if parent_rpcs&.respond_to? :execute_streaming_sql
+                  execute_streaming_sql_config = parent_rpcs.execute_streaming_sql if parent_rpcs.respond_to? :execute_streaming_sql
                   @execute_streaming_sql = ::Gapic::Config::Method.new execute_streaming_sql_config
-                  execute_batch_dml_config = parent_rpcs&.execute_batch_dml if parent_rpcs&.respond_to? :execute_batch_dml
+                  execute_batch_dml_config = parent_rpcs.execute_batch_dml if parent_rpcs.respond_to? :execute_batch_dml
                   @execute_batch_dml = ::Gapic::Config::Method.new execute_batch_dml_config
-                  read_config = parent_rpcs&.read if parent_rpcs&.respond_to? :read
+                  read_config = parent_rpcs.read if parent_rpcs.respond_to? :read
                   @read = ::Gapic::Config::Method.new read_config
-                  streaming_read_config = parent_rpcs&.streaming_read if parent_rpcs&.respond_to? :streaming_read
+                  streaming_read_config = parent_rpcs.streaming_read if parent_rpcs.respond_to? :streaming_read
                   @streaming_read = ::Gapic::Config::Method.new streaming_read_config
-                  begin_transaction_config = parent_rpcs&.begin_transaction if parent_rpcs&.respond_to? :begin_transaction
+                  begin_transaction_config = parent_rpcs.begin_transaction if parent_rpcs.respond_to? :begin_transaction
                   @begin_transaction = ::Gapic::Config::Method.new begin_transaction_config
-                  commit_config = parent_rpcs&.commit if parent_rpcs&.respond_to? :commit
+                  commit_config = parent_rpcs.commit if parent_rpcs.respond_to? :commit
                   @commit = ::Gapic::Config::Method.new commit_config
-                  rollback_config = parent_rpcs&.rollback if parent_rpcs&.respond_to? :rollback
+                  rollback_config = parent_rpcs.rollback if parent_rpcs.respond_to? :rollback
                   @rollback = ::Gapic::Config::Method.new rollback_config
-                  partition_query_config = parent_rpcs&.partition_query if parent_rpcs&.respond_to? :partition_query
+                  partition_query_config = parent_rpcs.partition_query if parent_rpcs.respond_to? :partition_query
                   @partition_query = ::Gapic::Config::Method.new partition_query_config
-                  partition_read_config = parent_rpcs&.partition_read if parent_rpcs&.respond_to? :partition_read
+                  partition_read_config = parent_rpcs.partition_read if parent_rpcs.respond_to? :partition_read
                   @partition_read = ::Gapic::Config::Method.new partition_read_config
 
                   yield self if block_given?

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Spanner
       module V1
-        VERSION = "0.2.1"
+        VERSION = "0.5.0"
       end
     end
   end

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

@@ -7,6 +7,7 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
@@ -66,6 +67,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.spanner.v1.ExecuteSqlRequest.QueryOptions" do
       optional :optimizer_version, :string, 1
+      optional :optimizer_statistics_package, :string, 2
     end
     add_enum "google.spanner.v1.ExecuteSqlRequest.QueryMode" do
       value :NORMAL, 0
@@ -133,6 +135,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.spanner.v1.CommitRequest" do
       optional :session, :string, 1
       repeated :mutations, :message, 4, "google.spanner.v1.Mutation"
+      optional :return_commit_stats, :bool, 5
       oneof :transaction do
         optional :transaction_id, :bytes, 2
         optional :single_use_transaction, :message, 3, "google.spanner.v1.TransactionOptions"
@@ -140,6 +143,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.spanner.v1.CommitResponse" do
       optional :commit_timestamp, :message, 1, "google.protobuf.Timestamp"
+      optional :commit_stats, :message, 2, "google.spanner.v1.CommitResponse.CommitStats"
+    end
+    add_message "google.spanner.v1.CommitResponse.CommitStats" do
+      optional :mutation_count, :int64, 1
     end
     add_message "google.spanner.v1.RollbackRequest" do
       optional :session, :string, 1
@@ -175,6 +182,7 @@ module Google
         BeginTransactionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.BeginTransactionRequest").msgclass
         CommitRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CommitRequest").msgclass
         CommitResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CommitResponse").msgclass
+        CommitResponse::CommitStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CommitResponse.CommitStats").msgclass
         RollbackRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.RollbackRequest").msgclass
       end
     end

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

@@ -55,22 +55,22 @@ module Google
             #
             # Idle sessions can be kept alive by sending a trivial SQL query
             # periodically, e.g., `"SELECT 1"`.
-            rpc :CreateSession, Google::Cloud::Spanner::V1::CreateSessionRequest, Google::Cloud::Spanner::V1::Session
+            rpc :CreateSession, ::Google::Cloud::Spanner::V1::CreateSessionRequest, ::Google::Cloud::Spanner::V1::Session
             # Creates multiple new sessions.
             #
             # This API can be used to initialize a session cache on the clients.
             # See https://goo.gl/TgSFN2 for best practices on session cache management.
-            rpc :BatchCreateSessions, Google::Cloud::Spanner::V1::BatchCreateSessionsRequest, Google::Cloud::Spanner::V1::BatchCreateSessionsResponse
+            rpc :BatchCreateSessions, ::Google::Cloud::Spanner::V1::BatchCreateSessionsRequest, ::Google::Cloud::Spanner::V1::BatchCreateSessionsResponse
             # Gets a session. Returns `NOT_FOUND` if the session does not exist.
             # This is mainly useful for determining whether a session is still
             # alive.
-            rpc :GetSession, Google::Cloud::Spanner::V1::GetSessionRequest, Google::Cloud::Spanner::V1::Session
+            rpc :GetSession, ::Google::Cloud::Spanner::V1::GetSessionRequest, ::Google::Cloud::Spanner::V1::Session
             # Lists all sessions in a given database.
-            rpc :ListSessions, Google::Cloud::Spanner::V1::ListSessionsRequest, Google::Cloud::Spanner::V1::ListSessionsResponse
+            rpc :ListSessions, ::Google::Cloud::Spanner::V1::ListSessionsRequest, ::Google::Cloud::Spanner::V1::ListSessionsResponse
             # Ends a session, releasing server resources associated with it. This will
             # asynchronously trigger cancellation of any operations that are running with
             # this session.
-            rpc :DeleteSession, Google::Cloud::Spanner::V1::DeleteSessionRequest, Google::Protobuf::Empty
+            rpc :DeleteSession, ::Google::Cloud::Spanner::V1::DeleteSessionRequest, ::Google::Protobuf::Empty
             # Executes an SQL statement, returning all results in a single reply. This
             # method cannot be used to return a result set larger than 10 MiB;
             # if the query yields more data than that, the query fails with
@@ -82,13 +82,13 @@ module Google
             #
             # Larger result sets can be fetched in streaming fashion by calling
             # [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
-            rpc :ExecuteSql, Google::Cloud::Spanner::V1::ExecuteSqlRequest, Google::Cloud::Spanner::V1::ResultSet
+            rpc :ExecuteSql, ::Google::Cloud::Spanner::V1::ExecuteSqlRequest, ::Google::Cloud::Spanner::V1::ResultSet
             # Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the result
             # set as a stream. Unlike [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there
             # is no limit on the size of the returned result set. However, no
             # individual row in the result set can exceed 100 MiB, and no
             # column value can exceed 10 MiB.
-            rpc :ExecuteStreamingSql, Google::Cloud::Spanner::V1::ExecuteSqlRequest, stream(Google::Cloud::Spanner::V1::PartialResultSet)
+            rpc :ExecuteStreamingSql, ::Google::Cloud::Spanner::V1::ExecuteSqlRequest, stream(::Google::Cloud::Spanner::V1::PartialResultSet)
             # Executes a batch of SQL DML statements. This method allows many statements
             # to be run with lower latency than submitting them sequentially with
             # [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
@@ -100,7 +100,7 @@ module Google
             #
             # Execution stops after the first failed statement; the remaining statements
             # are not executed.
-            rpc :ExecuteBatchDml, Google::Cloud::Spanner::V1::ExecuteBatchDmlRequest, Google::Cloud::Spanner::V1::ExecuteBatchDmlResponse
+            rpc :ExecuteBatchDml, ::Google::Cloud::Spanner::V1::ExecuteBatchDmlRequest, ::Google::Cloud::Spanner::V1::ExecuteBatchDmlResponse
             # Reads rows from the database using key lookups and scans, as a
             # simple key/value style alternative to
             # [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be used to
@@ -114,18 +114,18 @@ module Google
             #
             # Larger result sets can be yielded in streaming fashion by calling
             # [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
-            rpc :Read, Google::Cloud::Spanner::V1::ReadRequest, Google::Cloud::Spanner::V1::ResultSet
+            rpc :Read, ::Google::Cloud::Spanner::V1::ReadRequest, ::Google::Cloud::Spanner::V1::ResultSet
             # Like [Read][google.spanner.v1.Spanner.Read], except returns the result set as a
             # stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no limit on the
             # size of the returned result set. However, no individual row in
             # the result set can exceed 100 MiB, and no column value can exceed
             # 10 MiB.
-            rpc :StreamingRead, Google::Cloud::Spanner::V1::ReadRequest, stream(Google::Cloud::Spanner::V1::PartialResultSet)
+            rpc :StreamingRead, ::Google::Cloud::Spanner::V1::ReadRequest, stream(::Google::Cloud::Spanner::V1::PartialResultSet)
             # Begins a new transaction. This step can often be skipped:
             # [Read][google.spanner.v1.Spanner.Read], [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
             # [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
             # side-effect.
-            rpc :BeginTransaction, Google::Cloud::Spanner::V1::BeginTransactionRequest, Google::Cloud::Spanner::V1::Transaction
+            rpc :BeginTransaction, ::Google::Cloud::Spanner::V1::BeginTransactionRequest, ::Google::Cloud::Spanner::V1::Transaction
             # Commits a transaction. The request includes the mutations to be
             # applied to rows in the database.
             #
@@ -134,7 +134,13 @@ module Google
             # transactions. However, it can also happen for a variety of other
             # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
             # the transaction from the beginning, re-using the same session.
-            rpc :Commit, Google::Cloud::Spanner::V1::CommitRequest, Google::Cloud::Spanner::V1::CommitResponse
+            #
+            # On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
+            # for example, if the client job experiences a 1+ hour networking failure.
+            # At that point, Cloud Spanner has lost track of the transaction outcome and
+            # we recommend that you perform another read from the database to see the
+            # state of things as they are now.
+            rpc :Commit, ::Google::Cloud::Spanner::V1::CommitRequest, ::Google::Cloud::Spanner::V1::CommitResponse
             # Rolls back a transaction, releasing any locks it holds. It is a good
             # idea to call this for any transaction that includes one or more
             # [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and
@@ -143,7 +149,7 @@ module Google
             # `Rollback` returns `OK` if it successfully aborts the transaction, the
             # transaction was already aborted, or the transaction is not
             # found. `Rollback` never returns `ABORTED`.
-            rpc :Rollback, Google::Cloud::Spanner::V1::RollbackRequest, Google::Protobuf::Empty
+            rpc :Rollback, ::Google::Cloud::Spanner::V1::RollbackRequest, ::Google::Protobuf::Empty
             # Creates a set of partition tokens that can be used to execute a query
             # operation in parallel.  Each of the returned partition tokens can be used
             # by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset
@@ -155,7 +161,7 @@ module Google
             # is deleted, is idle for too long, begins a new transaction, or becomes too
             # old.  When any of these happen, it is not possible to resume the query, and
             # the whole operation must be restarted from the beginning.
-            rpc :PartitionQuery, Google::Cloud::Spanner::V1::PartitionQueryRequest, Google::Cloud::Spanner::V1::PartitionResponse
+            rpc :PartitionQuery, ::Google::Cloud::Spanner::V1::PartitionQueryRequest, ::Google::Cloud::Spanner::V1::PartitionResponse
             # Creates a set of partition tokens that can be used to execute a read
             # operation in parallel.  Each of the returned partition tokens can be used
             # by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
@@ -169,7 +175,7 @@ module Google
             # is deleted, is idle for too long, begins a new transaction, or becomes too
             # old.  When any of these happen, it is not possible to resume the read, and
             # the whole operation must be restarted from the beginning.
-            rpc :PartitionRead, Google::Cloud::Spanner::V1::PartitionReadRequest, Google::Cloud::Spanner::V1::PartitionResponse
+            rpc :PartitionRead, ::Google::Cloud::Spanner::V1::PartitionReadRequest, ::Google::Cloud::Spanner::V1::PartitionResponse
           end
 
           Stub = Service.rpc_stub_class