google-cloud-spanner-v1 1.10.0 → 1.10.1

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

@@ -40,13 +40,13 @@ module Google
         #     Required. The database in which the new sessions are created.
         # @!attribute [rw] session_template
         #   @return [::Google::Cloud::Spanner::V1::Session]
-        #     Parameters to be applied to each created session.
+        #     Parameters to apply to each created session.
         # @!attribute [rw] session_count
         #   @return [::Integer]
         #     Required. The number of sessions to be created in this batch call.
-        #     The API may return fewer than the requested number of sessions. If a
+        #     The API can return fewer than the requested number of sessions. If a
         #     specific number of sessions are desired, the client can make additional
-        #     calls to BatchCreateSessions (adjusting
+        #     calls to `BatchCreateSessions` (adjusting
         #     {::Google::Cloud::Spanner::V1::BatchCreateSessionsRequest#session_count session_count}
         #     as necessary).
         class BatchCreateSessionsRequest
@@ -84,20 +84,21 @@ module Google
         #     Output only. The timestamp when the session is created.
         # @!attribute [r] approximate_last_use_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The approximate timestamp when the session is last used. It is
+        #     Output only. The approximate timestamp when the session is last used. It's
         #     typically earlier than the actual last use time.
         # @!attribute [rw] creator_role
         #   @return [::String]
         #     The database role which created this session.
         # @!attribute [rw] multiplexed
         #   @return [::Boolean]
-        #     Optional. If true, specifies a multiplexed session. A multiplexed session
-        #     may be used for multiple, concurrent read-only operations but can not be
-        #     used for read-write transactions, partitioned reads, or partitioned
-        #     queries. Multiplexed sessions can be created via
-        #     {::Google::Cloud::Spanner::V1::Spanner::Client#create_session CreateSession} but not via
-        #     {::Google::Cloud::Spanner::V1::Spanner::Client#batch_create_sessions BatchCreateSessions}.
-        #     Multiplexed sessions may not be deleted nor listed.
+        #     Optional. If `true`, specifies a multiplexed session. Use a multiplexed
+        #     session for multiple, concurrent read-only operations. Don't use them for
+        #     read-write transactions, partitioned reads, or partitioned queries. Use
+        #     {::Google::Cloud::Spanner::V1::Spanner::Client#create_session `sessions.create`} to create
+        #     multiplexed sessions. Don't use
+        #     {::Google::Cloud::Spanner::V1::Spanner::Client#batch_create_sessions BatchCreateSessions} to
+        #     create a multiplexed session. You can't delete or list multiplexed
+        #     sessions.
         class Session
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -183,47 +184,47 @@ module Google
         #   @return [::String]
         #     A per-request tag which can be applied to queries or reads, used for
         #     statistics collection.
-        #     Both request_tag and transaction_tag can be specified for a read or query
-        #     that belongs to a transaction.
-        #     This field is ignored for requests where it's not applicable (e.g.
-        #     CommitRequest).
+        #     Both `request_tag` and `transaction_tag` can be specified for a read or
+        #     query that belongs to a transaction.
+        #     This field is ignored for requests where it's not applicable (for example,
+        #     `CommitRequest`).
         #     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.
+        #     Any leading underscore (_) characters are removed from the string.
         # @!attribute [rw] transaction_tag
         #   @return [::String]
         #     A tag used for statistics collection about this transaction.
-        #     Both request_tag and transaction_tag can be specified for a read or query
-        #     that belongs to a transaction.
+        #     Both `request_tag` and `transaction_tag` can be specified for a read or
+        #     query 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` is
         #     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
+        #     (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.
+        #     Any leading underscore (_) characters are removed from the string.
         class RequestOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # The relative priority for requests. Note that priority is not applicable
+          # The relative priority for requests. Note that priority isn't applicable
           # for {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction}.
           #
-          # The priority acts as a hint to the Cloud Spanner scheduler and does not
+          # The priority acts as a hint to the Cloud Spanner scheduler and doesn't
           # guarantee priority or order of execution. For example:
           #
           # * Some parts of a write operation always execute at `PRIORITY_HIGH`,
