google-cloud-spanner 1.12.0 → 1.12.2

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

@@ -172,8 +172,7 @@ module Google
       # reads should be executed within a transaction or at an exact read
       # timestamp.
       #
-      # See
-      # {Google::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions::ReadOnly#strong}.
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions::ReadOnly#strong}.
       #
       # === Exact Staleness
       #
@@ -194,9 +193,7 @@ module Google
       # equivalent boundedly stale concurrency modes. On the other hand,
       # boundedly stale reads usually return fresher results.
       #
-      # See
-      # {Google::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions::ReadOnly#read_timestamp}
-      # and
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions::ReadOnly#read_timestamp} and
       # {Google::Spanner::V1::TransactionOptions::ReadOnly#exact_staleness TransactionOptions::ReadOnly#exact_staleness}.
       #
       # === Bounded Staleness
@@ -226,9 +223,7 @@ module Google
       # which rows will be read, it can only be used with single-use
       # read-only transactions.
       #
-      # See
-      # {Google::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions::ReadOnly#max_staleness}
-      # and
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions::ReadOnly#max_staleness} and
       # {Google::Spanner::V1::TransactionOptions::ReadOnly#min_read_timestamp TransactionOptions::ReadOnly#min_read_timestamp}.
       #
       # === Old Read Timestamps and Garbage Collection
@@ -388,8 +383,7 @@ module Google
         # @!attribute [rw] return_read_timestamp
         #   @return [true, false]
         #     If true, the Cloud Spanner-selected read timestamp is included in
-        #     the {Google::Spanner::V1::Transaction Transaction} message that describes
-        #     the transaction.
+        #     the {Google::Spanner::V1::Transaction Transaction} message that describes the transaction.
         class ReadOnly; end
       end
 
@@ -418,8 +412,7 @@ module Google
       # {Google::Spanner::V1::Spanner::Read Read} or
       # {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql} call runs.
       #
-      # See {Google::Spanner::V1::TransactionOptions TransactionOptions} for more
-      # information about transactions.
+      # See {Google::Spanner::V1::TransactionOptions TransactionOptions} for more information about transactions.
       # @!attribute [rw] single_use
       #   @return [Google::Spanner::V1::TransactionOptions]
       #     Execute the read or SQL query in a temporary transaction.
@@ -432,8 +425,7 @@ module Google
       #   @return [Google::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::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata#transaction},
-      #     which is a {Google::Spanner::V1::Transaction Transaction}.
+      #     {Google::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata#transaction}, which is a {Google::Spanner::V1::Transaction Transaction}.
       class TransactionSelector; end
     end
   end

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

@@ -23,26 +23,23 @@ module Google
       #     Required. The {Google::Spanner::V1::TypeCode TypeCode} for this type.
       # @!attribute [rw] array_element_type
       #   @return [Google::Spanner::V1::Type]
-      #     If {Google::Spanner::V1::Type#code code} ==
-      #     {Google::Spanner::V1::TypeCode::ARRAY ARRAY}, then `array_element_type` is the
-      #     type of the array elements.
+      #     If {Google::Spanner::V1::Type#code code} == {Google::Spanner::V1::TypeCode::ARRAY ARRAY}, then `array_element_type`
+      #     is the type of the array elements.
       # @!attribute [rw] struct_type
       #   @return [Google::Spanner::V1::StructType]
-      #     If {Google::Spanner::V1::Type#code code} ==
-      #     {Google::Spanner::V1::TypeCode::STRUCT STRUCT}, then `struct_type` provides
-      #     type information for the struct's fields.
+      #     If {Google::Spanner::V1::Type#code code} == {Google::Spanner::V1::TypeCode::STRUCT STRUCT}, then `struct_type`
+      #     provides type information for the struct's fields.
       class Type; end
 