-          #   regardless of the specified priority. This may cause you to see an
+          #   regardless of the specified priority. This can cause you to see an
           #   increase in high priority workload even when executing a low priority
           #   request. This can also potentially cause a priority inversion where a
-          #   lower priority request will be fulfilled ahead of a higher priority
+          #   lower priority request is fulfilled ahead of a higher priority
           #   request.
           # * If a transaction contains multiple operations with different priorities,
-          #   Cloud Spanner does not guarantee to process the higher priority
-          #   operations first. There may be other constraints to satisfy, such as
-          #   order of operations.
+          #   Cloud Spanner doesn't guarantee to process the higher priority
+          #   operations first. There might be other constraints to satisfy, such as
+          #   the order of operations.
           module Priority
             # `PRIORITY_UNSPECIFIED` is equivalent to `PRIORITY_HIGH`.
             PRIORITY_UNSPECIFIED = 0
@@ -239,24 +240,24 @@ module Google
           end
         end
 
-        # The DirectedReadOptions can be used to indicate which replicas or regions
+        # The `DirectedReadOptions` can be used to indicate which replicas or regions
         # should be used for non-transactional reads or queries.
         #
-        # DirectedReadOptions may only be specified for a read-only transaction,
-        # otherwise the API will return an `INVALID_ARGUMENT` error.
+        # `DirectedReadOptions` can only be specified for a read-only transaction,
+        # otherwise the API returns an `INVALID_ARGUMENT` error.
         # @!attribute [rw] include_replicas
         #   @return [::Google::Cloud::Spanner::V1::DirectedReadOptions::IncludeReplicas]
-        #     Include_replicas indicates the order of replicas (as they appear in
-        #     this list) to process the request. If auto_failover_disabled is set to
-        #     true and all replicas are exhausted without finding a healthy replica,
-        #     Spanner will wait for a replica in the list to become available, requests
-        #     may fail due to `DEADLINE_EXCEEDED` errors.
+        #     `Include_replicas` indicates the order of replicas (as they appear in
+        #     this list) to process the request. If `auto_failover_disabled` is set to
+        #     `true` and all replicas are exhausted without finding a healthy replica,
+        #     Spanner waits for a replica in the list to become available, requests
+        #     might fail due to `DEADLINE_EXCEEDED` errors.
         #
         #     Note: The following fields are mutually exclusive: `include_replicas`, `exclude_replicas`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] exclude_replicas
         #   @return [::Google::Cloud::Spanner::V1::DirectedReadOptions::ExcludeReplicas]
-        #     Exclude_replicas indicates that specified replicas should be excluded
-        #     from serving requests. Spanner will not route requests to the replicas
+        #     `Exclude_replicas` indicates that specified replicas should be excluded
+        #     from serving requests. Spanner doesn't route requests to the replicas
         #     in this list.
         #
         #     Note: The following fields are mutually exclusive: `exclude_replicas`, `include_replicas`. If a field in that set is populated, all other fields in the set will automatically be cleared.
@@ -275,16 +276,16 @@ module Google
           # Some examples of using replica_selectors are:
           #
           #   * `location:us-east1` --> The "us-east1" replica(s) of any available type
-          #                             will be used to process the request.
-          #   * `type:READ_ONLY`    --> The "READ_ONLY" type replica(s) in nearest
-          #                             available location will be used to process the
+          #                             is used to process the request.
+          #   * `type:READ_ONLY`    --> The "READ_ONLY" type replica(s) in the nearest
+          #                             available location are used to process the
           #                             request.
           #   * `location:us-east1 type:READ_ONLY` --> The "READ_ONLY" type replica(s)
-          #                          in location "us-east1" will be used to process
+          #                          in location "us-east1" is used to process
           #                          the request.
           # @!attribute [rw] location
           #   @return [::String]
-          #     The location or region of the serving requests, e.g. "us-east1".
+          #     The location or region of the serving requests, for example, "us-east1".
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Spanner::V1::DirectedReadOptions::ReplicaSelection::Type]
           #     The type of replica.
@@ -305,16 +306,16 @@ module Google
             end
           end
 
-          # An IncludeReplicas contains a repeated set of ReplicaSelection which
+          # An `IncludeReplicas` contains a repeated set of `ReplicaSelection` which
           # indicates the order in which replicas should be considered.
           # @!attribute [rw] replica_selections
           #   @return [::Array<::Google::Cloud::Spanner::V1::DirectedReadOptions::ReplicaSelection>]
           #     The directed read replica selector.
           # @!attribute [rw] auto_failover_disabled
           #   @return [::Boolean]
-          #     If true, Spanner will not route requests to a replica outside the
-          #     include_replicas list when all of the specified replicas are unavailable
-          #     or unhealthy. Default value is `false`.
+          #     If `true`, Spanner doesn't route requests to a replica outside the
+          #     <`include_replicas` list when all of the specified replicas are
+          #     unavailable or unhealthy. Default value is `false`.
           class IncludeReplicas
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -344,7 +345,7 @@ module Google
         #     transaction with strong concurrency.
         #
         #     Standard DML statements require a read-write transaction. To protect
-        #     against replays, single-use transactions are not supported.  The caller
+        #     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 Partitioned DML transaction ID.
@@ -360,20 +361,20 @@ module Google
         #     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
+        #     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 a SQL statement with unbound parameters.
+        #     It's an error to execute a SQL statement with unbound parameters.
         # @!attribute [rw] param_types
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Spanner::V1::Type}]
-        #     It is not always possible for Cloud Spanner to infer the right SQL type
-        #     from a JSON value.  For example, values of type `BYTES` and values
+        #     It isn't always possible for Cloud Spanner to infer the right SQL type
+        #     from a JSON value. For example, values of type `BYTES` and values
         #     of type `STRING` both appear in
         #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest#params params} as JSON strings.
         #
-        #     In these cases, `param_types` can be used to specify the exact
+        #     In these cases, you can use `param_types` to specify the exact
         #     SQL type for some or all of the SQL statement parameters. See the
         #     definition of {::Google::Cloud::Spanner::V1::Type Type} for more information
         #     about SQL types.
@@ -395,20 +396,20 @@ module Google
         #     {::Google::Cloud::Spanner::V1::ExecuteSqlRequest::QueryMode::NORMAL QueryMode.NORMAL}.
         # @!attribute [rw] partition_token
         #   @return [::String]
-        #     If present, results will be restricted to the specified partition
-        #     previously created using PartitionQuery().  There must be an exact
+        #     If present, results are restricted to the specified partition
+        #     previously created using `PartitionQuery`. There must be an exact
         #     match for the values of fields common to this message and the
-        #     PartitionQueryRequest message used to create this partition_token.
+        #     `PartitionQueryRequest` message used to create this `partition_token`.
         # @!attribute [rw] seqno
         #   @return [::Integer]
         #     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.
+        #     times, at most one succeeds.
         #
         #     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.
+        #     sequence number, the transaction can be aborted. Replays of previously
+        #     handled requests yield the same response as the first execution.
         #
         #     Required for DML statements. Ignored for queries.
         # @!attribute [rw] query_options
@@ -425,19 +426,19 @@ module Google
         #     If this is for a partitioned query and this field is set to `true`, the
         #     request is executed with Spanner Data Boost independent compute resources.
         #
-        #     If the field is set to `true` but the request does not set
+        #     If the field is set to `true` but the request doesn't set
         #     `partition_token`, the API returns an `INVALID_ARGUMENT` error.
         # @!attribute [rw] last_statement
         #   @return [::Boolean]
-        #     Optional. If set to true, this statement marks the end of the transaction.
-        #     The transaction should be committed or aborted after this statement
-        #     executes, and attempts to execute any other requests against this
-        #     transaction (including reads and queries) will be rejected.
+        #     Optional. If set to `true`, this statement marks the end of the
+        #     transaction. After this statement executes, you must commit or abort the
+        #     transaction. Attempts to execute any other requests against this
+        #     transaction (including reads and queries) are rejected.
         #