-      # `StructType` defines the fields of a
-      # {Google::Spanner::V1::TypeCode::STRUCT STRUCT} type.
+      # `StructType` defines the fields of a {Google::Spanner::V1::TypeCode::STRUCT STRUCT} type.
       # @!attribute [rw] fields
       #   @return [Array<Google::Spanner::V1::StructType::Field>]
       #     The list of fields that make up this struct. Order is
       #     significant, because values of this struct type are represented as
       #     lists, where the order of field values matches the order of
-      #     fields in the {Google::Spanner::V1::StructType StructType}. In turn, the
-      #     order of fields matches the order of columns in a read request, or the
-      #     order of fields in the `SELECT` clause of a query.
+      #     fields in the {Google::Spanner::V1::StructType StructType}. In turn, the order of fields
+      #     matches the order of columns in a read request, or the order of
+      #     fields in the `SELECT` clause of a query.
       class StructType
         # Message representing a single field of a struct.
         # @!attribute [rw] name

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

@@ -356,8 +356,8 @@ module Google
           # transaction internally, and count toward the one transaction
           # limit.
           #
-          # Cloud Spanner limits the number of sessions that can exist at any given
-          # time; thus, it is a good idea to delete idle and/or unneeded sessions.
+          # Active sessions use additional server resources, so it is a good idea to
+          # delete idle and unneeded sessions.
           # Aside from explicit deletes, Cloud Spanner can delete sessions for which no
           # operations are sent for more than an hour. If a session is deleted,
           # requests to it return `NOT_FOUND`.
@@ -605,28 +605,26 @@ module Google
           #   For queries, if none is provided, the default is a temporary read-only
           #   transaction with strong concurrency.
           #
-          #   Standard DML statements require a ReadWrite transaction. Single-use
-          #   transactions are not supported (to avoid replay).  The caller must
-          #   either supply an existing transaction ID or begin a new transaction.
+          #   Standard DML statements require a read-write transaction. To protect
+          #   against replays, single-use transactions are not supported.  The caller
+          #   must either supply an existing transaction ID or begin a new transaction.
           #
-          #   Partitioned DML requires an existing PartitionedDml transaction ID.
+          #   Partitioned DML requires an existing Partitioned DML transaction ID.
           #   A hash of the same form as `Google::Spanner::V1::TransactionSelector`
           #   can also be provided.
           # @param params [Google::Protobuf::Struct | Hash]
-          #   The SQL string can contain parameter placeholders. A parameter
-          #   placeholder consists of `'@'` followed by the parameter
-          #   name. Parameter names consist of any combination of letters,
-          #   numbers, and underscores.
+          #   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.
           #
           #   Parameters can appear anywhere that a literal value is expected.  The same
           #   parameter name can be used more than once, for example:
-          #     `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   It is an error to execute an SQL statement with unbound parameters.
+          #   `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   Parameter values are specified using `params`, which is a JSON
-          #   object whose keys are parameter names, and whose values are the
-          #   corresponding parameter values.
+          #   It is an error to execute a SQL statement with unbound parameters.
           #   A hash of the same form as `Google::Protobuf::Struct`
           #   can also be provided.
           # @param param_types [Hash{String => Google::Spanner::V1::Type | Hash}]
@@ -661,7 +659,7 @@ module Google
           #   match for the values of fields common to this message and the
           #   PartitionQueryRequest message used to create this partition_token.
           # @param seqno [Integer]
-          #   A per-transaction sequence number used to identify this request. This
+          #   A per-transaction sequence number used to identify this request. This field
           #   makes each request idempotent such that if the request is received multiple
           #   times, at most one will succeed.
           #
@@ -732,28 +730,26 @@ module Google
           #   For queries, if none is provided, the default is a temporary read-only
           #   transaction with strong concurrency.
           #
-          #   Standard DML statements require a ReadWrite transaction. Single-use
-          #   transactions are not supported (to avoid replay).  The caller must
-          #   either supply an existing transaction ID or begin a new transaction.
+          #   Standard DML statements require a read-write transaction. To protect
+          #   against replays, single-use transactions are not supported.  The caller
+          #   must either supply an existing transaction ID or begin a new transaction.
           #