-        #     For DML statements, setting this option may cause some error reporting to
-        #     be deferred until commit time (e.g. validation of unique constraints).
-        #     Given this, successful execution of a DML statement should not be assumed
-        #     until a subsequent Commit call completes successfully.
+        #     For DML statements, setting this option might cause some error reporting to
+        #     be deferred until commit time (for example, validation of unique
+        #     constraints). Given this, successful execution of a DML statement shouldn't
+        #     be assumed until a subsequent `Commit` call completes successfully.
         class ExecuteSqlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -457,7 +458,7 @@ module Google
           #     overrides the default optimizer version for query execution.
           #
           #     The list of supported optimizer versions can be queried from
-          #     SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS.
+          #     `SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS`.
           #
           #     Executing a SQL statement with an invalid optimizer version fails with
           #     an `INVALID_ARGUMENT` error.
@@ -477,13 +478,13 @@ module Google
           #     Specifying `latest` as a value instructs Cloud Spanner to use the latest
           #     generated statistics package. If not specified, Cloud Spanner uses
           #     the statistics package set at the database level options, or the latest
-          #     package if the database option is not set.
+          #     package if the database option isn't set.
           #
           #     The statistics package requested by the query has to be exempt from
           #     garbage collection. This can be achieved with the following DDL
           #     statement:
           #
-          #     ```
+          #     ```sql
           #     ALTER STATISTICS <package_name> SET OPTIONS (allow_gc=false)
           #     ```
           #
@@ -518,7 +519,7 @@ module Google
 
             # This mode returns the query plan, overall execution statistics,
             # operator level execution statistics along with the results. This has a
-            # performance overhead compared to the other modes. It is not recommended
+            # performance overhead compared to the other modes. It isn't recommended
             # to use this mode for production traffic.
             PROFILE = 2
 
@@ -555,26 +556,26 @@ module Google
         #   @return [::Integer]
         #     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.
+        #     received multiple times, at most one succeeds.
         #
         #     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.
+        #     sequence number, the transaction might be aborted. Replays of previously
+        #     handled requests yield the same response as the first execution.
         # @!attribute [rw] request_options
         #   @return [::Google::Cloud::Spanner::V1::RequestOptions]
         #     Common options for this request.
         # @!attribute [rw] last_statements
         #   @return [::Boolean]
-        #     Optional. If set to true, this request marks the end of the transaction.
-        #     The transaction should be committed or aborted after these statements
-        #     execute, and attempts to execute any other requests against this
-        #     transaction (including reads and queries) will be rejected.
+        #     Optional. If set to `true`, this request marks the end of the transaction.
+        #     After these statements execute, you must commit or abort the transaction.
+        #     Attempts to execute any other requests against this transaction
+        #     (including reads and queries) are rejected.
         #
-        #     Setting this option may cause some error reporting to be deferred until
-        #     commit time (e.g. validation of unique constraints). Given this, successful
-        #     execution of statements should not be assumed until a subsequent Commit
-        #     call completes successfully.
+        #     Setting this option might cause some error reporting to be deferred until
+        #     commit time (for example, validation of unique constraints). Given this,
+        #     successful execution of statements shouldn't be assumed until a subsequent
+        #     `Commit` call completes successfully.
         class ExecuteBatchDmlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -591,16 +592,16 @@ module Google
           #     parameter name (for example, `@firstName`). Parameter names can contain
           #     letters, numbers, and underscores.
           #
-          #     Parameters can appear anywhere that a literal value is expected.  The
+          #     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 a SQL statement with unbound parameters.
+          #     It's an error to execute a SQL statement with unbound parameters.
           # @!attribute [rw] param_types
           #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Spanner::V1::Type}]
-          #     It is not always possible for Cloud Spanner to infer the right SQL type
-          #     from a JSON value.  For example, values of type `BYTES` and values
+          #     It isn't always possible for Cloud Spanner to infer the right SQL type
+          #     from a JSON value. For example, values of type `BYTES` and values
           #     of type `STRING` both appear in
           #     {::Google::Cloud::Spanner::V1::ExecuteBatchDmlRequest::Statement#params params} as
           #     JSON strings.
@@ -672,38 +673,34 @@ module Google
         #     Otherwise, the error status of the first failed statement.
         # @!attribute [rw] precommit_token
         #   @return [::Google::Cloud::Spanner::V1::MultiplexedSessionPrecommitToken]
-        #     Optional. A precommit token will be included if the read-write transaction
-        #     is on a multiplexed session.
-        #     The precommit token with the highest sequence number from this transaction
-        #     attempt should be passed to the
+        #     Optional. A precommit token is included if the read-write transaction
+        #     is on a multiplexed session. Pass the precommit token with the highest
+        #     sequence number from this transaction attempt should be passed to the
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} request for this transaction.
-        #     This feature is not yet supported and will result in an UNIMPLEMENTED
-        #     error.
         class ExecuteBatchDmlResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Options for a PartitionQueryRequest and
-        # PartitionReadRequest.
+        # Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
         # @!attribute [rw] partition_size_bytes
         #   @return [::Integer]
-        #     **Note:** This hint is currently ignored by PartitionQuery and
-        #     PartitionRead requests.
+        #     **Note:** This hint is currently ignored by `PartitionQuery` and
+        #     `PartitionRead` requests.
         #
-        #     The desired data size for each partition generated.  The default for this
-        #     option is currently 1 GiB.  This is only a hint. The actual size of each
-        #     partition may be smaller or larger than this size request.
+        #     The desired data size for each partition generated. The default for this
+        #     option is currently 1 GiB. This is only a hint. The actual size of each
+        #     partition can be smaller or larger than this size request.
         # @!attribute [rw] max_partitions
         #   @return [::Integer]
-        #     **Note:** This hint is currently ignored by PartitionQuery and
-        #     PartitionRead requests.
+        #     **Note:** This hint is currently ignored by `PartitionQuery` and
+        #     `PartitionRead` requests.
         #
-        #     The desired maximum number of partitions to return.  For example, this may
-        #     be set to the number of workers available.  The default for this option
-        #     is currently 10,000. The maximum value is currently 200,000.  This is only
-        #     a hint.  The actual number of partitions returned may be smaller or larger
-        #     than this maximum count request.
+        #     The desired maximum number of partitions to return. For example, this
+        #     might be set to the number of workers available. The default for this
+        #     option is currently 10,000. The maximum value is currently 200,000. This
+        #     is only a hint. The actual number of partitions returned can be smaller or
+        #     larger than this maximum count request.
         class PartitionOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -715,22 +712,23 @@ module Google
         #     Required. The session used to create the partitions.
         # @!attribute [rw] transaction
         #   @return [::Google::Cloud::Spanner::V1::TransactionSelector]
-        #     Read only snapshot transactions are supported, read/write and single use
-        #     transactions are not.
+        #     Read-only snapshot transactions are supported, read and write and
+        #     single-use transactions are not.
         # @!attribute [rw] sql
         #   @return [::String]
-        #     Required. The query request to generate partitions for. The request will
-        #     fail if the query is not root partitionable. For a query to be root
+        #     Required. The query request to generate partitions for. The request fails
+        #     if the query isn't root partitionable. For a query to be root
         #     partitionable, it needs to satisfy a few conditions. For example, if the
         #     query execution plan contains a distributed union operator, then it must be
         #     the first operator in the plan. For more information about other
         #     conditions, see [Read data in
         #     parallel](https://cloud.google.com/spanner/docs/reads#read_data_in_parallel).
         #