-          #   Partitioned DML requires an existing PartitionedDml transaction ID.
+          #   Partitioned DML requires an existing Partitioned DML transaction ID.
           #   A hash of the same form as `Google::Spanner::V1::TransactionSelector`
           #   can also be provided.
           # @param params [Google::Protobuf::Struct | Hash]
-          #   The SQL string can contain parameter placeholders. A parameter
-          #   placeholder consists of `'@'` followed by the parameter
-          #   name. Parameter names consist of any combination of letters,
-          #   numbers, and underscores.
+          #   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.
           #
           #   Parameters can appear anywhere that a literal value is expected.  The same
           #   parameter name can be used more than once, for example:
-          #     `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   It is an error to execute an SQL statement with unbound parameters.
+          #   `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   Parameter values are specified using `params`, which is a JSON
-          #   object whose keys are parameter names, and whose values are the
-          #   corresponding parameter values.
+          #   It is an error to execute a SQL statement with unbound parameters.
           #   A hash of the same form as `Google::Protobuf::Struct`
           #   can also be provided.
           # @param param_types [Hash{String => Google::Spanner::V1::Type | Hash}]
@@ -788,7 +784,7 @@ module Google
           #   match for the values of fields common to this message and the
           #   PartitionQueryRequest message used to create this partition_token.
           # @param seqno [Integer]
-          #   A per-transaction sequence number used to identify this request. This
+          #   A per-transaction sequence number used to identify this request. This field
           #   makes each request idempotent such that if the request is received multiple
           #   times, at most one will succeed.
           #
@@ -847,45 +843,43 @@ module Google
           # to be run with lower latency than submitting them sequentially with
           # {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql}.
           #
-          # Statements are executed in order, sequentially.
-          # {Spanner::ExecuteBatchDmlResponse ExecuteBatchDmlResponse} will contain a
-          # {Google::Spanner::V1::ResultSet ResultSet} for each DML statement that has
-          # successfully executed. If a statement fails, its error status will be
-          # returned as part of the
-          # {Spanner::ExecuteBatchDmlResponse ExecuteBatchDmlResponse}. Execution will
-          # stop at the first failed statement; the remaining statements will not run.
-          #
-          # ExecuteBatchDml is expected to return an OK status with a response even if
-          # there was an error while processing one of the DML statements. Clients must
-          # inspect response.status to determine if there were any errors while
-          # processing the request.
+          # Statements are executed in sequential order. A request can succeed even if
+          # a statement fails. The
+          # {Google::Spanner::V1::ExecuteBatchDmlResponse#status ExecuteBatchDmlResponse#status}
+          # field in the response provides information about the statement that failed.
+          # Clients must inspect this field to determine whether an error occurred.
           #
-          # See more details in
-          # {Spanner::ExecuteBatchDmlRequest ExecuteBatchDmlRequest} and
-          # {Spanner::ExecuteBatchDmlResponse ExecuteBatchDmlResponse}.
+          # Execution stops after the first failed statement; the remaining statements
+          # are not executed.
           #
           # @param session [String]
           #   Required. The session in which the DML statements should be performed.
           # @param transaction [Google::Spanner::V1::TransactionSelector | Hash]
-          #   The transaction to use. A ReadWrite transaction is required. Single-use
-          #   transactions are not supported (to avoid replay).  The caller must either
-          #   supply an existing transaction ID or begin a new transaction.
+          #   Required. The transaction to use. Must be a read-write transaction.
+          #
+          #   To protect against replays, single-use transactions are not supported. The
+          #   caller must either supply an existing transaction ID or begin a new
+          #   transaction.
           #   A hash of the same form as `Google::Spanner::V1::TransactionSelector`
           #   can also be provided.
           # @param statements [Array<Google::Spanner::V1::ExecuteBatchDmlRequest::Statement | Hash>]
-          #   The list of statements to execute in this batch. Statements are executed
-          #   serially, such that the effects of statement i are visible to statement
-          #   i+1. Each statement must be a DML statement. Execution will stop at the
-          #   first failed statement; the remaining statements will not run.
+          #   Required. The list of statements to execute in this batch. Statements are
+          #   executed serially, such that the effects of statement `i` are visible to
+          #   statement `i+1`. Each statement must be a DML statement. Execution stops at
+          #   the first failed statement; the remaining statements are not executed.
           #