-        #     The query request must not contain DML commands, such as INSERT, UPDATE, or
-        #     DELETE. Use
-        #     {::Google::Cloud::Spanner::V1::Spanner::Client#execute_streaming_sql ExecuteStreamingSql} with a
-        #     PartitionedDml transaction for large, partition-friendly DML operations.
+        #     The query request must not contain DML commands, such as `INSERT`,
+        #     `UPDATE`, or `DELETE`. Use
+        #     {::Google::Cloud::Spanner::V1::Spanner::Client#execute_streaming_sql `ExecuteStreamingSql`} with
+        #     a `PartitionedDml` transaction for large, partition-friendly DML
+        #     operations.
         # @!attribute [rw] params
         #   @return [::Google::Protobuf::Struct]
         #     Parameter names and values that bind to placeholders in the SQL string.
@@ -739,16 +737,16 @@ module Google
         #     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
+        #     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 a SQL statement with unbound parameters.
+        #     It's an error to execute a SQL statement with unbound parameters.
         # @!attribute [rw] param_types
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Spanner::V1::Type}]
-        #     It is not always possible for Cloud Spanner to infer the right SQL type
-        #     from a JSON value.  For example, values of type `BYTES` and values
+        #     It isn't always possible for Cloud Spanner to infer the right SQL type
+        #     from a JSON value. For example, values of type `BYTES` and values
         #     of type `STRING` both appear in
         #     {::Google::Cloud::Spanner::V1::PartitionQueryRequest#params params} as JSON strings.
         #
@@ -806,7 +804,7 @@ module Google
         #     {::Google::Cloud::Spanner::V1::PartitionReadRequest#key_set key_set} instead names
         #     index keys in {::Google::Cloud::Spanner::V1::PartitionReadRequest#index index}.
         #
-        #     It is not an error for the `key_set` to name rows that do not
+        #     It isn't an error for the `key_set` to name rows that don't
         #     exist in the database. Read yields nothing for nonexistent rows.
         # @!attribute [rw] partition_options
         #   @return [::Google::Cloud::Spanner::V1::PartitionOptions]
@@ -820,9 +818,9 @@ module Google
         # PartitionResponse.
         # @!attribute [rw] partition_token
         #   @return [::String]
-        #     This token can be passed to Read, StreamingRead, ExecuteSql, or
-        #     ExecuteStreamingSql requests to restrict the results to those identified by
-        #     this partition token.
+        #     This token can be passed to `Read`, `StreamingRead`, `ExecuteSql`, or
+        #     `ExecuteStreamingSql` requests to restrict the results to those identified
+        #     by this partition token.
         class Partition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -877,16 +875,16 @@ module Google
         #     If the {::Google::Cloud::Spanner::V1::ReadRequest#partition_token partition_token}
         #     field is empty, rows are yielded in table primary key order (if
         #     {::Google::Cloud::Spanner::V1::ReadRequest#index index} is empty) or index key order
-        #     (if {::Google::Cloud::Spanner::V1::ReadRequest#index index} is non-empty).  If the
-        #     {::Google::Cloud::Spanner::V1::ReadRequest#partition_token partition_token} field is
-        #     not empty, rows will be yielded in an unspecified order.
+        #     (if {::Google::Cloud::Spanner::V1::ReadRequest#index index} is non-empty). If the
+        #     {::Google::Cloud::Spanner::V1::ReadRequest#partition_token partition_token} field
+        #     isn't empty, rows are yielded in an unspecified order.
         #
-        #     It is not an error for the `key_set` to name rows that do not
+        #     It isn't an error for the `key_set` to name rows that don't
         #     exist in the database. Read yields nothing for nonexistent rows.
         # @!attribute [rw] limit
         #   @return [::Integer]
         #     If greater than zero, only the first `limit` rows are yielded. If `limit`
-        #     is zero, the default is no limit. A limit cannot be specified if
+        #     is zero, the default is no limit. A limit can't be specified if
         #     `partition_token` is set.
         # @!attribute [rw] resume_token
         #   @return [::String]
@@ -898,8 +896,8 @@ module Google
         #     that yielded this token.
         # @!attribute [rw] partition_token
         #   @return [::String]
-        #     If present, results will be restricted to the specified partition
-        #     previously created using PartitionRead().    There must be an exact
+        #     If present, results are restricted to the specified partition
+        #     previously created using `PartitionRead`. There must be an exact
         #     match for the values of fields common to this message and the
         #     PartitionReadRequest message used to create this partition_token.
         # @!attribute [rw] request_options
@@ -913,17 +911,18 @@ module Google
         #     If this is for a partitioned read and this field is set to `true`, the
         #     request is executed with Spanner Data Boost independent compute resources.
         #
-        #     If the field is set to `true` but the request does not set
+        #     If the field is set to `true` but the request doesn't set
         #     `partition_token`, the API returns an `INVALID_ARGUMENT` error.
         # @!attribute [rw] order_by
         #   @return [::Google::Cloud::Spanner::V1::ReadRequest::OrderBy]
         #     Optional. Order for the returned rows.
         #
-        #     By default, Spanner will return result rows in primary key order except for
-        #     PartitionRead requests. For applications that do not require rows to be
+        #     By default, Spanner returns result rows in primary key order except for
+        #     PartitionRead requests. For applications that don't require rows to be
         #     returned in primary key (`ORDER_BY_PRIMARY_KEY`) order, setting
         #     `ORDER_BY_NO_ORDER` option allows Spanner to optimize row retrieval,
-        #     resulting in lower latencies in certain cases (e.g. bulk point lookups).
+        #     resulting in lower latencies in certain cases (for example, bulk point
+        #     lookups).
         # @!attribute [rw] lock_hint
         #   @return [::Google::Cloud::Spanner::V1::ReadRequest::LockHint]
         #     Optional. Lock Hint for the request, it can only be used with read-write
@@ -936,13 +935,13 @@ module Google
           module OrderBy
             # Default value.
             #
-            # ORDER_BY_UNSPECIFIED is equivalent to ORDER_BY_PRIMARY_KEY.
+            # `ORDER_BY_UNSPECIFIED` is equivalent to `ORDER_BY_PRIMARY_KEY`.
             ORDER_BY_UNSPECIFIED = 0
 
             # Read rows are returned in primary key order.
             #
             # In the event that this option is used in conjunction with the
-            # `partition_token` field, the API will return an `INVALID_ARGUMENT` error.
+            # `partition_token` field, the API returns an `INVALID_ARGUMENT` error.
             ORDER_BY_PRIMARY_KEY = 1
 
             # Read rows are returned in any order.
@@ -953,7 +952,7 @@ module Google
           module LockHint
             # Default value.
             #
-            # LOCK_HINT_UNSPECIFIED is equivalent to LOCK_HINT_SHARED.
+            # `LOCK_HINT_UNSPECIFIED` is equivalent to `LOCK_HINT_SHARED`.
             LOCK_HINT_UNSPECIFIED = 0
 
             # Acquire shared locks.
@@ -984,8 +983,8 @@ module Google
             # serialized. Each transaction waits its turn to acquire the lock and
             # avoids getting into deadlock situations.
             #
-            # Because the exclusive lock hint is just a hint, it should not be
-            # considered equivalent to a mutex. In other words, you should not use
+            # Because the exclusive lock hint is just a hint, it shouldn't be
+            # considered equivalent to a mutex. In other words, you shouldn't use
             # Spanner exclusive locks as a mutual exclusion mechanism for the execution
             # of code outside of Spanner.
             #
@@ -1010,17 +1009,15 @@ module Google
         #   @return [::Google::Cloud::Spanner::V1::RequestOptions]
         #     Common options for this request.
         #     Priority is ignored for this request. Setting the priority in this
-        #     request_options struct will not do anything. To set the priority for a
+        #     `request_options` struct doesn't do anything. To set the priority for a
         #     transaction, set it on the reads and writes that are part of this
         #     transaction instead.
         # @!attribute [rw] mutation_key
         #   @return [::Google::Cloud::Spanner::V1::Mutation]
         #     Optional. Required for read-write transactions on a multiplexed session