-          #   REQUIRES: statements_size() > 0.
+          #   Callers must provide at least one statement.
           #   A hash of the same form as `Google::Spanner::V1::ExecuteBatchDmlRequest::Statement`
           #   can also be provided.
           # @param seqno [Integer]
-          #   A per-transaction sequence number used to identify this request. This is
-          #   used in the same space as the seqno in
-          #   {Spanner::ExecuteSqlRequest ExecuteSqlRequest}. See more details
-          #   in {Spanner::ExecuteSqlRequest ExecuteSqlRequest}.
+          #   Required. A per-transaction sequence number used to identify this request.
+          #   This field makes each request idempotent such that if the request is
+          #   received multiple times, at most one will succeed.
+          #
+          #   The sequence number must be monotonically increasing within the
+          #   transaction. If a request arrives for the first time with an out-of-order
+          #   sequence number, the transaction may be aborted. Replays of previously
+          #   handled requests will yield the same response as the first execution.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -947,8 +941,8 @@ module Google
           # @param table [String]
           #   Required. The name of the table in the database to be read.
           # @param columns [Array<String>]
-          #   The columns of {Google::Spanner::V1::ReadRequest#table table} to be returned
-          #   for each row matching this request.
+          #   Required. The columns of {Google::Spanner::V1::ReadRequest#table table} to be
+          #   returned for each row matching this request.
           # @param key_set [Google::Spanner::V1::KeySet | Hash]
           #   Required. `key_set` identifies the rows to be yielded. `key_set` names the
           #   primary keys of the rows in {Google::Spanner::V1::ReadRequest#table table} to
@@ -1058,8 +1052,8 @@ module Google
           # @param table [String]
           #   Required. The name of the table in the database to be read.
           # @param columns [Array<String>]
-          #   The columns of {Google::Spanner::V1::ReadRequest#table table} to be returned
-          #   for each row matching this request.
+          #   Required. The columns of {Google::Spanner::V1::ReadRequest#table table} to be
+          #   returned for each row matching this request.
           # @param key_set [Google::Spanner::V1::KeySet | Hash]
           #   Required. `key_set` identifies the rows to be yielded. `key_set` names the
           #   primary keys of the rows in {Google::Spanner::V1::ReadRequest#table table} to
@@ -1328,8 +1322,8 @@ module Google
           # @param session [String]
           #   Required. The session used to create the partitions.
           # @param sql [String]
-          #   The query request to generate partitions for. The request will fail if
-          #   the query is not root partitionable. The query plan of a root
+          #   Required. The query request to generate partitions for. The request will
+          #   fail if the query is not root partitionable. The query plan of a root
           #   partitionable query has a single distributed union operator. A distributed
           #   union operator conceptually divides one or more tables into multiple
           #   splits, remotely evaluates a subquery independently on each split, and
@@ -1345,20 +1339,18 @@ module Google
           #   A hash of the same form as `Google::Spanner::V1::TransactionSelector`
           #   can also be provided.
           # @param params [Google::Protobuf::Struct | Hash]
-          #   The SQL query string can contain parameter placeholders. A parameter
-          #   placeholder consists of `'@'` followed by the parameter
-          #   name. Parameter names consist of any combination of letters,
-          #   numbers, and underscores.
+          #   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.
           #
           #   Parameters can appear anywhere that a literal value is expected.  The same
           #   parameter name can be used more than once, for example:
-          #     `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   It is an error to execute an SQL query with unbound parameters.
+          #   `"WHERE id > @msg_id AND id < @msg_id + 100"`
           #
-          #   Parameter values are specified using `params`, which is a JSON
-          #   object whose keys are parameter names, and whose values are the
-          #   corresponding parameter values.
+          #   It is an error to execute a SQL statement with unbound parameters.
           #   A hash of the same form as `Google::Protobuf::Struct`
           #   can also be provided.
           # @param param_types [Hash{String => Google::Spanner::V1::Type | Hash}]

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "1.12.0".freeze
+      VERSION = "1.12.2".freeze
     end
   end
 end

data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb

@@ -5,6 +5,9 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'

data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/spanner/admin/database/v1/spanner_database_admin.proto for package 'google.spanner.admin.database.v1'
 # Original file comments:
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -67,24 +68,25 @@ module Google
               # DDL statements. This method does not show pending schema updates, those may
               # be queried using the [Operations][google.longrunning.Operations] API.
               rpc :GetDatabaseDdl, GetDatabaseDdlRequest, GetDatabaseDdlResponse
-              # Sets the access control policy on a database resource. Replaces any
-              # existing policy.
+              # Sets the access control policy on a database resource.
+              # Replaces any existing policy.
               #
-              # Authorization requires `spanner.databases.setIamPolicy` permission on
-              # [resource][google.iam.v1.SetIamPolicyRequest.resource].
+              # Authorization requires `spanner.databases.setIamPolicy`
+              # permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
               rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
-              # Gets the access control policy for a database resource. Returns an empty
-              # policy if a database exists but does not have a policy set.
+              # Gets the access control policy for a database resource.
+              # Returns an empty policy if a database exists but does
+              # not have a policy set.
               #
               # Authorization requires `spanner.databases.getIamPolicy` permission on
               # [resource][google.iam.v1.GetIamPolicyRequest.resource].
               rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
               # Returns permissions that the caller has on the specified database resource.
               #
-              # Attempting this RPC on a non-existent Cloud Spanner database will result in
-              # a NOT_FOUND error if the user has `spanner.databases.list` permission on
-              # the containing Cloud Spanner instance. Otherwise returns an empty set of
-              # permissions.
+              # Attempting this RPC on a non-existent Cloud Spanner database will
+              # result in a NOT_FOUND error if the user has
+              # `spanner.databases.list` permission on the containing Cloud
+              # Spanner instance. Otherwise returns an empty set of permissions.
               rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
             end
 

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb

@@ -5,6 +5,9 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'
@@ -12,9 +15,21 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.admin.instance.v1.ReplicaInfo" do
+    optional :location, :string, 1
+    optional :type, :enum, 2, "google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType"
+    optional :default_leader_location, :bool, 3
+  end
+  add_enum "google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType" do
+    value :TYPE_UNSPECIFIED, 0
+    value :READ_WRITE, 1
+    value :READ_ONLY, 2
+    value :WITNESS, 3
+  end
   add_message "google.spanner.admin.instance.v1.InstanceConfig" do
     optional :name, :string, 1
     optional :display_name, :string, 2
+    repeated :replicas, :message, 3, "google.spanner.admin.instance.v1.ReplicaInfo"
   end
   add_message "google.spanner.admin.instance.v1.Instance" do
     optional :name, :string, 1
@@ -23,6 +38,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :node_count, :int32, 5
     optional :state, :enum, 6, "google.spanner.admin.instance.v1.Instance.State"
     map :labels, :string, :string, 7
+    repeated :endpoint_uris, :string, 8
   end
   add_enum "google.spanner.admin.instance.v1.Instance.State" do
     value :STATE_UNSPECIFIED, 0
@@ -43,6 +59,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_message "google.spanner.admin.instance.v1.GetInstanceRequest" do
     optional :name, :string, 1
+    optional :field_mask, :message, 2, "google.protobuf.FieldMask"
   end
   add_message "google.spanner.admin.instance.v1.CreateInstanceRequest" do
     optional :parent, :string, 1
@@ -85,6 +102,8 @@ module Google
     module Admin
       module Instance
         module V1
+          ReplicaInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ReplicaInfo").msgclass
+          ReplicaInfo::ReplicaType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType").enummodule
           InstanceConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.InstanceConfig").msgclass
           Instance = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance").msgclass
           Instance::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance.State").enummodule