-        #     that commit mutations but do not perform any reads or queries. Clients
-        #     should randomly select one of the mutations from the mutation set and send
-        #     it as a part of this request.
-        #     This feature is not yet supported and will result in an UNIMPLEMENTED
-        #     error.
+        #     that commit mutations but don't perform any reads or queries. You must
+        #     randomly select one of the mutations from the mutation set and send it as a
+        #     part of this request.
         class BeginTransactionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1042,7 +1039,7 @@ module Google
         #     temporary transaction is non-idempotent. That is, if the
         #     `CommitRequest` is sent to Cloud Spanner more than once (for
         #     instance, due to retries in the application, or in the
-        #     transport library), it is possible that the mutations are
+        #     transport library), it's possible that the mutations are
         #     executed more than once. If this is undesirable, use
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#begin_transaction BeginTransaction} and
         #     {::Google::Cloud::Spanner::V1::Spanner::Client#commit Commit} instead.
@@ -1055,27 +1052,25 @@ module Google
         #     this list.
         # @!attribute [rw] return_commit_stats
         #   @return [::Boolean]
-        #     If `true`, then statistics related to the transaction will be included in
+        #     If `true`, then statistics related to the transaction is included in
         #     the {::Google::Cloud::Spanner::V1::CommitResponse#commit_stats CommitResponse}.
         #     Default value is `false`.
         # @!attribute [rw] max_commit_delay
         #   @return [::Google::Protobuf::Duration]
-        #     Optional. The amount of latency this request is willing to incur in order
-        #     to improve throughput. If this field is not set, Spanner assumes requests
-        #     are relatively latency sensitive and automatically determines an
-        #     appropriate delay time. You can specify a batching delay value between 0
-        #     and 500 ms.
+        #     Optional. The amount of latency this request is configured to incur in
+        #     order to improve throughput. If this field isn't set, Spanner assumes
+        #     requests are relatively latency sensitive and automatically determines an
+        #     appropriate delay time. You can specify a commit delay value between 0 and
+        #     500 ms.
         # @!attribute [rw] request_options
         #   @return [::Google::Cloud::Spanner::V1::RequestOptions]
         #     Common options for this request.
         # @!attribute [rw] precommit_token
         #   @return [::Google::Cloud::Spanner::V1::MultiplexedSessionPrecommitToken]
         #     Optional. If the read-write transaction was executed on a multiplexed
-        #     session, the precommit token with the highest sequence number received in
-        #     this transaction attempt, should be included here. Failing to do so will
-        #     result in a FailedPrecondition error.
-        #     This feature is not yet supported and will result in an UNIMPLEMENTED
-        #     error.
+        #     session, then you must include the precommit token with the highest
+        #     sequence number received in this transaction attempt. Failing to do so
+        #     results in a `FailedPrecondition` error.
         class CommitRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1105,18 +1100,9 @@ module Google
         #     Required. The groups of mutations to be applied.
         # @!attribute [rw] exclude_txn_from_change_streams
         #   @return [::Boolean]
-        #     Optional. When `exclude_txn_from_change_streams` is set to `true`:
-        #      * Mutations from all transactions in this batch write operation will not
-        #      be recorded in change streams with DDL option `allow_txn_exclusion=true`
-        #      that are tracking columns modified by these transactions.
-        #      * Mutations from all transactions in this batch write operation will be
-        #      recorded in change streams with DDL option `allow_txn_exclusion=false or
-        #      not set` that are tracking columns modified by these transactions.
-        #
-        #     When `exclude_txn_from_change_streams` is set to `false` or not set,
-        #     mutations from all transactions in this batch write operation will be
-        #     recorded in all change streams that are tracking columns modified by these
-        #     transactions.
+        #     Optional. If you don't set the `exclude_txn_from_change_streams` option or
+        #     if it's set to `false`, then any change streams monitoring columns modified
+        #     by transactions will capture the updates made within that transaction.
         class BatchWriteRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods