From dae33f59b3be97e8ed2bcad4dfae3a27b6520ce0 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Wed, 27 Aug 2025 02:29:09 +0000 Subject: [PATCH 01/12] chore: Update generation configuration at Wed Aug 27 02:29:02 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index aaf64f3a5c..ea5137f688 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: b738e78ed63effb7d199ed2d61c9e03291b6077f +googleapis_commitish: bf317d7c0066ba9ad66b880f5a9a060673db8cb4 libraries_bom_version: 26.66.0 libraries: - api_shortname: spanner From 4705405813e8174f7fd4cda18b802b1aa283ebea Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Thu, 28 Aug 2025 02:30:45 +0000 Subject: [PATCH 02/12] chore: Update generation configuration at Thu Aug 28 02:30:37 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index ea5137f688..13a86f3695 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: bf317d7c0066ba9ad66b880f5a9a060673db8cb4 +googleapis_commitish: 2b1af6f3f23fb91e40de01c703c09b465b139402 libraries_bom_version: 26.66.0 libraries: - api_shortname: spanner From 448cab91a0f7c203686e0a96a5bd204a727af84a Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Fri, 29 Aug 2025 02:30:10 +0000 Subject: [PATCH 03/12] chore: Update generation configuration at Fri Aug 29 02:30:01 UTC 2025 --- generation_config.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/generation_config.yaml b/generation_config.yaml index 13a86f3695..dc791b42c6 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,6 +1,6 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: 2b1af6f3f23fb91e40de01c703c09b465b139402 -libraries_bom_version: 26.66.0 +googleapis_commitish: 4cf1f99cccc014627af5e8a6c0f80a3e6ec0d268 +libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner name_pretty: Cloud Spanner From 497b935a864762b4887374b8cd5c64ac52656559 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Fri, 29 Aug 2025 02:33:07 +0000 Subject: [PATCH 04/12] chore: generate libraries at Fri Aug 29 02:30:32 UTC 2025 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 836f104fd6..3adfd3137f 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ If you are using Maven without the BOM, add this to your dependencies: If you are using Gradle 5.x or later, add this to your dependencies: ```Groovy -implementation platform('com.google.cloud:libraries-bom:26.66.0') +implementation platform('com.google.cloud:libraries-bom:26.67.0') implementation 'com.google.cloud:google-cloud-spanner' ``` From 51a0f717cb676a77f5c296efde38d466d0923a87 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Sat, 30 Aug 2025 02:26:10 +0000 Subject: [PATCH 05/12] chore: Update generation configuration at Sat Aug 30 02:26:03 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index dc791b42c6..712ebc365f 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: 4cf1f99cccc014627af5e8a6c0f80a3e6ec0d268 +googleapis_commitish: 376467058c288ad34dd7aafa892a95883e4acd0c libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner From 8ab37bbcf673213224ea1d6ac826f7d03bb3c55f Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Sat, 30 Aug 2025 02:29:12 +0000 Subject: [PATCH 06/12] chore: generate libraries at Sat Aug 30 02:26:35 UTC 2025 --- .../cloud/spanner/v1/SpannerClient.java | 201 ++-- .../com/google/spanner/v1/SpannerGrpc.java | 342 +++---- .../v1/BatchCreateSessionsRequest.java | 40 +- .../BatchCreateSessionsRequestOrBuilder.java | 10 +- .../google/spanner/v1/BatchWriteRequest.java | 60 +- .../v1/BatchWriteRequestOrBuilder.java | 15 +- .../spanner/v1/BeginTransactionRequest.java | 120 +-- .../v1/BeginTransactionRequestOrBuilder.java | 30 +- .../com/google/spanner/v1/CommitRequest.java | 248 +++-- .../spanner/v1/CommitRequestOrBuilder.java | 62 +- .../spanner/v1/DirectedReadOptions.java | 248 ++--- .../v1/DirectedReadOptionsOrBuilder.java | 42 +- .../spanner/v1/ExecuteBatchDmlRequest.java | 218 ++--- .../v1/ExecuteBatchDmlRequestOrBuilder.java | 24 +- .../spanner/v1/ExecuteBatchDmlResponse.java | 108 +-- .../v1/ExecuteBatchDmlResponseOrBuilder.java | 27 +- .../google/spanner/v1/ExecuteSqlRequest.java | 330 +++---- .../v1/ExecuteSqlRequestOrBuilder.java | 80 +- .../java/com/google/spanner/v1/KeySet.java | 92 +- .../google/spanner/v1/KeySetOrBuilder.java | 20 +- .../java/com/google/spanner/v1/Mutation.java | 869 ++++++++++-------- .../google/spanner/v1/MutationOrBuilder.java | 75 +- .../java/com/google/spanner/v1/Partition.java | 24 +- .../google/spanner/v1/PartitionOptions.java | 102 +- .../spanner/v1/PartitionOptionsOrBuilder.java | 24 +- .../google/spanner/v1/PartitionOrBuilder.java | 6 +- .../spanner/v1/PartitionQueryRequest.java | 235 ++--- .../v1/PartitionQueryRequestOrBuilder.java | 70 +- .../spanner/v1/PartitionReadRequest.java | 24 +- .../v1/PartitionReadRequestOrBuilder.java | 6 +- .../java/com/google/spanner/v1/PlanNode.java | 244 ++--- .../google/spanner/v1/PlanNodeOrBuilder.java | 24 +- .../java/com/google/spanner/v1/QueryPlan.java | 92 +- .../google/spanner/v1/QueryPlanOrBuilder.java | 20 +- .../com/google/spanner/v1/ReadRequest.java | 197 ++-- .../spanner/v1/ReadRequestOrBuilder.java | 46 +- .../com/google/spanner/v1/RequestOptions.java | 154 ++-- .../spanner/v1/RequestOptionsOrBuilder.java | 40 +- .../java/com/google/spanner/v1/Session.java | 84 +- .../google/spanner/v1/SessionOrBuilder.java | 21 +- .../com/google/spanner/v1/SpannerProto.java | 202 ++-- .../google/spanner/v1/TransactionOptions.java | 10 +- .../main/proto/google/spanner/v1/keys.proto | 4 +- .../proto/google/spanner/v1/mutation.proto | 54 +- .../proto/google/spanner/v1/query_plan.proto | 39 +- .../proto/google/spanner/v1/spanner.proto | 402 ++++---- .../proto/google/spanner/v1/transaction.proto | 5 +- 47 files changed, 2721 insertions(+), 2669 deletions(-) diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/SpannerClient.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/SpannerClient.java index 30bc4d9cc0..68b24a9d06 100644 --- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/SpannerClient.java +++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/SpannerClient.java @@ -99,8 +99,8 @@ *

CreateSession *

Creates a new session. A session can be used to perform transactions that read and/or modify data in a Cloud Spanner database. Sessions are meant to be reused for many consecutive transactions. *

Sessions can only execute one transaction at a time. To execute multiple concurrent read-write/write-only transactions, create multiple sessions. Note that standalone reads and queries use a transaction internally, and count toward the one transaction limit. - *

Active sessions use additional server resources, so it is a good idea to delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no operations are sent for more than an hour. If a session is deleted, requests to it return `NOT_FOUND`. - *

Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `"SELECT 1"`. + *

Active sessions use additional server resources, so it's a good idea to delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no operations are sent for more than an hour. If a session is deleted, requests to it return `NOT_FOUND`. + *

Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, `"SELECT 1"`. * *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    @@ -139,7 +139,7 @@ * * *

    GetSession - *

    Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for determining whether a session is still alive. + *

    Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for determining whether a session is still alive. * *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      @@ -178,7 +178,7 @@ * * *

      DeleteSession - *

      Ends a session, releasing server resources associated with it. This will asynchronously trigger cancellation of any operations that are running with this session. + *

      Ends a session, releasing server resources associated with it. This asynchronously triggers the cancellation of any operations that are running with this session. * *

      Request object method variants only take one parameter, a request object, which must be constructed before the call.

      *
        @@ -197,9 +197,10 @@ * * *

        ExecuteSql - *

        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 a `FAILED_PRECONDITION` error. + *

        Executes an SQL statement, returning all results in a single reply. This method can't be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. *

        Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See [Transaction][google.spanner.v1.Transaction] for more details. - *

        Larger result sets can be fetched in streaming fashion by calling [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead. + *

        Larger result sets can be fetched in streaming fashion by calling [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead. + *

        The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). * *

        Request object method variants only take one parameter, a request object, which must be constructed before the call.

        *
          @@ -213,7 +214,8 @@ * * *

          ExecuteStreamingSql - *

          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. + *

          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. + *

          The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). * *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            @@ -239,7 +241,7 @@ * * *

            Read - *

            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 return a result set larger than 10 MiB; if the read matches more data than that, the read fails with a `FAILED_PRECONDITION` error. + *

            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 can't be used to return a result set larger than 10 MiB; if the read matches more data than that, the read fails with a `FAILED_PRECONDITION` error. *

            Reads inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See [Transaction][google.spanner.v1.Transaction] for more details. *

            Larger result sets can be yielded in streaming fashion by calling [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead. * @@ -285,7 +287,7 @@ * *

            Commit *

            Commits a transaction. The request includes the mutations to be applied to rows in the database. - *

            `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is conflicts with concurrent 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. + *

            `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is conflicts with concurrent transactions. However, it can also happen for a variety of other reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the beginning, reusing 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. * *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            @@ -307,8 +309,8 @@ * * *

            Rollback - *

            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 ultimately decides not to commit. - *

            `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`. + *

            Rolls back a transaction, releasing any locks it holds. It's 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 ultimately decides not to commit. + *

            `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`. * *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              @@ -327,8 +329,8 @@ * * *

              PartitionQuery - *

              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 of the query result to read. The same session and read-only transaction must be used by the PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use the partition tokens. - *

              Partition tokens become invalid when the session used to create them 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. + *

              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 of the query result to read. The same session and read-only transaction must be used by the `PartitionQueryRequest` used to create the partition tokens and the `ExecuteSqlRequests` that use the partition tokens. + *

              Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it isn't possible to resume the query, and the whole operation must be restarted from the beginning. * *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                @@ -342,8 +344,8 @@ * * *

                PartitionRead - *

                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 result to read. The same session and read-only transaction must be used by the PartitionReadRequest used to create the partition tokens and the ReadRequests that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even within each individual StreamingRead call issued with a partition_token. - *

                Partition tokens become invalid when the session used to create them 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. + *

                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 result to read. The same session and read-only transaction must be used by the `PartitionReadRequest` used to create the partition tokens and the `ReadRequests` that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even within each individual `StreamingRead` call issued with a `partition_token`. + *

                Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it isn't possible to resume the read, and the whole operation must be restarted from the beginning. * *

                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                *
                  @@ -357,8 +359,8 @@ * * *

                  BatchWrite - *

                  Batches the supplied mutation groups in a collection of efficient transactions. All mutations in a group are committed atomically. However, mutations across groups can be committed non-atomically in an unspecified order and thus, they must be independent of each other. Partial failure is possible, i.e., some groups may have been committed successfully, while some may have failed. The results of individual batches are streamed into the response as the batches are applied. - *

                  BatchWrite requests are not replay protected, meaning that each mutation group may be applied more than once. Replays of non-idempotent mutations may have undesirable effects. For example, replays of an insert mutation may produce an already exists error or if you use generated or commit timestamp-based keys, it may result in additional rows being added to the mutation's table. We recommend structuring your mutation groups to be idempotent to avoid this issue. + *

                  Batches the supplied mutation groups in a collection of efficient transactions. All mutations in a group are committed atomically. However, mutations across groups can be committed non-atomically in an unspecified order and thus, they must be independent of each other. Partial failure is possible, that is, some groups might have been committed successfully, while some might have failed. The results of individual batches are streamed into the response as the batches are applied. + *

                  `BatchWrite` requests are not replay protected, meaning that each mutation group can be applied more than once. Replays of non-idempotent mutations can have undesirable effects. For example, replays of an insert mutation can produce an already exists error or if you use generated or commit timestamp-based keys, it can result in additional rows being added to the mutation's table. We recommend structuring your mutation groups to be idempotent to avoid this issue. * *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    @@ -477,13 +479,13 @@ public SpannerStub getStub() { * read-write/write-only transactions, create multiple sessions. Note that standalone reads and * queries use a transaction internally, and count toward the one transaction limit. * - *

                    Active sessions use additional server resources, so it is a good idea to delete idle and - * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no + *

                    Active sessions use additional server resources, so it's a good idea to delete idle and + * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, requests to it return * `NOT_FOUND`. * - *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `"SELECT - * 1"`. + *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, + * `"SELECT 1"`. * *

                    Sample code: * @@ -520,13 +522,13 @@ public final Session createSession(DatabaseName database) { * read-write/write-only transactions, create multiple sessions. Note that standalone reads and * queries use a transaction internally, and count toward the one transaction limit. * - *

                    Active sessions use additional server resources, so it is a good idea to delete idle and - * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no + *

                    Active sessions use additional server resources, so it's a good idea to delete idle and + * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, requests to it return * `NOT_FOUND`. * - *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `"SELECT - * 1"`. + *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, + * `"SELECT 1"`. * *

                    Sample code: * @@ -560,13 +562,13 @@ public final Session createSession(String database) { * read-write/write-only transactions, create multiple sessions. Note that standalone reads and * queries use a transaction internally, and count toward the one transaction limit. * - *

                    Active sessions use additional server resources, so it is a good idea to delete idle and - * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no + *

                    Active sessions use additional server resources, so it's a good idea to delete idle and + * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, requests to it return * `NOT_FOUND`. * - *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `"SELECT - * 1"`. + *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, + * `"SELECT 1"`. * *

                    Sample code: * @@ -603,13 +605,13 @@ public final Session createSession(CreateSessionRequest request) { * read-write/write-only transactions, create multiple sessions. Note that standalone reads and * queries use a transaction internally, and count toward the one transaction limit. * - *

                    Active sessions use additional server resources, so it is a good idea to delete idle and - * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no + *

                    Active sessions use additional server resources, so it's a good idea to delete idle and + * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, requests to it return * `NOT_FOUND`. * - *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `"SELECT - * 1"`. + *

                    Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, + * `"SELECT 1"`. * *

                    Sample code: * @@ -660,8 +662,8 @@ public final UnaryCallable createSessionCallable( * * @param database Required. The database in which the new sessions are created. * @param sessionCount 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 specific number of sessions - * are desired, the client can make additional calls to BatchCreateSessions (adjusting + * 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 * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count] as necessary). * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -700,8 +702,8 @@ public final BatchCreateSessionsResponse batchCreateSessions( * * @param database Required. The database in which the new sessions are created. * @param sessionCount 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 specific number of sessions - * are desired, the client can make additional calls to BatchCreateSessions (adjusting + * 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 * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count] as necessary). * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -783,7 +785,7 @@ public final BatchCreateSessionsResponse batchCreateSessions(BatchCreateSessions // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for + * Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for * determining whether a session is still alive. * *

                    Sample code: @@ -811,7 +813,7 @@ public final Session getSession(SessionName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for + * Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for * determining whether a session is still alive. * *

                    Sample code: @@ -838,7 +840,7 @@ public final Session getSession(String name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for + * Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for * determining whether a session is still alive. * *

                    Sample code: @@ -868,7 +870,7 @@ public final Session getSession(GetSessionRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for + * Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for * determining whether a session is still alive. * *

                    Sample code: @@ -1061,7 +1063,7 @@ public final UnaryCallable listSessio // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Ends a session, releasing server resources associated with it. This will asynchronously trigger + * Ends a session, releasing server resources associated with it. This asynchronously triggers the * cancellation of any operations that are running with this session. * *

                    Sample code: @@ -1089,7 +1091,7 @@ public final void deleteSession(SessionName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Ends a session, releasing server resources associated with it. This will asynchronously trigger + * Ends a session, releasing server resources associated with it. This asynchronously triggers the * cancellation of any operations that are running with this session. * *

                    Sample code: @@ -1116,7 +1118,7 @@ public final void deleteSession(String name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Ends a session, releasing server resources associated with it. This will asynchronously trigger + * Ends a session, releasing server resources associated with it. This asynchronously triggers the * cancellation of any operations that are running with this session. * *

                    Sample code: @@ -1146,7 +1148,7 @@ public final void deleteSession(DeleteSessionRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Ends a session, releasing server resources associated with it. This will asynchronously trigger + * Ends a session, releasing server resources associated with it. This asynchronously triggers the * cancellation of any operations that are running with this session. * *

                    Sample code: @@ -1175,7 +1177,7 @@ public final UnaryCallable deleteSessionCallable() // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Executes an SQL statement, returning all results in a single reply. This method cannot be used + * Executes an SQL statement, returning all results in a single reply. This method can't be used * to return a result set larger than 10 MiB; if the query yields more data than that, the query * fails with a `FAILED_PRECONDITION` error. * @@ -1186,6 +1188,9 @@ public final UnaryCallable deleteSessionCallable() *

                    Larger result sets can be fetched in streaming fashion by calling * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead. * + *

                    The query string can be SQL or [Graph Query Language + * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). + * *

                    Sample code: * * 

                    {@code
@@ -1225,7 +1230,7 @@ public final ResultSet executeSql(ExecuteSqlRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Executes an SQL statement, returning all results in a single reply. This method cannot be used
+   * Executes an SQL statement, returning all results in a single reply. This method can't be used
    * to return a result set larger than 10 MiB; if the query yields more data than that, the query
    * fails with a `FAILED_PRECONDITION` error.
    *
@@ -1236,6 +1241,9 @@ public final ResultSet executeSql(ExecuteSqlRequest request) {
    * 
                    Larger result sets can be fetched in streaming fashion by calling
    * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
    *
+   * 
                    The query string can be SQL or [Graph Query Language
+   * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
+   *
    * 
                    Sample code:
    *
    * 
                    {@code
@@ -1279,6 +1287,9 @@ public final UnaryCallable executeSqlCallable() {
    * 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.
    *
+   * 
                    The query string can be SQL or [Graph Query Language
+   * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
+   *
    * 
                    Sample code:
    *
    * 
                    {@code
@@ -1408,9 +1419,9 @@ public final ExecuteBatchDmlResponse executeBatchDml(ExecuteBatchDmlRequest requ
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * 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 return a result set larger than 10 MiB; if the read matches more data than that, the read
-   * fails with a `FAILED_PRECONDITION` error.
+   * alternative to [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be used to
+   * return a result set larger than 10 MiB; if the read matches more data than that, the read fails
+   * with a `FAILED_PRECONDITION` error.
    *
    * 
                    Reads inside read-write transactions might return `ABORTED`. If this occurs, the application
    * should restart the transaction from the beginning. See
@@ -1458,9 +1469,9 @@ public final ResultSet read(ReadRequest request) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * 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 return a result set larger than 10 MiB; if the read matches more data than that, the read
-   * fails with a `FAILED_PRECONDITION` error.
+   * alternative to [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be used to
+   * return a result set larger than 10 MiB; if the read matches more data than that, the read fails
+   * with a `FAILED_PRECONDITION` error.
    *
    * 
                    Reads inside read-write transactions might return `ABORTED`. If this occurs, the application
    * should restart the transaction from the beginning. See
@@ -1687,8 +1698,8 @@ public final UnaryCallable beginTransactio
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1735,8 +1746,8 @@ public final CommitResponse commit(
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1763,7 +1774,7 @@ public final CommitResponse commit(
    * @param singleUseTransaction Execute mutations in a temporary transaction. Note that unlike
    *     commit of a previously-started transaction, commit with a 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
+   *     (for instance, due to retries in the application, or in the transport library), it's
    *     possible that the mutations are executed more than once. If this is undesirable, use
    *     [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and
    *     [Commit][google.spanner.v1.Spanner.Commit] instead.
@@ -1789,8 +1800,8 @@ public final CommitResponse commit(
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1838,8 +1849,8 @@ public final CommitResponse commit(
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1867,7 +1878,7 @@ public final CommitResponse commit(
    * @param singleUseTransaction Execute mutations in a temporary transaction. Note that unlike
    *     commit of a previously-started transaction, commit with a 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
+   *     (for instance, due to retries in the application, or in the transport library), it's
    *     possible that the mutations are executed more than once. If this is undesirable, use
    *     [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and
    *     [Commit][google.spanner.v1.Spanner.Commit] instead.
@@ -1893,8 +1904,8 @@ public final CommitResponse commit(
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1938,8 +1949,8 @@ public final CommitResponse commit(CommitRequest request) {
    *
    * 
                    `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is
    * conflicts with concurrent 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.
+   * reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the
+   * beginning, reusing 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
@@ -1977,13 +1988,13 @@ public final UnaryCallable commitCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any
+   * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately decides not to
    * commit.
    *
    * 
                    `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was
-   * already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`.
+   * already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`.
    *
    * 
                    Sample code:
    *
@@ -2015,13 +2026,13 @@ public final void rollback(SessionName session, ByteString transactionId) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any
+   * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately decides not to
    * commit.
    *
    * 
                    `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was
-   * already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`.
+   * already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`.
    *
    * 
                    Sample code:
    *
@@ -2051,13 +2062,13 @@ public final void rollback(String session, ByteString transactionId) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any
+   * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately decides not to
    * commit.
    *
    * 
                    `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was
-   * already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`.
+   * already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`.
    *
    * 
                    Sample code:
    *
@@ -2087,13 +2098,13 @@ public final void rollback(RollbackRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any
+   * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately decides not to
    * commit.
    *
    * 
                    `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was
-   * already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`.
+   * already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`.
    *
    * 
                    Sample code:
    *
@@ -2126,11 +2137,11 @@ public final UnaryCallable rollbackCallable() {
    * Each of the returned partition tokens can be used by
    * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset of the
    * query result to read. The same session and read-only transaction must be used by the
-   * PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use
-   * the partition tokens.
+   * `PartitionQueryRequest` used to create the partition tokens and the `ExecuteSqlRequests` that
+   * use the partition tokens.
    *
    * 
                    Partition tokens become invalid when the session used to create them is deleted, is idle for
-   * too long, begins a new transaction, or becomes too old. When any of these happen, it is not
+   * too long, begins a new transaction, or becomes too old. When any of these happen, it isn't
    * possible to resume the query, and the whole operation must be restarted from the beginning.
    *
    * 
                    Sample code:
@@ -2169,11 +2180,11 @@ public final PartitionResponse partitionQuery(PartitionQueryRequest request) {
    * Each of the returned partition tokens can be used by
    * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset of the
    * query result to read. The same session and read-only transaction must be used by the
-   * PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use
-   * the partition tokens.
+   * `PartitionQueryRequest` used to create the partition tokens and the `ExecuteSqlRequests` that
+   * use the partition tokens.
    *
    * 
                    Partition tokens become invalid when the session used to create them is deleted, is idle for
-   * too long, begins a new transaction, or becomes too old. When any of these happen, it is not
+   * too long, begins a new transaction, or becomes too old. When any of these happen, it isn't
    * possible to resume the query, and the whole operation must be restarted from the beginning.
    *
    * 
                    Sample code:
@@ -2211,13 +2222,13 @@ public final UnaryCallable partitionQu
    * 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 result
-   * to read. The same session and read-only transaction must be used by the PartitionReadRequest
-   * used to create the partition tokens and the ReadRequests that use the partition tokens. There
+   * to read. The same session and read-only transaction must be used by the `PartitionReadRequest`
+   * used to create the partition tokens and the `ReadRequests` that use the partition tokens. There
    * are no ordering guarantees on rows returned among the returned partition tokens, or even within
-   * each individual StreamingRead call issued with a partition_token.
+   * each individual `StreamingRead` call issued with a `partition_token`.
    *
    * 
                    Partition tokens become invalid when the session used to create them is deleted, is idle for
-   * too long, begins a new transaction, or becomes too old. When any of these happen, it is not
+   * too long, begins a new transaction, or becomes too old. When any of these happen, it isn't
    * possible to resume the read, and the whole operation must be restarted from the beginning.
    *
    * 
                    Sample code:
@@ -2256,13 +2267,13 @@ public final PartitionResponse partitionRead(PartitionReadRequest request) {
    * 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 result
-   * to read. The same session and read-only transaction must be used by the PartitionReadRequest
-   * used to create the partition tokens and the ReadRequests that use the partition tokens. There
+   * to read. The same session and read-only transaction must be used by the `PartitionReadRequest`
+   * used to create the partition tokens and the `ReadRequests` that use the partition tokens. There
    * are no ordering guarantees on rows returned among the returned partition tokens, or even within
-   * each individual StreamingRead call issued with a partition_token.
+   * each individual `StreamingRead` call issued with a `partition_token`.
    *
    * 
                    Partition tokens become invalid when the session used to create them is deleted, is idle for
-   * too long, begins a new transaction, or becomes too old. When any of these happen, it is not
+   * too long, begins a new transaction, or becomes too old. When any of these happen, it isn't
    * possible to resume the read, and the whole operation must be restarted from the beginning.
    *
    * 
                    Sample code:
@@ -2301,14 +2312,14 @@ public final UnaryCallable partitionRea
    * Batches the supplied mutation groups in a collection of efficient transactions. All mutations
    * in a group are committed atomically. However, mutations across groups can be committed
    * non-atomically in an unspecified order and thus, they must be independent of each other.
-   * Partial failure is possible, i.e., some groups may have been committed successfully, while some
-   * may have failed. The results of individual batches are streamed into the response as the
+   * Partial failure is possible, that is, some groups might have been committed successfully, while
+   * some might have failed. The results of individual batches are streamed into the response as the
    * batches are applied.
    *
-   * 
                    BatchWrite requests are not replay protected, meaning that each mutation group may be
-   * applied more than once. Replays of non-idempotent mutations may have undesirable effects. For
-   * example, replays of an insert mutation may produce an already exists error or if you use
-   * generated or commit timestamp-based keys, it may result in additional rows being added to the
+   * 
                    `BatchWrite` requests are not replay protected, meaning that each mutation group can be
+   * applied more than once. Replays of non-idempotent mutations can have undesirable effects. For
+   * example, replays of an insert mutation can produce an already exists error or if you use
+   * generated or commit timestamp-based keys, it can result in additional rows being added to the
    * mutation's table. We recommend structuring your mutation groups to be idempotent to avoid this
    * issue.
    *
diff --git a/grpc-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerGrpc.java b/grpc-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerGrpc.java
index 6f8f8fc542..8eb67081ef 100644
--- a/grpc-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerGrpc.java
+++ b/grpc-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerGrpc.java
@@ -770,13 +770,13 @@ public interface AsyncService {
      * multiple sessions. Note that standalone reads and queries use a
      * transaction internally, and count toward the one transaction
      * limit.
-     * Active sessions use additional server resources, so it is a good idea to
+     * Active sessions use additional server resources, so it's a good idea to
      * delete idle and unneeded sessions.
-     * Aside from explicit deletes, Cloud Spanner may delete sessions for which no
+     * Aside from explicit deletes, Cloud Spanner can delete sessions when no
      * operations are sent for more than an hour. If a session is deleted,
      * requests to it return `NOT_FOUND`.
      * Idle sessions can be kept alive by sending a trivial SQL query
-     * periodically, e.g., `"SELECT 1"`.
+     * periodically, for example, `"SELECT 1"`.
      * 
                    
      */
     default void createSession(
@@ -807,7 +807,7 @@ default void batchCreateSessions(
      *
      *
      * 
                    -     * Gets a session. Returns `NOT_FOUND` if the session does not exist.
+     * Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
      * This is mainly useful for determining whether a session is still
      * alive.
      * 
                    
@@ -836,9 +836,9 @@ default void listSessions(
      *
      *
      * 
                    -     * Ends a session, releasing server resources associated with it. This will
-     * asynchronously trigger cancellation of any operations that are running with
-     * this session.
+     * Ends a session, releasing server resources associated with it. This
+     * asynchronously triggers the cancellation of any operations that are running
+     * with this session.
      * 
                    
      */
     default void deleteSession(
@@ -853,7 +853,7 @@ default void deleteSession(
      *
      * 
                          * 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;
+     * method can't be used to return a result set larger than 10 MiB;
      * if the query yields more data than that, the query fails with
      * a `FAILED_PRECONDITION` error.
      * Operations inside read-write transactions might return `ABORTED`. If
@@ -863,6 +863,8 @@ default void deleteSession(
      * Larger result sets can be fetched in streaming fashion by calling
      * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
      * instead.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      * 
                    
      */
     default void executeSql(
@@ -880,6 +882,8 @@ default void executeSql(
      * [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.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      * 
                    
      */
     default void executeStreamingSql(
@@ -919,7 +923,7 @@ default void executeBatchDml(
      * 
                          * 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
+     * [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be
      * used to return a result set larger than 10 MiB; if the read matches more
      * data than that, the read fails with a `FAILED_PRECONDITION`
      * error.
@@ -982,8 +986,8 @@ default void beginTransaction(
      * `Commit` might return an `ABORTED` error. This can occur at any time;
      * commonly, the cause is conflicts with concurrent
      * 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.
+     * reasons. If `Commit` returns `ABORTED`, the caller should retry
+     * the transaction from the beginning, reusing 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
@@ -1001,13 +1005,13 @@ default void commit(
      *
      *
      * 
                    -     * Rolls back a transaction, releasing any locks it holds. It is a good
+     * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately
      * decides not to commit.
      * `Rollback` returns `OK` if it successfully aborts the transaction, the
-     * transaction was already aborted, or the transaction is not
+     * transaction was already aborted, or the transaction isn't
      * found. `Rollback` never returns `ABORTED`.
      * 
                    
      */
@@ -1022,15 +1026,15 @@ default void rollback(
      *
      * 
                          * 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
+     * operation in parallel. Each of the returned partition tokens can be used
      * by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-     * specify a subset of the query result to read.  The same session and
-     * read-only transaction must be used by the PartitionQueryRequest used to
-     * create the partition tokens and the ExecuteSqlRequests that use the
+     * specify a subset of the query result to read. The same session and
+     * read-only transaction must be used by the `PartitionQueryRequest` used to
+     * create the partition tokens and the `ExecuteSqlRequests` that use the
      * partition tokens.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the query, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1046,17 +1050,17 @@ default void partitionQuery(
      *
      * 
                          * 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
+     * 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 result to read.  The same session and read-only
-     * transaction must be used by the PartitionReadRequest used to create the
-     * partition tokens and the ReadRequests that use the partition tokens.  There
-     * are no ordering guarantees on rows returned among the returned partition
-     * tokens, or even within each individual StreamingRead call issued with a
-     * partition_token.
+     * subset of the read result to read. The same session and read-only
+     * transaction must be used by the `PartitionReadRequest` used to create the
+     * partition tokens and the `ReadRequests` that use the partition tokens.
+     * There are no ordering guarantees on rows returned among the returned
+     * partition tokens, or even within each individual `StreamingRead` call
+     * issued with a `partition_token`.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the read, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1075,14 +1079,14 @@ default void partitionRead(
      * transactions. All mutations in a group are committed atomically. However,
      * mutations across groups can be committed non-atomically in an unspecified
      * order and thus, they must be independent of each other. Partial failure is
-     * possible, i.e., some groups may have been committed successfully, while
-     * some may have failed. The results of individual batches are streamed into
-     * the response as the batches are applied.
-     * BatchWrite requests are not replay protected, meaning that each mutation
-     * group may be applied more than once. Replays of non-idempotent mutations
-     * may have undesirable effects. For example, replays of an insert mutation
-     * may produce an already exists error or if you use generated or commit
-     * timestamp-based keys, it may result in additional rows being added to the
+     * possible, that is, some groups might have been committed successfully,
+     * while some might have failed. The results of individual batches are
+     * streamed into the response as the batches are applied.
+     * `BatchWrite` requests are not replay protected, meaning that each mutation
+     * group can be applied more than once. Replays of non-idempotent mutations
+     * can have undesirable effects. For example, replays of an insert mutation
+     * can produce an already exists error or if you use generated or commit
+     * timestamp-based keys, it can result in additional rows being added to the
      * mutation's table. We recommend structuring your mutation groups to be
      * idempotent to avoid this issue.
      * 
                    
@@ -1143,13 +1147,13 @@ protected SpannerStub build(io.grpc.Channel channel, io.grpc.CallOptions callOpt
      * multiple sessions. Note that standalone reads and queries use a
      * transaction internally, and count toward the one transaction
      * limit.
-     * Active sessions use additional server resources, so it is a good idea to
+     * Active sessions use additional server resources, so it's a good idea to
      * delete idle and unneeded sessions.
-     * Aside from explicit deletes, Cloud Spanner may delete sessions for which no
+     * Aside from explicit deletes, Cloud Spanner can delete sessions when no
      * operations are sent for more than an hour. If a session is deleted,
      * requests to it return `NOT_FOUND`.
      * Idle sessions can be kept alive by sending a trivial SQL query
-     * periodically, e.g., `"SELECT 1"`.
+     * periodically, for example, `"SELECT 1"`.
      *
                    */ public void createSession( @@ -1184,7 +1188,7 @@ public void batchCreateSessions( * * * 
                    -     * Gets a session. Returns `NOT_FOUND` if the session does not exist.
+     * Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
      * This is mainly useful for determining whether a session is still
      * alive.
      *
                    @@ -1216,9 +1220,9 @@ public void listSessions( * * * 
                    -     * Ends a session, releasing server resources associated with it. This will
-     * asynchronously trigger cancellation of any operations that are running with
-     * this session.
+     * Ends a session, releasing server resources associated with it. This
+     * asynchronously triggers the cancellation of any operations that are running
+     * with this session.
      *
                    */ public void deleteSession( @@ -1235,7 +1239,7 @@ public void deleteSession( * * 
                          * 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;
+     * method can't be used to return a result set larger than 10 MiB;
      * if the query yields more data than that, the query fails with
      * a `FAILED_PRECONDITION` error.
      * Operations inside read-write transactions might return `ABORTED`. If
@@ -1245,6 +1249,8 @@ public void deleteSession(
      * Larger result sets can be fetched in streaming fashion by calling
      * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
      * instead.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      *
                    */ public void executeSql( @@ -1263,6 +1269,8 @@ public void executeSql( * [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. + * The query string can be SQL or [Graph Query Language + * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). * */ public void executeStreamingSql( @@ -1306,7 +1314,7 @@ public void executeBatchDml( * 
                          * 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
+     * [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be
      * used to return a result set larger than 10 MiB; if the read matches more
      * data than that, the read fails with a `FAILED_PRECONDITION`
      * error.
@@ -1374,8 +1382,8 @@ public void beginTransaction(
      * `Commit` might return an `ABORTED` error. This can occur at any time;
      * commonly, the cause is conflicts with concurrent
      * 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.
+     * reasons. If `Commit` returns `ABORTED`, the caller should retry
+     * the transaction from the beginning, reusing 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
@@ -1394,13 +1402,13 @@ public void commit(
      *
      *
      * 
                    -     * Rolls back a transaction, releasing any locks it holds. It is a good
+     * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately
      * decides not to commit.
      * `Rollback` returns `OK` if it successfully aborts the transaction, the
-     * transaction was already aborted, or the transaction is not
+     * transaction was already aborted, or the transaction isn't
      * found. `Rollback` never returns `ABORTED`.
      * 
                    
      */
@@ -1416,15 +1424,15 @@ public void rollback(
      *
      * 
                          * 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
+     * operation in parallel. Each of the returned partition tokens can be used
      * by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-     * specify a subset of the query result to read.  The same session and
-     * read-only transaction must be used by the PartitionQueryRequest used to
-     * create the partition tokens and the ExecuteSqlRequests that use the
+     * specify a subset of the query result to read. The same session and
+     * read-only transaction must be used by the `PartitionQueryRequest` used to
+     * create the partition tokens and the `ExecuteSqlRequests` that use the
      * partition tokens.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the query, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1442,17 +1450,17 @@ public void partitionQuery(
      *
      * 
                          * 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
+     * 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 result to read.  The same session and read-only
-     * transaction must be used by the PartitionReadRequest used to create the
-     * partition tokens and the ReadRequests that use the partition tokens.  There
-     * are no ordering guarantees on rows returned among the returned partition
-     * tokens, or even within each individual StreamingRead call issued with a
-     * partition_token.
+     * subset of the read result to read. The same session and read-only
+     * transaction must be used by the `PartitionReadRequest` used to create the
+     * partition tokens and the `ReadRequests` that use the partition tokens.
+     * There are no ordering guarantees on rows returned among the returned
+     * partition tokens, or even within each individual `StreamingRead` call
+     * issued with a `partition_token`.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the read, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1473,14 +1481,14 @@ public void partitionRead(
      * transactions. All mutations in a group are committed atomically. However,
      * mutations across groups can be committed non-atomically in an unspecified
      * order and thus, they must be independent of each other. Partial failure is
-     * possible, i.e., some groups may have been committed successfully, while
-     * some may have failed. The results of individual batches are streamed into
-     * the response as the batches are applied.
-     * BatchWrite requests are not replay protected, meaning that each mutation
-     * group may be applied more than once. Replays of non-idempotent mutations
-     * may have undesirable effects. For example, replays of an insert mutation
-     * may produce an already exists error or if you use generated or commit
-     * timestamp-based keys, it may result in additional rows being added to the
+     * possible, that is, some groups might have been committed successfully,
+     * while some might have failed. The results of individual batches are
+     * streamed into the response as the batches are applied.
+     * `BatchWrite` requests are not replay protected, meaning that each mutation
+     * group can be applied more than once. Replays of non-idempotent mutations
+     * can have undesirable effects. For example, replays of an insert mutation
+     * can produce an already exists error or if you use generated or commit
+     * timestamp-based keys, it can result in additional rows being added to the
      * mutation's table. We recommend structuring your mutation groups to be
      * idempotent to avoid this issue.
      *
                    @@ -1527,13 +1535,13 @@ protected SpannerBlockingV2Stub build( * multiple sessions. Note that standalone reads and queries use a * transaction internally, and count toward the one transaction * limit. - * Active sessions use additional server resources, so it is a good idea to + * Active sessions use additional server resources, so it's a good idea to * delete idle and unneeded sessions. - * Aside from explicit deletes, Cloud Spanner may delete sessions for which no + * Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, * requests to it return `NOT_FOUND`. * Idle sessions can be kept alive by sending a trivial SQL query - * periodically, e.g., `"SELECT 1"`. + * periodically, for example, `"SELECT 1"`. * */ public com.google.spanner.v1.Session createSession( @@ -1561,7 +1569,7 @@ public com.google.spanner.v1.BatchCreateSessionsResponse batchCreateSessions( * * * 
                    -     * Gets a session. Returns `NOT_FOUND` if the session does not exist.
+     * Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
      * This is mainly useful for determining whether a session is still
      * alive.
      *
                    @@ -1589,9 +1597,9 @@ public com.google.spanner.v1.ListSessionsResponse listSessions( * * * 
                    -     * Ends a session, releasing server resources associated with it. This will
-     * asynchronously trigger cancellation of any operations that are running with
-     * this session.
+     * Ends a session, releasing server resources associated with it. This
+     * asynchronously triggers the cancellation of any operations that are running
+     * with this session.
      *
                    */ public com.google.protobuf.Empty deleteSession( @@ -1605,7 +1613,7 @@ public com.google.protobuf.Empty deleteSession( * * 
                          * 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;
+     * method can't be used to return a result set larger than 10 MiB;
      * if the query yields more data than that, the query fails with
      * a `FAILED_PRECONDITION` error.
      * Operations inside read-write transactions might return `ABORTED`. If
@@ -1615,6 +1623,8 @@ public com.google.protobuf.Empty deleteSession(
      * Larger result sets can be fetched in streaming fashion by calling
      * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
      * instead.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      *
                    */ public com.google.spanner.v1.ResultSet executeSql( @@ -1632,6 +1642,8 @@ public com.google.spanner.v1.ResultSet executeSql( * [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. + * The query string can be SQL or [Graph Query Language + * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). * */ @io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918") @@ -1669,7 +1681,7 @@ public com.google.spanner.v1.ExecuteBatchDmlResponse executeBatchDml( * 
                          * 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
+     * [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be
      * used to return a result set larger than 10 MiB; if the read matches more
      * data than that, the read fails with a `FAILED_PRECONDITION`
      * error.
@@ -1730,8 +1742,8 @@ public com.google.spanner.v1.Transaction beginTransaction(
      * `Commit` might return an `ABORTED` error. This can occur at any time;
      * commonly, the cause is conflicts with concurrent
      * 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.
+     * reasons. If `Commit` returns `ABORTED`, the caller should retry
+     * the transaction from the beginning, reusing 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
@@ -1749,13 +1761,13 @@ public com.google.spanner.v1.CommitResponse commit(
      *
      *
      * 
                    -     * Rolls back a transaction, releasing any locks it holds. It is a good
+     * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately
      * decides not to commit.
      * `Rollback` returns `OK` if it successfully aborts the transaction, the
-     * transaction was already aborted, or the transaction is not
+     * transaction was already aborted, or the transaction isn't
      * found. `Rollback` never returns `ABORTED`.
      * 
                    
      */
@@ -1769,15 +1781,15 @@ public com.google.protobuf.Empty rollback(com.google.spanner.v1.RollbackRequest
      *
      * 
                          * 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
+     * operation in parallel. Each of the returned partition tokens can be used
      * by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-     * specify a subset of the query result to read.  The same session and
-     * read-only transaction must be used by the PartitionQueryRequest used to
-     * create the partition tokens and the ExecuteSqlRequests that use the
+     * specify a subset of the query result to read. The same session and
+     * read-only transaction must be used by the `PartitionQueryRequest` used to
+     * create the partition tokens and the `ExecuteSqlRequests` that use the
      * partition tokens.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the query, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1792,17 +1804,17 @@ public com.google.spanner.v1.PartitionResponse partitionQuery(
      *
      * 
                          * 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
+     * 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 result to read.  The same session and read-only
-     * transaction must be used by the PartitionReadRequest used to create the
-     * partition tokens and the ReadRequests that use the partition tokens.  There
-     * are no ordering guarantees on rows returned among the returned partition
-     * tokens, or even within each individual StreamingRead call issued with a
-     * partition_token.
+     * subset of the read result to read. The same session and read-only
+     * transaction must be used by the `PartitionReadRequest` used to create the
+     * partition tokens and the `ReadRequests` that use the partition tokens.
+     * There are no ordering guarantees on rows returned among the returned
+     * partition tokens, or even within each individual `StreamingRead` call
+     * issued with a `partition_token`.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the read, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -1820,14 +1832,14 @@ public com.google.spanner.v1.PartitionResponse partitionRead(
      * transactions. All mutations in a group are committed atomically. However,
      * mutations across groups can be committed non-atomically in an unspecified
      * order and thus, they must be independent of each other. Partial failure is
-     * possible, i.e., some groups may have been committed successfully, while
-     * some may have failed. The results of individual batches are streamed into
-     * the response as the batches are applied.
-     * BatchWrite requests are not replay protected, meaning that each mutation
-     * group may be applied more than once. Replays of non-idempotent mutations
-     * may have undesirable effects. For example, replays of an insert mutation
-     * may produce an already exists error or if you use generated or commit
-     * timestamp-based keys, it may result in additional rows being added to the
+     * possible, that is, some groups might have been committed successfully,
+     * while some might have failed. The results of individual batches are
+     * streamed into the response as the batches are applied.
+     * `BatchWrite` requests are not replay protected, meaning that each mutation
+     * group can be applied more than once. Replays of non-idempotent mutations
+     * can have undesirable effects. For example, replays of an insert mutation
+     * can produce an already exists error or if you use generated or commit
+     * timestamp-based keys, it can result in additional rows being added to the
      * mutation's table. We recommend structuring your mutation groups to be
      * idempotent to avoid this issue.
      *
                    @@ -1873,13 +1885,13 @@ protected SpannerBlockingStub build(io.grpc.Channel channel, io.grpc.CallOptions * multiple sessions. Note that standalone reads and queries use a * transaction internally, and count toward the one transaction * limit. - * Active sessions use additional server resources, so it is a good idea to + * Active sessions use additional server resources, so it's a good idea to * delete idle and unneeded sessions. - * Aside from explicit deletes, Cloud Spanner may delete sessions for which no + * Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, * requests to it return `NOT_FOUND`. * Idle sessions can be kept alive by sending a trivial SQL query - * periodically, e.g., `"SELECT 1"`. + * periodically, for example, `"SELECT 1"`. * */ public com.google.spanner.v1.Session createSession( @@ -1907,7 +1919,7 @@ public com.google.spanner.v1.BatchCreateSessionsResponse batchCreateSessions( * * * 
                    -     * Gets a session. Returns `NOT_FOUND` if the session does not exist.
+     * Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
      * This is mainly useful for determining whether a session is still
      * alive.
      *
                    @@ -1935,9 +1947,9 @@ public com.google.spanner.v1.ListSessionsResponse listSessions( * * * 
                    -     * Ends a session, releasing server resources associated with it. This will
-     * asynchronously trigger cancellation of any operations that are running with
-     * this session.
+     * Ends a session, releasing server resources associated with it. This
+     * asynchronously triggers the cancellation of any operations that are running
+     * with this session.
      *
                    */ public com.google.protobuf.Empty deleteSession( @@ -1951,7 +1963,7 @@ public com.google.protobuf.Empty deleteSession( * * 
                          * 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;
+     * method can't be used to return a result set larger than 10 MiB;
      * if the query yields more data than that, the query fails with
      * a `FAILED_PRECONDITION` error.
      * Operations inside read-write transactions might return `ABORTED`. If
@@ -1961,6 +1973,8 @@ public com.google.protobuf.Empty deleteSession(
      * Larger result sets can be fetched in streaming fashion by calling
      * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
      * instead.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      *
                    */ public com.google.spanner.v1.ResultSet executeSql( @@ -1978,6 +1992,8 @@ public com.google.spanner.v1.ResultSet executeSql( * [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. + * The query string can be SQL or [Graph Query Language + * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). * */ public java.util.Iterator executeStreamingSql( @@ -2014,7 +2030,7 @@ public com.google.spanner.v1.ExecuteBatchDmlResponse executeBatchDml( * 
                          * 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
+     * [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be
      * used to return a result set larger than 10 MiB; if the read matches more
      * data than that, the read fails with a `FAILED_PRECONDITION`
      * error.
@@ -2074,8 +2090,8 @@ public com.google.spanner.v1.Transaction beginTransaction(
      * `Commit` might return an `ABORTED` error. This can occur at any time;
      * commonly, the cause is conflicts with concurrent
      * 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.
+     * reasons. If `Commit` returns `ABORTED`, the caller should retry
+     * the transaction from the beginning, reusing 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
@@ -2093,13 +2109,13 @@ public com.google.spanner.v1.CommitResponse commit(
      *
      *
      * 
                    -     * Rolls back a transaction, releasing any locks it holds. It is a good
+     * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately
      * decides not to commit.
      * `Rollback` returns `OK` if it successfully aborts the transaction, the
-     * transaction was already aborted, or the transaction is not
+     * transaction was already aborted, or the transaction isn't
      * found. `Rollback` never returns `ABORTED`.
      * 
                    
      */
@@ -2113,15 +2129,15 @@ public com.google.protobuf.Empty rollback(com.google.spanner.v1.RollbackRequest
      *
      * 
                          * 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
+     * operation in parallel. Each of the returned partition tokens can be used
      * by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-     * specify a subset of the query result to read.  The same session and
-     * read-only transaction must be used by the PartitionQueryRequest used to
-     * create the partition tokens and the ExecuteSqlRequests that use the
+     * specify a subset of the query result to read. The same session and
+     * read-only transaction must be used by the `PartitionQueryRequest` used to
+     * create the partition tokens and the `ExecuteSqlRequests` that use the
      * partition tokens.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the query, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -2136,17 +2152,17 @@ public com.google.spanner.v1.PartitionResponse partitionQuery(
      *
      * 
                          * 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
+     * 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 result to read.  The same session and read-only
-     * transaction must be used by the PartitionReadRequest used to create the
-     * partition tokens and the ReadRequests that use the partition tokens.  There
-     * are no ordering guarantees on rows returned among the returned partition
-     * tokens, or even within each individual StreamingRead call issued with a
-     * partition_token.
+     * subset of the read result to read. The same session and read-only
+     * transaction must be used by the `PartitionReadRequest` used to create the
+     * partition tokens and the `ReadRequests` that use the partition tokens.
+     * There are no ordering guarantees on rows returned among the returned
+     * partition tokens, or even within each individual `StreamingRead` call
+     * issued with a `partition_token`.
      * Partition tokens become invalid when the session used to create them
      * 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
+     * old. When any of these happen, it isn't possible to resume the read, and
      * the whole operation must be restarted from the beginning.
      * 
                    
      */
@@ -2164,14 +2180,14 @@ public com.google.spanner.v1.PartitionResponse partitionRead(
      * transactions. All mutations in a group are committed atomically. However,
      * mutations across groups can be committed non-atomically in an unspecified
      * order and thus, they must be independent of each other. Partial failure is
-     * possible, i.e., some groups may have been committed successfully, while
-     * some may have failed. The results of individual batches are streamed into
-     * the response as the batches are applied.
-     * BatchWrite requests are not replay protected, meaning that each mutation
-     * group may be applied more than once. Replays of non-idempotent mutations
-     * may have undesirable effects. For example, replays of an insert mutation
-     * may produce an already exists error or if you use generated or commit
-     * timestamp-based keys, it may result in additional rows being added to the
+     * possible, that is, some groups might have been committed successfully,
+     * while some might have failed. The results of individual batches are
+     * streamed into the response as the batches are applied.
+     * `BatchWrite` requests are not replay protected, meaning that each mutation
+     * group can be applied more than once. Replays of non-idempotent mutations
+     * can have undesirable effects. For example, replays of an insert mutation
+     * can produce an already exists error or if you use generated or commit
+     * timestamp-based keys, it can result in additional rows being added to the
      * mutation's table. We recommend structuring your mutation groups to be
      * idempotent to avoid this issue.
      *
                    @@ -2216,13 +2232,13 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c * multiple sessions. Note that standalone reads and queries use a * transaction internally, and count toward the one transaction * limit. - * Active sessions use additional server resources, so it is a good idea to + * Active sessions use additional server resources, so it's a good idea to * delete idle and unneeded sessions. - * Aside from explicit deletes, Cloud Spanner may delete sessions for which no + * Aside from explicit deletes, Cloud Spanner can delete sessions when no * operations are sent for more than an hour. If a session is deleted, * requests to it return `NOT_FOUND`. * Idle sessions can be kept alive by sending a trivial SQL query - * periodically, e.g., `"SELECT 1"`. + * periodically, for example, `"SELECT 1"`. * */ public com.google.common.util.concurrent.ListenableFuture @@ -2251,7 +2267,7 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c * * * 
                    -     * Gets a session. Returns `NOT_FOUND` if the session does not exist.
+     * Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
      * This is mainly useful for determining whether a session is still
      * alive.
      *
                    @@ -2280,9 +2296,9 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c * * * 
                    -     * Ends a session, releasing server resources associated with it. This will
-     * asynchronously trigger cancellation of any operations that are running with
-     * this session.
+     * Ends a session, releasing server resources associated with it. This
+     * asynchronously triggers the cancellation of any operations that are running
+     * with this session.
      *
                    */ public com.google.common.util.concurrent.ListenableFuture @@ -2296,7 +2312,7 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c * * 
                          * 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;
+     * method can't be used to return a result set larger than 10 MiB;
      * if the query yields more data than that, the query fails with
      * a `FAILED_PRECONDITION` error.
      * Operations inside read-write transactions might return `ABORTED`. If
@@ -2306,6 +2322,8 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * Larger result sets can be fetched in streaming fashion by calling
      * [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
      * instead.
+     * The query string can be SQL or [Graph Query Language
+     * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
      *
                    */ public com.google.common.util.concurrent.ListenableFuture @@ -2343,7 +2361,7 @@ protected SpannerFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c * 
                          * 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
+     * [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be
      * used to return a result set larger than 10 MiB; if the read matches more
      * data than that, the read fails with a `FAILED_PRECONDITION`
      * error.
@@ -2387,8 +2405,8 @@ public com.google.common.util.concurrent.ListenableFuture
-     * Rolls back a transaction, releasing any locks it holds. It is a good
+     * Rolls back a transaction, releasing any locks it holds. It's 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 ultimately
      * decides not to commit.
      * `Rollback` returns `OK` if it successfully aborts the transaction, the
-     * transaction was already aborted, or the transaction is not
+     * transaction was already aborted, or the transaction isn't
      * found. `Rollback` never returns `ABORTED`.
      *
                    */ @@ -2427,15 +2445,15 @@ public com.google.common.util.concurrent.ListenableFuture * 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 + * operation in parallel. Each of the returned partition tokens can be used * by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to - * specify a subset of the query result to read. The same session and - * read-only transaction must be used by the PartitionQueryRequest used to - * create the partition tokens and the ExecuteSqlRequests that use the + * specify a subset of the query result to read. The same session and + * read-only transaction must be used by the `PartitionQueryRequest` used to + * create the partition tokens and the `ExecuteSqlRequests` that use the * partition tokens. * Partition tokens become invalid when the session used to create them * 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 + * old. When any of these happen, it isn't possible to resume the query, and * the whole operation must be restarted from the beginning. * */ @@ -2451,17 +2469,17 @@ public com.google.common.util.concurrent.ListenableFuture * 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 + * 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 result to read. The same session and read-only - * transaction must be used by the PartitionReadRequest used to create the - * partition tokens and the ReadRequests that use the partition tokens. There - * are no ordering guarantees on rows returned among the returned partition - * tokens, or even within each individual StreamingRead call issued with a - * partition_token. + * subset of the read result to read. The same session and read-only + * transaction must be used by the `PartitionReadRequest` used to create the + * partition tokens and the `ReadRequests` that use the partition tokens. + * There are no ordering guarantees on rows returned among the returned + * partition tokens, or even within each individual `StreamingRead` call + * issued with a `partition_token`. * Partition tokens become invalid when the session used to create them * 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 + * old. When any of these happen, it isn't possible to resume the read, and * the whole operation must be restarted from the beginning. * */ diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequest.java index 6a6c66a6b3..57ae1ee310 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequest.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequest.java @@ -130,7 +130,7 @@ public com.google.protobuf.ByteString getDatabaseBytes() { * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -146,7 +146,7 @@ public boolean hasSessionTemplate() { * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -164,7 +164,7 @@ public com.google.spanner.v1.Session getSessionTemplate() { * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -184,9 +184,9 @@ public com.google.spanner.v1.SessionOrBuilder getSessionTemplateOrBuilder() { * * 
                        * 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
    * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
    * as necessary).
    *
                    @@ -742,7 +742,7 @@ public Builder setDatabaseBytes(com.google.protobuf.ByteString value) { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -757,7 +757,7 @@ public boolean hasSessionTemplate() { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -778,7 +778,7 @@ public com.google.spanner.v1.Session getSessionTemplate() { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -801,7 +801,7 @@ public Builder setSessionTemplate(com.google.spanner.v1.Session value) { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -821,7 +821,7 @@ public Builder setSessionTemplate(com.google.spanner.v1.Session.Builder builderF * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -849,7 +849,7 @@ public Builder mergeSessionTemplate(com.google.spanner.v1.Session value) { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -869,7 +869,7 @@ public Builder clearSessionTemplate() { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -884,7 +884,7 @@ public com.google.spanner.v1.Session.Builder getSessionTemplateBuilder() { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -903,7 +903,7 @@ public com.google.spanner.v1.SessionOrBuilder getSessionTemplateOrBuilder() { * * * 
                    -     * Parameters to be applied to each created session.
+     * Parameters to apply to each created session.
      *
                    * * .google.spanner.v1.Session session_template = 2; @@ -932,9 +932,9 @@ public com.google.spanner.v1.SessionOrBuilder getSessionTemplateOrBuilder() { * * 
                          * 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
      * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
      * as necessary).
      *
                    @@ -953,9 +953,9 @@ public int getSessionCount() { * * 
                          * 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
      * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
      * as necessary).
      *
                    @@ -978,9 +978,9 @@ public Builder setSessionCount(int value) { * * 
                          * 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
      * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
      * as necessary).
      *
                    diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequestOrBuilder.java index 1b0588c32e..698601c466 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequestOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchCreateSessionsRequestOrBuilder.java @@ -58,7 +58,7 @@ public interface BatchCreateSessionsRequestOrBuilder * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -71,7 +71,7 @@ public interface BatchCreateSessionsRequestOrBuilder * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -84,7 +84,7 @@ public interface BatchCreateSessionsRequestOrBuilder * * * 
                    -   * Parameters to be applied to each created session.
+   * Parameters to apply to each created session.
    *
                    * * .google.spanner.v1.Session session_template = 2; @@ -96,9 +96,9 @@ public interface BatchCreateSessionsRequestOrBuilder * * 
                        * 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
    * [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
    * as necessary).
    *
                    diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequest.java index 82af100d34..8a90552039 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequest.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequest.java @@ -1337,18 +1337,9 @@ public com.google.spanner.v1.BatchWriteRequest.MutationGroupOrBuilder getMutatio * * * 
                    -   * 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.
    *
                    * * bool exclude_txn_from_change_streams = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -2580,18 +2571,9 @@ public com.google.spanner.v1.BatchWriteRequest.MutationGroup.Builder addMutation * * * 
                    -     * 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.
      *
                    * * bool exclude_txn_from_change_streams = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -2608,18 +2590,9 @@ public boolean getExcludeTxnFromChangeStreams() { * * * 
                    -     * 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.
      *
                    * * bool exclude_txn_from_change_streams = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -2640,18 +2613,9 @@ public Builder setExcludeTxnFromChangeStreams(boolean value) { * * * 
                    -     * 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.
      *
                    * * bool exclude_txn_from_change_streams = 5 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequestOrBuilder.java index 2da3283431..6737e384e6 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequestOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BatchWriteRequestOrBuilder.java @@ -162,18 +162,9 @@ com.google.spanner.v1.BatchWriteRequest.MutationGroupOrBuilder getMutationGroups * * * 
                    -   * 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.
    *
                    * * bool exclude_txn_from_change_streams = 5 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequest.java index 7fa457c855..00e7902102 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequest.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequest.java @@ -191,7 +191,7 @@ public com.google.spanner.v1.TransactionOptionsOrBuilder getOptionsOrBuilder() { * 
                        * 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.
    *
                    @@ -211,7 +211,7 @@ public boolean hasRequestOptions() { * 
                        * 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.
    *
                    @@ -233,7 +233,7 @@ public com.google.spanner.v1.RequestOptions getRequestOptions() { * 
                        * 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.
    *
                    @@ -255,11 +255,9 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder( * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -277,11 +275,9 @@ public boolean hasMutationKey() { * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -301,11 +297,9 @@ public com.google.spanner.v1.Mutation getMutationKey() { * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1118,7 +1112,7 @@ public com.google.spanner.v1.TransactionOptionsOrBuilder getOptionsOrBuilder() { * 
                          * 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.
      *
                    @@ -1137,7 +1131,7 @@ public boolean hasRequestOptions() { * 
                          * 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.
      *
                    @@ -1162,7 +1156,7 @@ public com.google.spanner.v1.RequestOptions getRequestOptions() { * 
                          * 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.
      *
                    @@ -1189,7 +1183,7 @@ public Builder setRequestOptions(com.google.spanner.v1.RequestOptions value) { * 
                          * 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.
      *
                    @@ -1213,7 +1207,7 @@ public Builder setRequestOptions(com.google.spanner.v1.RequestOptions.Builder bu * 
                          * 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.
      *
                    @@ -1245,7 +1239,7 @@ public Builder mergeRequestOptions(com.google.spanner.v1.RequestOptions value) { * 
                          * 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.
      *
                    @@ -1269,7 +1263,7 @@ public Builder clearRequestOptions() { * 
                          * 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.
      *
                    @@ -1288,7 +1282,7 @@ public com.google.spanner.v1.RequestOptions.Builder getRequestOptionsBuilder() { * 
                          * 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.
      *
                    @@ -1311,7 +1305,7 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder( * 
                          * 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.
      *
                    @@ -1347,11 +1341,9 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder( * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1368,11 +1360,9 @@ public boolean hasMutationKey() { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1395,11 +1385,9 @@ public com.google.spanner.v1.Mutation getMutationKey() { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1424,11 +1412,9 @@ public Builder setMutationKey(com.google.spanner.v1.Mutation value) { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1450,11 +1436,9 @@ public Builder setMutationKey(com.google.spanner.v1.Mutation.Builder builderForV * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1484,11 +1468,9 @@ public Builder mergeMutationKey(com.google.spanner.v1.Mutation value) { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1510,11 +1492,9 @@ public Builder clearMutationKey() { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1531,11 +1511,9 @@ public com.google.spanner.v1.Mutation.Builder getMutationKeyBuilder() { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1556,11 +1534,9 @@ public com.google.spanner.v1.MutationOrBuilder getMutationKeyOrBuilder() { * * 
                          * 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.
      *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequestOrBuilder.java index c339d7cc25..3290558bc0 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequestOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/BeginTransactionRequestOrBuilder.java @@ -103,7 +103,7 @@ public interface BeginTransactionRequestOrBuilder * 
                        * 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.
    *
                    @@ -120,7 +120,7 @@ public interface BeginTransactionRequestOrBuilder * 
                        * 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.
    *
                    @@ -137,7 +137,7 @@ public interface BeginTransactionRequestOrBuilder * 
                        * 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.
    *
                    @@ -151,11 +151,9 @@ public interface BeginTransactionRequestOrBuilder * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -170,11 +168,9 @@ public interface BeginTransactionRequestOrBuilder * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -189,11 +185,9 @@ public interface BeginTransactionRequestOrBuilder * * 
                        * 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.
    *
                    * * .google.spanner.v1.Mutation mutation_key = 4 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequest.java index 53b0dc7328..297c7a8e28 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequest.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequest.java @@ -221,7 +221,7 @@ public com.google.protobuf.ByteString getTransactionId() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -245,7 +245,7 @@ public boolean hasSingleUseTransaction() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -272,7 +272,7 @@ public com.google.spanner.v1.TransactionOptions getSingleUseTransaction() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -381,7 +381,7 @@ public com.google.spanner.v1.MutationOrBuilder getMutationsOrBuilder(int index) * * * 
                    -   * If `true`, then statistics related to the transaction will be included in
+   * If `true`, then statistics related to the transaction is included in
    * the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats].
    * Default value is `false`.
    *
                    @@ -402,11 +402,11 @@ public boolean getReturnCommitStats() { * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -423,11 +423,11 @@ public boolean hasMaxCommitDelay() { * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -446,11 +446,11 @@ public com.google.protobuf.Duration getMaxCommitDelay() { * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -524,11 +524,9 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder( * * 
                        * 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.
    *
                    * * @@ -547,11 +545,9 @@ public boolean hasPrecommitToken() { * * 
                        * 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.
    *
                    * * @@ -572,11 +568,9 @@ public com.google.spanner.v1.MultiplexedSessionPrecommitToken getPrecommitToken( * * 
                        * 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.
    *
                    * * @@ -1442,7 +1436,7 @@ public Builder clearTransactionId() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1466,7 +1460,7 @@ public boolean hasSingleUseTransaction() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1500,7 +1494,7 @@ public com.google.spanner.v1.TransactionOptions getSingleUseTransaction() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1531,7 +1525,7 @@ public Builder setSingleUseTransaction(com.google.spanner.v1.TransactionOptions * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1560,7 +1554,7 @@ public Builder setSingleUseTransaction( * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1601,7 +1595,7 @@ public Builder mergeSingleUseTransaction(com.google.spanner.v1.TransactionOption * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1635,7 +1629,7 @@ public Builder clearSingleUseTransaction() { * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1656,7 +1650,7 @@ public com.google.spanner.v1.TransactionOptions.Builder getSingleUseTransactionB * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1685,7 +1679,7 @@ public com.google.spanner.v1.TransactionOptionsOrBuilder getSingleUseTransaction * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -2122,7 +2116,7 @@ public java.util.List getMutationsBuilde * * * 
                    -     * If `true`, then statistics related to the transaction will be included in
+     * If `true`, then statistics related to the transaction is included in
      * the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats].
      * Default value is `false`.
      *
                    @@ -2140,7 +2134,7 @@ public boolean getReturnCommitStats() { * * * 
                    -     * If `true`, then statistics related to the transaction will be included in
+     * If `true`, then statistics related to the transaction is included in
      * the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats].
      * Default value is `false`.
      *
                    @@ -2162,7 +2156,7 @@ public Builder setReturnCommitStats(boolean value) { * * * 
                    -     * If `true`, then statistics related to the transaction will be included in
+     * If `true`, then statistics related to the transaction is included in
      * the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats].
      * Default value is `false`.
      *
                    @@ -2189,11 +2183,11 @@ public Builder clearReturnCommitStats() { * * * 
                    -     * 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.
      *
                    * * @@ -2210,11 +2204,11 @@ public boolean hasMaxCommitDelay() { * * * 
                    -     * 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.
      *
                    * * @@ -2237,11 +2231,11 @@ public com.google.protobuf.Duration getMaxCommitDelay() { * * * 
                    -     * 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.
      *
                    * * @@ -2266,11 +2260,11 @@ public Builder setMaxCommitDelay(com.google.protobuf.Duration value) { * * * 
                    -     * 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.
      *
                    * * @@ -2292,11 +2286,11 @@ public Builder setMaxCommitDelay(com.google.protobuf.Duration.Builder builderFor * * * 
                    -     * 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.
      *
                    * * @@ -2326,11 +2320,11 @@ public Builder mergeMaxCommitDelay(com.google.protobuf.Duration value) { * * * 
                    -     * 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.
      *
                    * * @@ -2352,11 +2346,11 @@ public Builder clearMaxCommitDelay() { * * * 
                    -     * 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.
      *
                    * * @@ -2373,11 +2367,11 @@ public com.google.protobuf.Duration.Builder getMaxCommitDelayBuilder() { * * * 
                    -     * 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.
      *
                    * * @@ -2398,11 +2392,11 @@ public com.google.protobuf.DurationOrBuilder getMaxCommitDelayOrBuilder() { * * * 
                    -     * 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.
      *
                    * * @@ -2632,11 +2626,9 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder( * * 
                          * 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.
      *
                    * * @@ -2654,11 +2646,9 @@ public boolean hasPrecommitToken() { * * 
                          * 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.
      *
                    * * @@ -2682,11 +2672,9 @@ public com.google.spanner.v1.MultiplexedSessionPrecommitToken getPrecommitToken( * * 
                          * 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.
      *
                    * * @@ -2712,11 +2700,9 @@ public Builder setPrecommitToken(com.google.spanner.v1.MultiplexedSessionPrecomm * * 
                          * 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.
      *
                    * * @@ -2740,11 +2726,9 @@ public Builder setPrecommitToken( * * 
                          * 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.
      *
                    * * @@ -2777,11 +2761,9 @@ public Builder mergePrecommitToken( * * 
                          * 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.
      *
                    * * @@ -2804,11 +2786,9 @@ public Builder clearPrecommitToken() { * * 
                          * 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.
      *
                    * * @@ -2827,11 +2807,9 @@ public Builder clearPrecommitToken() { * * 
                          * 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.
      *
                    * * @@ -2854,11 +2832,9 @@ public Builder clearPrecommitToken() { * * 
                          * 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.
      *
                    * * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequestOrBuilder.java index a59ee4466b..bde61cc6bc 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequestOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/CommitRequestOrBuilder.java @@ -89,7 +89,7 @@ public interface CommitRequestOrBuilder * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -110,7 +110,7 @@ public interface CommitRequestOrBuilder * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -131,7 +131,7 @@ public interface CommitRequestOrBuilder * 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 * [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and * [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -210,7 +210,7 @@ public interface CommitRequestOrBuilder * * * 
                    -   * If `true`, then statistics related to the transaction will be included in
+   * If `true`, then statistics related to the transaction is included in
    * the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats].
    * Default value is `false`.
    *
                    @@ -225,11 +225,11 @@ public interface CommitRequestOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -243,11 +243,11 @@ public interface CommitRequestOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -261,11 +261,11 @@ public interface CommitRequestOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.protobuf.Duration max_commit_delay = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -315,11 +315,9 @@ public interface CommitRequestOrBuilder * * 
                        * 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.
    *
                    * * @@ -335,11 +333,9 @@ public interface CommitRequestOrBuilder * * 
                        * 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.
    *
                    * * @@ -355,11 +351,9 @@ public interface CommitRequestOrBuilder * * 
                        * 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.
    *
                    * * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptions.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptions.java index f2802f745b..130f6e7c65 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptions.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptions.java @@ -23,11 +23,11 @@ * * * 
                    - * 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.
  *
                    * * Protobuf type {@code google.spanner.v1.DirectedReadOptions} @@ -75,7 +75,7 @@ public interface ReplicaSelectionOrBuilder * * * 
                    -     * The location or region of the serving requests, e.g. "us-east1".
+     * The location or region of the serving requests, for example, "us-east1".
      *
                    * * string location = 1; @@ -88,7 +88,7 @@ public interface ReplicaSelectionOrBuilder * * * 
                    -     * The location or region of the serving requests, e.g. "us-east1".
+     * The location or region of the serving requests, for example, "us-east1".
      *
                    * * string location = 1; @@ -139,12 +139,12 @@ public interface ReplicaSelectionOrBuilder * 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. * * @@ -357,7 +357,7 @@ private Type(int value) { * * * 
                    -     * The location or region of the serving requests, e.g. "us-east1".
+     * The location or region of the serving requests, for example, "us-east1".
      *
                    * * string location = 1; @@ -381,7 +381,7 @@ public java.lang.String getLocation() { * * * 
                    -     * The location or region of the serving requests, e.g. "us-east1".
+     * The location or region of the serving requests, for example, "us-east1".
      *
                    * * string location = 1; @@ -630,12 +630,12 @@ protected Builder newBuilderForType( * 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. * * @@ -840,7 +840,7 @@ public Builder mergeFrom( * * * 
                    -       * The location or region of the serving requests, e.g. "us-east1".
+       * The location or region of the serving requests, for example, "us-east1".
        *
                    * * string location = 1; @@ -863,7 +863,7 @@ public java.lang.String getLocation() { * * * 
                    -       * The location or region of the serving requests, e.g. "us-east1".
+       * The location or region of the serving requests, for example, "us-east1".
        *
                    * * string location = 1; @@ -886,7 +886,7 @@ public com.google.protobuf.ByteString getLocationBytes() { * * * 
                    -       * The location or region of the serving requests, e.g. "us-east1".
+       * The location or region of the serving requests, for example, "us-east1".
        *
                    * * string location = 1; @@ -908,7 +908,7 @@ public Builder setLocation(java.lang.String value) { * * * 
                    -       * The location or region of the serving requests, e.g. "us-east1".
+       * The location or region of the serving requests, for example, "us-east1".
        *
                    * * string location = 1; @@ -926,7 +926,7 @@ public Builder clearLocation() { * * * 
                    -       * The location or region of the serving requests, e.g. "us-east1".
+       * The location or region of the serving requests, for example, "us-east1".
        *
                    * * string location = 1; @@ -1185,9 +1185,9 @@ public interface IncludeReplicasOrBuilder * * * 
                    -     * 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`.
      *
                    * * bool auto_failover_disabled = 2; @@ -1201,7 +1201,7 @@ public interface IncludeReplicasOrBuilder * * * 
                    -   * 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.
    *
                    * @@ -1341,9 +1341,9 @@ public com.google.spanner.v1.DirectedReadOptions.ReplicaSelection getReplicaSele * * * 
                    -     * 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`.
      *
                    * * bool auto_failover_disabled = 2; @@ -1533,7 +1533,7 @@ protected Builder newBuilderForType( * * * 
                    -     * 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.
      *
                    * @@ -2206,9 +2206,9 @@ public Builder removeReplicaSelections(int index) { * * * 
                    -       * 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`.
        *
                    * * bool auto_failover_disabled = 2; @@ -2224,9 +2224,9 @@ public boolean getAutoFailoverDisabled() { * * * 
                    -       * 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`.
        *
                    * * bool auto_failover_disabled = 2; @@ -2246,9 +2246,9 @@ public Builder setAutoFailoverDisabled(boolean value) { * * * 
                    -       * 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`.
        *
                    * * bool auto_failover_disabled = 2; @@ -3480,11 +3480,11 @@ public ReplicasCase getReplicasCase() { * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -3500,11 +3500,11 @@ public boolean hasIncludeReplicas() { * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -3523,11 +3523,11 @@ public com.google.spanner.v1.DirectedReadOptions.IncludeReplicas getIncludeRepli * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -3547,8 +3547,8 @@ public com.google.spanner.v1.DirectedReadOptions.IncludeReplicas getIncludeRepli * * * 
                    -   * 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.
    *
                    * @@ -3565,8 +3565,8 @@ public boolean hasExcludeReplicas() { * * * 
                    -   * 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.
    *
                    * @@ -3586,8 +3586,8 @@ public com.google.spanner.v1.DirectedReadOptions.ExcludeReplicas getExcludeRepli * * * 
                    -   * 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.
    *
                    * @@ -3796,11 +3796,11 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                    -   * 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.
    *
                    * * Protobuf type {@code google.spanner.v1.DirectedReadOptions} @@ -4035,11 +4035,11 @@ public Builder clearReplicas() { * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4055,11 +4055,11 @@ public boolean hasIncludeReplicas() { * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4085,11 +4085,11 @@ public com.google.spanner.v1.DirectedReadOptions.IncludeReplicas getIncludeRepli * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4113,11 +4113,11 @@ public Builder setIncludeReplicas( * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4138,11 +4138,11 @@ public Builder setIncludeReplicas( * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4177,11 +4177,11 @@ public Builder mergeIncludeReplicas( * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4207,11 +4207,11 @@ public Builder clearIncludeReplicas() { * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4225,11 +4225,11 @@ public Builder clearIncludeReplicas() { * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4251,11 +4251,11 @@ public Builder clearIncludeReplicas() { * * * 
                    -     * 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.
      *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -4295,8 +4295,8 @@ public Builder clearIncludeReplicas() { * * * 
                    -     * 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.
      *
                    * @@ -4313,8 +4313,8 @@ public boolean hasExcludeReplicas() { * * * 
                    -     * 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.
      *
                    * @@ -4341,8 +4341,8 @@ public com.google.spanner.v1.DirectedReadOptions.ExcludeReplicas getExcludeRepli * * * 
                    -     * 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.
      *
                    * @@ -4367,8 +4367,8 @@ public Builder setExcludeReplicas( * * * 
                    -     * 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.
      *
                    * @@ -4390,8 +4390,8 @@ public Builder setExcludeReplicas( * * * 
                    -     * 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.
      *
                    * @@ -4427,8 +4427,8 @@ public Builder mergeExcludeReplicas( * * * 
                    -     * 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.
      *
                    * @@ -4455,8 +4455,8 @@ public Builder clearExcludeReplicas() { * * * 
                    -     * 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.
      *
                    * @@ -4471,8 +4471,8 @@ public Builder clearExcludeReplicas() { * * * 
                    -     * 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.
      *
                    * @@ -4495,8 +4495,8 @@ public Builder clearExcludeReplicas() { * * * 
                    -     * 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.
      *
                    * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptionsOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptionsOrBuilder.java index 25405eec0e..0749a26f8d 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptionsOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/DirectedReadOptionsOrBuilder.java @@ -28,11 +28,11 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -45,11 +45,11 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -62,11 +62,11 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * * .google.spanner.v1.DirectedReadOptions.IncludeReplicas include_replicas = 1; @@ -77,8 +77,8 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * @@ -92,8 +92,8 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * @@ -107,8 +107,8 @@ public interface DirectedReadOptionsOrBuilder * * * 
                    -   * 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.
    *
                    * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequest.java index 660f2552af..ce7b064cf0 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequest.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequest.java @@ -106,12 +106,12 @@ public interface StatementOrBuilder * 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. * * * .google.protobuf.Struct params = 2; @@ -130,12 +130,12 @@ public interface StatementOrBuilder * 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. * * * .google.protobuf.Struct params = 2; @@ -154,12 +154,12 @@ public interface StatementOrBuilder * 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. * * * .google.protobuf.Struct params = 2; @@ -170,8 +170,8 @@ public interface StatementOrBuilder * * * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -190,8 +190,8 @@ public interface StatementOrBuilder
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -214,8 +214,8 @@ public interface StatementOrBuilder
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -234,8 +234,8 @@ public interface StatementOrBuilder
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -258,8 +258,8 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -399,12 +399,12 @@ public com.google.protobuf.ByteString getSqlBytes() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 2;
@@ -426,12 +426,12 @@ public boolean hasParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 2;
@@ -453,12 +453,12 @@ public com.google.protobuf.Struct getParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 2;
@@ -503,8 +503,8 @@ public int getParamTypesCount() {
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -536,8 +536,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -559,8 +559,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -590,8 +590,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
      * JSON strings.
@@ -1195,12 +1195,12 @@ public Builder setSqlBytes(com.google.protobuf.ByteString value) {
        * 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.
        * 
                    
        *
        * .google.protobuf.Struct params = 2;
@@ -1221,12 +1221,12 @@ public boolean hasParams() {
        * 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.
        * 
                    
        *
        * .google.protobuf.Struct params = 2;
@@ -1251,12 +1251,12 @@ public com.google.protobuf.Struct getParams() {
        * 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.
        * 
                    
        *
        * .google.protobuf.Struct params = 2;
@@ -1285,12 +1285,12 @@ public Builder setParams(com.google.protobuf.Struct value) {
        * 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.
        * 
                    
        *
        * .google.protobuf.Struct params = 2;
@@ -1316,12 +1316,12 @@ public Builder setParams(com.google.protobuf.Struct.Builder builderForValue) {
        * 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.
        * 
                    
        *
        * .google.protobuf.Struct params = 2;
@@ -1355,12 +1355,12 @@ public Builder mergeParams(com.google.protobuf.Struct value) {
        * 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.
        *
                    * * .google.protobuf.Struct params = 2; @@ -1386,12 +1386,12 @@ public Builder clearParams() { * 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. * * * .google.protobuf.Struct params = 2; @@ -1412,12 +1412,12 @@ public com.google.protobuf.Struct.Builder getParamsBuilder() { * 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. * * * .google.protobuf.Struct params = 2; @@ -1440,12 +1440,12 @@ public com.google.protobuf.StructOrBuilder getParamsOrBuilder() { * 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. * * * .google.protobuf.Struct params = 2; @@ -1529,8 +1529,8 @@ public int getParamTypesCount() { * * * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1562,8 +1562,8 @@ public java.util.Map getParamTypes
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1585,8 +1585,8 @@ public java.util.Map getParamTypes
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1616,8 +1616,8 @@ public java.util.Map getParamTypes
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1653,8 +1653,8 @@ public Builder clearParamTypes() {
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1686,8 +1686,8 @@ public java.util.Map getMutablePar
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1716,8 +1716,8 @@ public Builder putParamTypes(java.lang.String key, com.google.spanner.v1.Type va
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -1747,8 +1747,8 @@ public Builder putAllParamTypes(
        *
        *
        * 
                    -       * 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
        * [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
        * JSON strings.
@@ -2091,12 +2091,12 @@ public com.google.spanner.v1.ExecuteBatchDmlRequest.StatementOrBuilder getStatem
    * 
                        * 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.
    * 
                    
    *
    * int64 seqno = 4 [(.google.api.field_behavior) = REQUIRED];
@@ -2168,15 +2168,15 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder(
    *
    *
    * 
                    -   * 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.
-   *
-   * 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.
+   * 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 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.
    * 
                    
    *
    * bool last_statements = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3606,12 +3606,12 @@ public com.google.spanner.v1.ExecuteBatchDmlRequest.Statement.Builder addStateme
      * 
                          * 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.
      * 
                    
      *
      * int64 seqno = 4 [(.google.api.field_behavior) = REQUIRED];
@@ -3629,12 +3629,12 @@ public long getSeqno() {
      * 
                          * 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.
      * 
                    
      *
      * int64 seqno = 4 [(.google.api.field_behavior) = REQUIRED];
@@ -3656,12 +3656,12 @@ public Builder setSeqno(long value) {
      * 
                          * 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.
      * 
                    
      *
      * int64 seqno = 4 [(.google.api.field_behavior) = REQUIRED];
@@ -3875,15 +3875,15 @@ public com.google.spanner.v1.RequestOptionsOrBuilder getRequestOptionsOrBuilder(
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bool last_statements = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3899,15 +3899,15 @@ public boolean getLastStatements() {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bool last_statements = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3927,15 +3927,15 @@ public Builder setLastStatements(boolean value) {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bool last_statements = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequestOrBuilder.java
index f248d5b2d0..98d86cc96c 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequestOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlRequestOrBuilder.java
@@ -206,12 +206,12 @@ public interface ExecuteBatchDmlRequestOrBuilder
    * 
                        * 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.
    * 
                    
    *
    * int64 seqno = 4 [(.google.api.field_behavior) = REQUIRED];
@@ -261,15 +261,15 @@ public interface ExecuteBatchDmlRequestOrBuilder
    *
    *
    * 
                    -   * 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.
-   *
-   * 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.
+   * 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 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.
    * 
                    
    *
    * bool last_statements = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponse.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponse.java
index 331200367f..2da5aef4e1 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponse.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponse.java
@@ -270,13 +270,10 @@ public com.google.rpc.StatusOrBuilder getStatusOrBuilder() {
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
@@ -294,13 +291,10 @@ public boolean hasPrecommitToken() {
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
@@ -320,13 +314,10 @@ public com.google.spanner.v1.MultiplexedSessionPrecommitToken getPrecommitToken(
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
@@ -1551,13 +1542,10 @@ public com.google.rpc.StatusOrBuilder getStatusOrBuilder() {
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1574,13 +1562,10 @@ public boolean hasPrecommitToken() {
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1603,13 +1588,10 @@ public com.google.spanner.v1.MultiplexedSessionPrecommitToken getPrecommitToken(
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1634,13 +1616,10 @@ public Builder setPrecommitToken(com.google.spanner.v1.MultiplexedSessionPrecomm
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1663,13 +1642,10 @@ public Builder setPrecommitToken(
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1701,13 +1677,10 @@ public Builder mergePrecommitToken(
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1729,13 +1702,10 @@ public Builder clearPrecommitToken() {
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1753,13 +1723,10 @@ public Builder clearPrecommitToken() {
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
@@ -1781,13 +1748,10 @@ public Builder clearPrecommitToken() {
      *
      *
      * 
                    -     * 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
      * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-     * This feature is not yet supported and will result in an UNIMPLEMENTED
-     * error.
      * 
                    
      *
      * 
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponseOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponseOrBuilder.java
index 476b32ea98..bde57013ec 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponseOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteBatchDmlResponseOrBuilder.java
@@ -163,13 +163,10 @@ public interface ExecuteBatchDmlResponseOrBuilder
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
@@ -184,13 +181,10 @@ public interface ExecuteBatchDmlResponseOrBuilder
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
@@ -205,13 +199,10 @@ public interface ExecuteBatchDmlResponseOrBuilder
    *
    *
    * 
                    -   * 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
    * [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
-   * This feature is not yet supported and will result in an UNIMPLEMENTED
-   * error.
    * 
                    
    *
    * 
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequest.java
index 5c08a58d0a..8fd531908a 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequest.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequest.java
@@ -118,7 +118,7 @@ public enum QueryMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
                          * 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.
      * 
                    
      *
@@ -179,7 +179,7 @@ public enum QueryMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
                          * 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.
      * 
                    
      *
@@ -319,7 +319,7 @@ public interface QueryOptionsOrBuilder
      * 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.
@@ -353,7 +353,7 @@ public interface QueryOptionsOrBuilder
      * 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.
@@ -383,13 +383,13 @@ public interface QueryOptionsOrBuilder
      * 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)
      * ```
      *
@@ -419,13 +419,13 @@ public interface QueryOptionsOrBuilder
      * 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)
      * ```
      *
@@ -511,7 +511,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      * 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.
@@ -556,7 +556,7 @@ public java.lang.String getOptimizerVersion() {
      * 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.
@@ -602,13 +602,13 @@ public com.google.protobuf.ByteString getOptimizerVersionBytes() {
      * 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)
      * ```
      *
@@ -649,13 +649,13 @@ public java.lang.String getOptimizerStatisticsPackage() {
      * 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)
      * ```
      *
@@ -1077,7 +1077,7 @@ public Builder mergeFrom(
        * 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.
@@ -1121,7 +1121,7 @@ public java.lang.String getOptimizerVersion() {
        * 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.
@@ -1165,7 +1165,7 @@ public com.google.protobuf.ByteString getOptimizerVersionBytes() {
        * 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.
@@ -1208,7 +1208,7 @@ public Builder setOptimizerVersion(java.lang.String value) {
        * 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.
@@ -1247,7 +1247,7 @@ public Builder clearOptimizerVersion() {
        * 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.
@@ -1289,13 +1289,13 @@ public Builder setOptimizerVersionBytes(com.google.protobuf.ByteString value) {
        * 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)
        * ```
        *
@@ -1335,13 +1335,13 @@ public java.lang.String getOptimizerStatisticsPackage() {
        * 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)
        * ```
        *
@@ -1381,13 +1381,13 @@ public com.google.protobuf.ByteString getOptimizerStatisticsPackageBytes() {
        * 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)
        * ```
        *
@@ -1426,13 +1426,13 @@ public Builder setOptimizerStatisticsPackage(java.lang.String value) {
        * 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)
        * ```
        *
@@ -1467,13 +1467,13 @@ public Builder clearOptimizerStatisticsPackage() {
        * 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)
        * ```
        *
@@ -1636,7 +1636,7 @@ public com.google.protobuf.ByteString getSessionBytes() {
    * 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.
@@ -1661,7 +1661,7 @@ public boolean hasTransaction() {
    * 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.
@@ -1688,7 +1688,7 @@ public com.google.spanner.v1.TransactionSelector getTransaction() {
    * 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.
@@ -1770,12 +1770,12 @@ public com.google.protobuf.ByteString getSqlBytes() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -1798,12 +1798,12 @@ public boolean hasParams() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -1826,12 +1826,12 @@ public com.google.protobuf.Struct getParams() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -1875,12 +1875,12 @@ public int getParamTypesCount() {
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -1907,12 +1907,12 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -1929,12 +1929,12 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -1959,12 +1959,12 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -2063,10 +2063,10 @@ public com.google.spanner.v1.ExecuteSqlRequest.QueryMode getQueryMode() {
    *
    *
    * 
                    -   * 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`.
    * 
                    
    *
    * bytes partition_token = 8;
@@ -2087,12 +2087,12 @@ public com.google.protobuf.ByteString getPartitionToken() {
    * 
                        * 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.
    * 
                    
@@ -2275,7 +2275,7 @@ public com.google.spanner.v1.DirectedReadOptionsOrBuilder getDirectedReadOptions
    * 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.
    * 
                    
    *
@@ -2295,15 +2295,15 @@ public boolean getDataBoostEnabled() {
    *
    *
    * 
                    -   * 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.
-   *
-   * 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.
+   * 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 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.
    * 
                    
    *
    * bool last_statement = 17 [(.google.api.field_behavior) = OPTIONAL];
@@ -3193,7 +3193,7 @@ public Builder setSessionBytes(com.google.protobuf.ByteString value) {
      * 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.
@@ -3217,7 +3217,7 @@ public boolean hasTransaction() {
      * 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.
@@ -3247,7 +3247,7 @@ public com.google.spanner.v1.TransactionSelector getTransaction() {
      * 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.
@@ -3279,7 +3279,7 @@ public Builder setTransaction(com.google.spanner.v1.TransactionSelector value) {
      * 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.
@@ -3309,7 +3309,7 @@ public Builder setTransaction(
      * 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.
@@ -3346,7 +3346,7 @@ public Builder mergeTransaction(com.google.spanner.v1.TransactionSelector value)
      * 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.
@@ -3375,7 +3375,7 @@ public Builder clearTransaction() {
      * 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.
@@ -3399,7 +3399,7 @@ public com.google.spanner.v1.TransactionSelector.Builder getTransactionBuilder()
      * 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.
@@ -3427,7 +3427,7 @@ public com.google.spanner.v1.TransactionSelectorOrBuilder getTransactionOrBuilde
      * 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.
@@ -3581,12 +3581,12 @@ public Builder setSqlBytes(com.google.protobuf.ByteString value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3608,12 +3608,12 @@ public boolean hasParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3639,12 +3639,12 @@ public com.google.protobuf.Struct getParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3674,12 +3674,12 @@ public Builder setParams(com.google.protobuf.Struct value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3706,12 +3706,12 @@ public Builder setParams(com.google.protobuf.Struct.Builder builderForValue) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3746,12 +3746,12 @@ public Builder mergeParams(com.google.protobuf.Struct value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3778,12 +3778,12 @@ public Builder clearParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -3805,12 +3805,12 @@ public com.google.protobuf.Struct.Builder getParamsBuilder() {
      * 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.
      *
                    * * .google.protobuf.Struct params = 4; @@ -3834,12 +3834,12 @@ public com.google.protobuf.StructOrBuilder getParamsOrBuilder() { * 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. * * * .google.protobuf.Struct params = 4; @@ -3923,12 +3923,12 @@ public int getParamTypesCount() { * * * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -3955,12 +3955,12 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -3977,12 +3977,12 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4007,12 +4007,12 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4043,12 +4043,12 @@ public Builder clearParamTypes() {
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4075,12 +4075,12 @@ public java.util.Map getMutablePar
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4104,12 +4104,12 @@ public Builder putParamTypes(java.lang.String key, com.google.spanner.v1.Type va
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4134,12 +4134,12 @@ public Builder putAllParamTypes(
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
      * about SQL types.
@@ -4363,10 +4363,10 @@ public Builder clearQueryMode() {
      *
      *
      * 
                    -     * 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`.
      * 
                    
      *
      * bytes partition_token = 8;
@@ -4382,10 +4382,10 @@ public com.google.protobuf.ByteString getPartitionToken() {
      *
      *
      * 
                    -     * 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`.
      * 
                    
      *
      * bytes partition_token = 8;
@@ -4407,10 +4407,10 @@ public Builder setPartitionToken(com.google.protobuf.ByteString value) {
      *
      *
      * 
                    -     * 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`.
      * 
                    
      *
      * bytes partition_token = 8;
@@ -4432,12 +4432,12 @@ public Builder clearPartitionToken() {
      * 
                          * 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.
      * 
                    
@@ -4457,12 +4457,12 @@ public long getSeqno() {
      * 
                          * 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.
      * 
                    
@@ -4486,12 +4486,12 @@ public Builder setSeqno(long value) {
      * 
                          * 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.
      * 
                    
@@ -5103,7 +5103,7 @@ public com.google.spanner.v1.DirectedReadOptionsOrBuilder getDirectedReadOptions
      * 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.
      * 
                    
      *
@@ -5123,7 +5123,7 @@ public boolean getDataBoostEnabled() {
      * 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.
      * 
                    
      *
@@ -5147,7 +5147,7 @@ public Builder setDataBoostEnabled(boolean value) {
      * 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.
      * 
                    
      *
@@ -5168,15 +5168,15 @@ public Builder clearDataBoostEnabled() {
      *
      *
      * 
                    -     * 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.
-     *
-     * 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.
+     * 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 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.
      * 
                    
      *
      * bool last_statement = 17 [(.google.api.field_behavior) = OPTIONAL];
@@ -5192,15 +5192,15 @@ public boolean getLastStatement() {
      *
      *
      * 
                    -     * 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.
-     *
-     * 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.
+     * 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 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.
      * 
                    
      *
      * bool last_statement = 17 [(.google.api.field_behavior) = OPTIONAL];
@@ -5220,15 +5220,15 @@ public Builder setLastStatement(boolean value) {
      *
      *
      * 
                    -     * 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.
-     *
-     * 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.
+     * 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 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.
      * 
                    
      *
      * bool last_statement = 17 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequestOrBuilder.java
index 3ccde99ff8..c3f479e50f 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequestOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ExecuteSqlRequestOrBuilder.java
@@ -64,7 +64,7 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
@@ -86,7 +86,7 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
@@ -108,7 +108,7 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
@@ -155,12 +155,12 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -180,12 +180,12 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -205,12 +205,12 @@ public interface ExecuteSqlRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -221,12 +221,12 @@ public interface ExecuteSqlRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -240,12 +240,12 @@ public interface ExecuteSqlRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -263,12 +263,12 @@ public interface ExecuteSqlRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -282,12 +282,12 @@ public interface ExecuteSqlRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -305,12 +305,12 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information
    * about SQL types.
@@ -378,10 +378,10 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    *
    *
    * 
                    -   * 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`.
    * 
                    
    *
    * bytes partition_token = 8;
@@ -396,12 +396,12 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    * 
                        * 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.
    * 
                    
@@ -530,7 +530,7 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    * 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.
    * 
                    
    *
@@ -544,15 +544,15 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    *
    *
    * 
                    -   * 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.
-   *
-   * 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.
+   * 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 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.
    * 
                    
    *
    * bool last_statement = 17 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySet.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySet.java
index 74891a2855..c40e2bbbe8 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySet.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySet.java
@@ -168,8 +168,8 @@ public com.google.protobuf.ListValueOrBuilder getKeysOrBuilder(int index) {
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -183,8 +183,8 @@ public java.util.List getRangesList() {
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -199,8 +199,8 @@ public java.util.List getRangesList() {
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -214,8 +214,8 @@ public int getRangesCount() {
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -229,8 +229,8 @@ public com.google.spanner.v1.KeyRange getRanges(int index) {
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1170,8 +1170,8 @@ private void ensureRangesIsMutable() {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1188,8 +1188,8 @@ public java.util.List getRangesList() {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1206,8 +1206,8 @@ public int getRangesCount() {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1224,8 +1224,8 @@ public com.google.spanner.v1.KeyRange getRanges(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1248,8 +1248,8 @@ public Builder setRanges(int index, com.google.spanner.v1.KeyRange value) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1269,8 +1269,8 @@ public Builder setRanges(int index, com.google.spanner.v1.KeyRange.Builder build
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1293,8 +1293,8 @@ public Builder addRanges(com.google.spanner.v1.KeyRange value) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1317,8 +1317,8 @@ public Builder addRanges(int index, com.google.spanner.v1.KeyRange value) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1338,8 +1338,8 @@ public Builder addRanges(com.google.spanner.v1.KeyRange.Builder builderForValue)
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1359,8 +1359,8 @@ public Builder addRanges(int index, com.google.spanner.v1.KeyRange.Builder build
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1381,8 +1381,8 @@ public Builder addAllRanges(
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1402,8 +1402,8 @@ public Builder clearRanges() {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1423,8 +1423,8 @@ public Builder removeRanges(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1437,8 +1437,8 @@ public com.google.spanner.v1.KeyRange.Builder getRangesBuilder(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1455,8 +1455,8 @@ public com.google.spanner.v1.KeyRangeOrBuilder getRangesOrBuilder(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1474,8 +1474,8 @@ public com.google.spanner.v1.KeyRangeOrBuilder getRangesOrBuilder(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1489,8 +1489,8 @@ public com.google.spanner.v1.KeyRange.Builder addRangesBuilder() {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -1504,8 +1504,8 @@ public com.google.spanner.v1.KeyRange.Builder addRangesBuilder(int index) {
      *
      *
      * 
                    -     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-     * key range specifications.
+     * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+     * information about key range specifications.
      * 
                    
      *
      * repeated .google.spanner.v1.KeyRange ranges = 2;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySetOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySetOrBuilder.java
index e2e423c325..7e0eb34bc7 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySetOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/KeySetOrBuilder.java
@@ -98,8 +98,8 @@ public interface KeySetOrBuilder
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -110,8 +110,8 @@ public interface KeySetOrBuilder
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -122,8 +122,8 @@ public interface KeySetOrBuilder
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -134,8 +134,8 @@ public interface KeySetOrBuilder
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
@@ -146,8 +146,8 @@ public interface KeySetOrBuilder
    *
    *
    * 
                    -   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-   * key range specifications.
+   * A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+   * information about key range specifications.
    * 
                    
    *
    * repeated .google.spanner.v1.KeyRange ranges = 2;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Mutation.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Mutation.java
index f3a0f904e7..47adefcfa8 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Mutation.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Mutation.java
@@ -98,7 +98,8 @@ public interface WriteOrBuilder
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -115,7 +116,8 @@ public interface WriteOrBuilder
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -132,7 +134,8 @@ public interface WriteOrBuilder
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -150,7 +153,8 @@ public interface WriteOrBuilder
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -171,11 +175,13 @@ public interface WriteOrBuilder
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -189,11 +195,13 @@ public interface WriteOrBuilder
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -207,11 +215,13 @@ public interface WriteOrBuilder
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -225,11 +235,13 @@ public interface WriteOrBuilder
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -243,11 +255,13 @@ public interface WriteOrBuilder
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -259,7 +273,9 @@ public interface WriteOrBuilder
    *
    *
    * 
                    -   * Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
+   * Arguments to [insert][google.spanner.v1.Mutation.insert],
+   * [update][google.spanner.v1.Mutation.update],
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
    * [replace][google.spanner.v1.Mutation.replace] operations.
    * 
                    
    *
@@ -366,7 +382,8 @@ public com.google.protobuf.ByteString getTableBytes() {
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -385,7 +402,8 @@ public com.google.protobuf.ProtocolStringList getColumnsList() {
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -404,7 +422,8 @@ public int getColumnsCount() {
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -424,7 +443,8 @@ public java.lang.String getColumns(int index) {
      *
      *
      * 
                    -     * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+     * The names of the columns in
+     * [table][google.spanner.v1.Mutation.Write.table] to be written.
      *
      * The list of columns must contain enough columns to allow
      * Cloud Spanner to derive values for all primary key columns in the
@@ -452,11 +472,13 @@ public com.google.protobuf.ByteString getColumnsBytes(int index) {
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -473,11 +495,13 @@ public java.util.List getValuesList() {
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -495,11 +519,13 @@ public java.util.List getValuesList() {
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -516,11 +542,13 @@ public int getValuesCount() {
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -537,11 +565,13 @@ public com.google.protobuf.ListValue getValues(int index) {
      * The values to be written. `values` can contain more than one
      * list of values. If it does, then multiple rows are written, one
      * for each entry in `values`. Each list in `values` must have
-     * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-     * above. Sending multiple lists is equivalent to sending multiple
-     * `Mutation`s, each containing one `values` entry and repeating
-     * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-     * encoded as described [here][google.spanner.v1.TypeCode].
+     * exactly as many entries as there are entries in
+     * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+     * multiple lists is equivalent to sending multiple `Mutation`s, each
+     * containing one `values` entry and repeating
+     * [table][google.spanner.v1.Mutation.Write.table] and
+     * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+     * each list are encoded as described [here][google.spanner.v1.TypeCode].
      * 
                    
      *
      * repeated .google.protobuf.ListValue values = 3;
@@ -742,7 +772,9 @@ protected Builder newBuilderForType(
      *
      *
      * 
                    -     * Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
+     * Arguments to [insert][google.spanner.v1.Mutation.insert],
+     * [update][google.spanner.v1.Mutation.update],
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
      * [replace][google.spanner.v1.Mutation.replace] operations.
      * 
                    
      *
@@ -1130,7 +1162,8 @@ private void ensureColumnsIsMutable() {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1150,7 +1183,8 @@ public com.google.protobuf.ProtocolStringList getColumnsList() {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1169,7 +1203,8 @@ public int getColumnsCount() {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1189,7 +1224,8 @@ public java.lang.String getColumns(int index) {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1209,7 +1245,8 @@ public com.google.protobuf.ByteString getColumnsBytes(int index) {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1237,7 +1274,8 @@ public Builder setColumns(int index, java.lang.String value) {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1264,7 +1302,8 @@ public Builder addColumns(java.lang.String value) {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1288,7 +1327,8 @@ public Builder addAllColumns(java.lang.Iterable values) {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1311,7 +1351,8 @@ public Builder clearColumns() {
        *
        *
        * 
                    -       * The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+       * The names of the columns in
+       * [table][google.spanner.v1.Mutation.Write.table] to be written.
        *
        * The list of columns must contain enough columns to allow
        * Cloud Spanner to derive values for all primary key columns in the
@@ -1358,11 +1399,13 @@ private void ensureValuesIsMutable() {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1382,11 +1425,13 @@ public java.util.List getValuesList() {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1406,11 +1451,13 @@ public int getValuesCount() {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1430,11 +1477,13 @@ public com.google.protobuf.ListValue getValues(int index) {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1460,11 +1509,13 @@ public Builder setValues(int index, com.google.protobuf.ListValue value) {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1487,11 +1538,13 @@ public Builder setValues(int index, com.google.protobuf.ListValue.Builder builde
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1517,11 +1570,13 @@ public Builder addValues(com.google.protobuf.ListValue value) {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1547,11 +1602,13 @@ public Builder addValues(int index, com.google.protobuf.ListValue value) {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1574,11 +1631,13 @@ public Builder addValues(com.google.protobuf.ListValue.Builder builderForValue)
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1601,11 +1660,13 @@ public Builder addValues(int index, com.google.protobuf.ListValue.Builder builde
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1629,11 +1690,13 @@ public Builder addAllValues(
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1656,11 +1719,13 @@ public Builder clearValues() {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        * 
                    
        *
        * repeated .google.protobuf.ListValue values = 3;
@@ -1683,11 +1748,13 @@ public Builder removeValues(int index) {
        * The values to be written. `values` can contain more than one
        * list of values. If it does, then multiple rows are written, one
        * for each entry in `values`. Each list in `values` must have
-       * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-       * above. Sending multiple lists is equivalent to sending multiple
-       * `Mutation`s, each containing one `values` entry and repeating
-       * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-       * encoded as described [here][google.spanner.v1.TypeCode].
+       * exactly as many entries as there are entries in
+       * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+       * multiple lists is equivalent to sending multiple `Mutation`s, each
+       * containing one `values` entry and repeating
+       * [table][google.spanner.v1.Mutation.Write.table] and
+       * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+       * each list are encoded as described [here][google.spanner.v1.TypeCode].
        *
                    * * repeated .google.protobuf.ListValue values = 3; @@ -1703,11 +1770,13 @@ public com.google.protobuf.ListValue.Builder getValuesBuilder(int index) { * The values to be written. `values` can contain more than one * list of values. If it does, then multiple rows are written, one * for each entry in `values`. Each list in `values` must have - * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - * above. Sending multiple lists is equivalent to sending multiple - * `Mutation`s, each containing one `values` entry and repeating - * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - * encoded as described [here][google.spanner.v1.TypeCode]. + * exactly as many entries as there are entries in + * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + * multiple lists is equivalent to sending multiple `Mutation`s, each + * containing one `values` entry and repeating + * [table][google.spanner.v1.Mutation.Write.table] and + * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + * each list are encoded as described [here][google.spanner.v1.TypeCode]. * * * repeated .google.protobuf.ListValue values = 3; @@ -1727,11 +1796,13 @@ public com.google.protobuf.ListValueOrBuilder getValuesOrBuilder(int index) { * The values to be written. `values` can contain more than one * list of values. If it does, then multiple rows are written, one * for each entry in `values`. Each list in `values` must have - * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - * above. Sending multiple lists is equivalent to sending multiple - * `Mutation`s, each containing one `values` entry and repeating - * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - * encoded as described [here][google.spanner.v1.TypeCode]. + * exactly as many entries as there are entries in + * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + * multiple lists is equivalent to sending multiple `Mutation`s, each + * containing one `values` entry and repeating + * [table][google.spanner.v1.Mutation.Write.table] and + * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + * each list are encoded as described [here][google.spanner.v1.TypeCode]. * * * repeated .google.protobuf.ListValue values = 3; @@ -1752,11 +1823,13 @@ public com.google.protobuf.ListValueOrBuilder getValuesOrBuilder(int index) { * The values to be written. `values` can contain more than one * list of values. If it does, then multiple rows are written, one * for each entry in `values`. Each list in `values` must have - * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - * above. Sending multiple lists is equivalent to sending multiple - * `Mutation`s, each containing one `values` entry and repeating - * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - * encoded as described [here][google.spanner.v1.TypeCode]. + * exactly as many entries as there are entries in + * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + * multiple lists is equivalent to sending multiple `Mutation`s, each + * containing one `values` entry and repeating + * [table][google.spanner.v1.Mutation.Write.table] and + * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + * each list are encoded as described [here][google.spanner.v1.TypeCode]. * * * repeated .google.protobuf.ListValue values = 3; @@ -1773,11 +1846,13 @@ public com.google.protobuf.ListValue.Builder addValuesBuilder() { * The values to be written. `values` can contain more than one * list of values. If it does, then multiple rows are written, one * for each entry in `values`. Each list in `values` must have - * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - * above. Sending multiple lists is equivalent to sending multiple - * `Mutation`s, each containing one `values` entry and repeating - * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - * encoded as described [here][google.spanner.v1.TypeCode]. + * exactly as many entries as there are entries in + * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + * multiple lists is equivalent to sending multiple `Mutation`s, each + * containing one `values` entry and repeating + * [table][google.spanner.v1.Mutation.Write.table] and + * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + * each list are encoded as described [here][google.spanner.v1.TypeCode]. * * * repeated .google.protobuf.ListValue values = 3; @@ -1794,11 +1869,13 @@ public com.google.protobuf.ListValue.Builder addValuesBuilder(int index) { * The values to be written. `values` can contain more than one * list of values. If it does, then multiple rows are written, one * for each entry in `values`. Each list in `values` must have - * exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - * above. Sending multiple lists is equivalent to sending multiple - * `Mutation`s, each containing one `values` entry and repeating - * [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - * encoded as described [here][google.spanner.v1.TypeCode]. + * exactly as many entries as there are entries in + * [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + * multiple lists is equivalent to sending multiple `Mutation`s, each + * containing one `values` entry and repeating + * [table][google.spanner.v1.Mutation.Write.table] and + * [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + * each list are encoded as described [here][google.spanner.v1.TypeCode]. * * * repeated .google.protobuf.ListValue values = 3; @@ -1923,12 +2000,12 @@ public interface DeleteOrBuilder * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -1941,12 +2018,12 @@ public interface DeleteOrBuilder * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -1959,12 +2036,12 @@ public interface DeleteOrBuilder * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2078,12 +2155,12 @@ public com.google.protobuf.ByteString getTableBytes() { * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2099,12 +2176,12 @@ public boolean hasKeySet() { * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2120,12 +2197,12 @@ public com.google.spanner.v1.KeySet getKeySet() { * * * 
                    -     * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-     * primary keys must be specified in the order in which they appear in the
-     * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-     * statement used to create the table).
-     * Delete is idempotent. The transaction will succeed even if some or all
-     * rows do not exist.
+     * Required. The primary keys of the rows within
+     * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+     * keys must be specified in the order in which they appear in the `PRIMARY
+     * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+     * used to create the table). Delete is idempotent. The transaction will
+     * succeed even if some or all rows do not exist.
      *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2645,12 +2722,12 @@ public Builder setTableBytes(com.google.protobuf.ByteString value) { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2666,12 +2743,12 @@ public boolean hasKeySet() { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2691,12 +2768,12 @@ public com.google.spanner.v1.KeySet getKeySet() { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2720,12 +2797,12 @@ public Builder setKeySet(com.google.spanner.v1.KeySet value) { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2746,12 +2823,12 @@ public Builder setKeySet(com.google.spanner.v1.KeySet.Builder builderForValue) { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2780,12 +2857,12 @@ public Builder mergeKeySet(com.google.spanner.v1.KeySet value) { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2806,12 +2883,12 @@ public Builder clearKeySet() { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2827,12 +2904,12 @@ public com.google.spanner.v1.KeySet.Builder getKeySetBuilder() { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -2850,12 +2927,12 @@ public com.google.spanner.v1.KeySetOrBuilder getKeySetOrBuilder() { * * * 
                    -       * Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
-       * primary keys must be specified in the order in which they appear in the
-       * `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
-       * statement used to create the table).
-       * Delete is idempotent. The transaction will succeed even if some or all
-       * rows do not exist.
+       * Required. The primary keys of the rows within
+       * [table][google.spanner.v1.Mutation.Delete.table] to delete.  The primary
+       * keys must be specified in the order in which they appear in the `PRIMARY
+       * KEY()` clause of the table's equivalent DDL statement (the DDL statement
+       * used to create the table). Delete is idempotent. The transaction will
+       * succeed even if some or all rows do not exist.
        *
                    * * .google.spanner.v1.KeySet key_set = 2 [(.google.api.field_behavior) = REQUIRED]; @@ -3121,13 +3198,15 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getUpdateOrBuilder() { * * * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
    *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    *
                    * * .google.spanner.v1.Mutation.Write insert_or_update = 3; @@ -3143,13 +3222,15 @@ public boolean hasInsertOrUpdate() { * * * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
    *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    *
                    * * .google.spanner.v1.Mutation.Write insert_or_update = 3; @@ -3168,13 +3249,15 @@ public com.google.spanner.v1.Mutation.Write getInsertOrUpdate() { * * * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
    *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    *
                    * * .google.spanner.v1.Mutation.Write insert_or_update = 3; @@ -3193,10 +3276,11 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getInsertOrUpdateOrBuilder( * * * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -3217,10 +3301,11 @@ public boolean hasReplace() {
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -3244,10 +3329,11 @@ public com.google.spanner.v1.Mutation.Write getReplace() {
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4297,13 +4383,15 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getUpdateOrBuilder() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4319,13 +4407,15 @@ public boolean hasInsertOrUpdate() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4351,13 +4441,15 @@ public com.google.spanner.v1.Mutation.Write getInsertOrUpdate() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4380,13 +4472,15 @@ public Builder setInsertOrUpdate(com.google.spanner.v1.Mutation.Write value) {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4406,13 +4500,15 @@ public Builder setInsertOrUpdate(com.google.spanner.v1.Mutation.Write.Builder bu
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4445,13 +4541,15 @@ public Builder mergeInsertOrUpdate(com.google.spanner.v1.Mutation.Write value) {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4477,13 +4575,15 @@ public Builder clearInsertOrUpdate() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4496,13 +4596,15 @@ public com.google.spanner.v1.Mutation.Write.Builder getInsertOrUpdateBuilder() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4523,13 +4625,15 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getInsertOrUpdateOrBuilder(
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-     * its column values are overwritten with the ones provided. Any
-     * column values not explicitly written are preserved.
-     *
-     * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-     * NULL` columns in the table must be given a value. This holds true
-     * even when the row already exists and will therefore actually be updated.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, then its column values are overwritten with the ones
+     * provided. Any column values not explicitly written are preserved.
+     *
+     * When using
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+     * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+     * columns in the table must be given a value. This holds true even when the
+     * row already exists and will therefore actually be updated.
      * 
                    
      *
      * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -4568,10 +4672,11 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getInsertOrUpdateOrBuilder(
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4592,10 +4697,11 @@ public boolean hasReplace() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4626,10 +4732,11 @@ public com.google.spanner.v1.Mutation.Write getReplace() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4657,10 +4764,11 @@ public Builder setReplace(com.google.spanner.v1.Mutation.Write value) {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4685,10 +4793,11 @@ public Builder setReplace(com.google.spanner.v1.Mutation.Write.Builder builderFo
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4726,10 +4835,11 @@ public Builder mergeReplace(com.google.spanner.v1.Mutation.Write value) {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4760,10 +4870,11 @@ public Builder clearReplace() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4781,10 +4892,11 @@ public com.google.spanner.v1.Mutation.Write.Builder getReplaceBuilder() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -4810,10 +4922,11 @@ public com.google.spanner.v1.Mutation.WriteOrBuilder getReplaceOrBuilder() {
      *
      *
      * 
                    -     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-     * deleted, and the column values provided are inserted
-     * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-     * explicitly written become `NULL`.
+     * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+     * already exists, it is deleted, and the column values provided are
+     * inserted instead. Unlike
+     * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+     * means any values not explicitly written become `NULL`.
      *
      * In an interleaved table, if you create the child table with the
      * `ON DELETE CASCADE` annotation, then replacing a parent row
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/MutationOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/MutationOrBuilder.java
index c50dcd8b55..4b4d088fe2 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/MutationOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/MutationOrBuilder.java
@@ -108,13 +108,15 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
-   *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
+   *
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    * 
                    
    *
    * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -127,13 +129,15 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
-   *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
+   *
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    * 
                    
    *
    * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -146,13 +150,15 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
-   * its column values are overwritten with the ones provided. Any
-   * column values not explicitly written are preserved.
-   *
-   * When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
-   * NULL` columns in the table must be given a value. This holds true
-   * even when the row already exists and will therefore actually be updated.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, then its column values are overwritten with the ones
+   * provided. Any column values not explicitly written are preserved.
+   *
+   * When using
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as
+   * when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL`
+   * columns in the table must be given a value. This holds true even when the
+   * row already exists and will therefore actually be updated.
    * 
                    
    *
    * .google.spanner.v1.Mutation.Write insert_or_update = 3;
@@ -163,10 +169,11 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -184,10 +191,11 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
@@ -205,10 +213,11 @@ public interface MutationOrBuilder
    *
    *
    * 
                    -   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
-   * deleted, and the column values provided are inserted
-   * instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-   * explicitly written become `NULL`.
+   * Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+   * already exists, it is deleted, and the column values provided are
+   * inserted instead. Unlike
+   * [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+   * means any values not explicitly written become `NULL`.
    *
    * In an interleaved table, if you create the child table with the
    * `ON DELETE CASCADE` annotation, then replacing a parent row
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Partition.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Partition.java
index 26260a40ca..eb79b78c80 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Partition.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Partition.java
@@ -71,9 +71,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * bytes partition_token = 1;
@@ -428,9 +428,9 @@ public Builder mergeFrom(
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bytes partition_token = 1;
@@ -446,9 +446,9 @@ public com.google.protobuf.ByteString getPartitionToken() {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bytes partition_token = 1;
@@ -470,9 +470,9 @@ public Builder setPartitionToken(com.google.protobuf.ByteString value) {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * bytes partition_token = 1;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptions.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptions.java
index fe64beb1d6..749047b87a 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptions.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptions.java
@@ -23,8 +23,7 @@
  *
  *
  * 
                    - * Options for a PartitionQueryRequest and
- * PartitionReadRequest.
+ * Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
  * 
                    
  *
  * Protobuf type {@code google.spanner.v1.PartitionOptions}
@@ -70,12 +69,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                    -   * **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.
    * 
                    
    *
    * int64 partition_size_bytes = 1;
@@ -94,14 +93,14 @@ public long getPartitionSizeBytes() {
    *
    *
    * 
                    -   * **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.
    * 
                    
    *
    * int64 max_partitions = 2;
@@ -285,8 +284,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                    -   * Options for a PartitionQueryRequest and
-   * PartitionReadRequest.
+   * Options for a `PartitionQueryRequest` and `PartitionReadRequest`.
    * 
                    
    *
    * Protobuf type {@code google.spanner.v1.PartitionOptions}
@@ -481,12 +479,12 @@ public Builder mergeFrom(
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 partition_size_bytes = 1;
@@ -502,12 +500,12 @@ public long getPartitionSizeBytes() {
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 partition_size_bytes = 1;
@@ -527,12 +525,12 @@ public Builder setPartitionSizeBytes(long value) {
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 partition_size_bytes = 1;
@@ -552,14 +550,14 @@ public Builder clearPartitionSizeBytes() {
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 max_partitions = 2;
@@ -575,14 +573,14 @@ public long getMaxPartitions() {
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 max_partitions = 2;
@@ -602,14 +600,14 @@ public Builder setMaxPartitions(long value) {
      *
      *
      * 
                    -     * **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.
      * 
                    
      *
      * int64 max_partitions = 2;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptionsOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptionsOrBuilder.java
index 28befed7ab..2d4eafb5c5 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptionsOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOptionsOrBuilder.java
@@ -28,12 +28,12 @@ public interface PartitionOptionsOrBuilder
    *
    *
    * 
                    -   * **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.
    * 
                    
    *
    * int64 partition_size_bytes = 1;
@@ -46,14 +46,14 @@ public interface PartitionOptionsOrBuilder
    *
    *
    * 
                    -   * **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.
    * 
                    
    *
    * int64 max_partitions = 2;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOrBuilder.java
index 9a49527540..118685bdf2 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionOrBuilder.java
@@ -28,9 +28,9 @@ public interface PartitionOrBuilder
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * bytes partition_token = 1;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequest.java
index 3180c9b48e..8fa4b7af4e 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequest.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequest.java
@@ -142,8 +142,8 @@ public com.google.protobuf.ByteString getSessionBytes() {
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -159,8 +159,8 @@ public boolean hasTransaction() {
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -178,8 +178,8 @@ public com.google.spanner.v1.TransactionSelector getTransaction() {
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -200,18 +200,19 @@ public com.google.spanner.v1.TransactionSelectorOrBuilder getTransactionOrBuilde
    *
    *
    * 
                    -   * 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
-   * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+   * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+   * a `PartitionedDml` transaction for large, partition-friendly DML
+   * operations.
    * 
                    
    *
    * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -235,18 +236,19 @@ public java.lang.String getSql() {
    *
    *
    * 
                    -   * 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
-   * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+   * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+   * a `PartitionedDml` transaction for large, partition-friendly DML
+   * operations.
    * 
                    
    *
    * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -279,12 +281,12 @@ public com.google.protobuf.ByteString getSqlBytes() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -306,12 +308,12 @@ public boolean hasParams() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -333,12 +335,12 @@ public com.google.protobuf.Struct getParams() {
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -382,8 +384,8 @@ public int getParamTypesCount() {
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -414,8 +416,8 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -436,8 +438,8 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -466,8 +468,8 @@ public java.util.Map getParamTypes
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -1214,8 +1216,8 @@ public Builder setSessionBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1230,8 +1232,8 @@ public boolean hasTransaction() {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1252,8 +1254,8 @@ public com.google.spanner.v1.TransactionSelector getTransaction() {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1276,8 +1278,8 @@ public Builder setTransaction(com.google.spanner.v1.TransactionSelector value) {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1298,8 +1300,8 @@ public Builder setTransaction(
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1327,8 +1329,8 @@ public Builder mergeTransaction(com.google.spanner.v1.TransactionSelector value)
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1348,8 +1350,8 @@ public Builder clearTransaction() {
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1364,8 +1366,8 @@ public com.google.spanner.v1.TransactionSelector.Builder getTransactionBuilder()
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1384,8 +1386,8 @@ public com.google.spanner.v1.TransactionSelectorOrBuilder getTransactionOrBuilde
      *
      *
      * 
                    -     * 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.
      * 
                    
      *
      * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -1413,18 +1415,19 @@ public com.google.spanner.v1.TransactionSelectorOrBuilder getTransactionOrBuilde
      *
      *
      * 
                    -     * 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
-     * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+     * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+     * a `PartitionedDml` transaction for large, partition-friendly DML
+     * operations.
      * 
                    
      *
      * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1447,18 +1450,19 @@ public java.lang.String getSql() {
      *
      *
      * 
                    -     * 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
-     * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+     * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+     * a `PartitionedDml` transaction for large, partition-friendly DML
+     * operations.
      * 
                    
      *
      * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1481,18 +1485,19 @@ public com.google.protobuf.ByteString getSqlBytes() {
      *
      *
      * 
                    -     * 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
-     * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+     * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+     * a `PartitionedDml` transaction for large, partition-friendly DML
+     * operations.
      * 
                    
      *
      * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1514,18 +1519,19 @@ public Builder setSql(java.lang.String value) {
      *
      *
      * 
                    -     * 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
-     * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+     * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+     * a `PartitionedDml` transaction for large, partition-friendly DML
+     * operations.
      * 
                    
      *
      * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1543,18 +1549,19 @@ public Builder clearSql() {
      *
      *
      * 
                    -     * 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
-     * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+     * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+     * a `PartitionedDml` transaction for large, partition-friendly DML
+     * operations.
      * 
                    
      *
      * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1590,12 +1597,12 @@ public Builder setSqlBytes(com.google.protobuf.ByteString value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1616,12 +1623,12 @@ public boolean hasParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1646,12 +1653,12 @@ public com.google.protobuf.Struct getParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1680,12 +1687,12 @@ public Builder setParams(com.google.protobuf.Struct value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1711,12 +1718,12 @@ public Builder setParams(com.google.protobuf.Struct.Builder builderForValue) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1750,12 +1757,12 @@ public Builder mergeParams(com.google.protobuf.Struct value) {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1781,12 +1788,12 @@ public Builder clearParams() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1807,12 +1814,12 @@ public com.google.protobuf.Struct.Builder getParamsBuilder() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1835,12 +1842,12 @@ public com.google.protobuf.StructOrBuilder getParamsOrBuilder() {
      * 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.
      * 
                    
      *
      * .google.protobuf.Struct params = 4;
@@ -1924,8 +1931,8 @@ public int getParamTypesCount() {
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -1956,8 +1963,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -1978,8 +1985,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -2008,8 +2015,8 @@ public java.util.Map getParamTypes
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -2044,8 +2051,8 @@ public Builder clearParamTypes() {
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -2076,8 +2083,8 @@ public java.util.Map getMutablePar
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -2105,8 +2112,8 @@ public Builder putParamTypes(java.lang.String key, com.google.spanner.v1.Type va
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
@@ -2135,8 +2142,8 @@ public Builder putAllParamTypes(
      *
      *
      * 
                    -     * 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
      * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
      *
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequestOrBuilder.java
index db5570df53..e637e57eb3 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequestOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionQueryRequestOrBuilder.java
@@ -58,8 +58,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -72,8 +72,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -86,8 +86,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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.
    * 
                    
    *
    * .google.spanner.v1.TransactionSelector transaction = 2;
@@ -98,18 +98,19 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
-   * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+   * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+   * a `PartitionedDml` transaction for large, partition-friendly DML
+   * operations.
    * 
                    
    *
    * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -122,18 +123,19 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
-   * [ExecuteStreamingSql][google.spanner.v1.Spanner.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
+   * [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with
+   * a `PartitionedDml` transaction for large, partition-friendly DML
+   * operations.
    * 
                    
    *
    * string sql = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -152,12 +154,12 @@ public interface PartitionQueryRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -176,12 +178,12 @@ public interface PartitionQueryRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -200,12 +202,12 @@ public interface PartitionQueryRequestOrBuilder
    * 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.
    * 
                    
    *
    * .google.protobuf.Struct params = 4;
@@ -216,8 +218,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -235,8 +237,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -258,8 +260,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -277,8 +279,8 @@ public interface PartitionQueryRequestOrBuilder
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
@@ -300,8 +302,8 @@ com.google.spanner.v1.Type getParamTypesOrDefault(
    *
    *
    * 
                    -   * 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
    * [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
    *
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequest.java
index c82d29e239..977ac885ea 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequest.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequest.java
@@ -384,7 +384,7 @@ public com.google.protobuf.ByteString getColumnsBytes(int index) {
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
@@ -409,7 +409,7 @@ public boolean hasKeySet() {
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
@@ -434,7 +434,7 @@ public com.google.spanner.v1.KeySet getKeySet() {
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
@@ -1821,7 +1821,7 @@ public Builder addColumnsBytes(com.google.protobuf.ByteString value) {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -1845,7 +1845,7 @@ public boolean hasKeySet() {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -1873,7 +1873,7 @@ public com.google.spanner.v1.KeySet getKeySet() {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -1905,7 +1905,7 @@ public Builder setKeySet(com.google.spanner.v1.KeySet value) {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -1934,7 +1934,7 @@ public Builder setKeySet(com.google.spanner.v1.KeySet.Builder builderForValue) {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -1971,7 +1971,7 @@ public Builder mergeKeySet(com.google.spanner.v1.KeySet value) {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -2000,7 +2000,7 @@ public Builder clearKeySet() {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -2024,7 +2024,7 @@ public com.google.spanner.v1.KeySet.Builder getKeySetBuilder() {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
@@ -2050,7 +2050,7 @@ public com.google.spanner.v1.KeySetOrBuilder getKeySetOrBuilder() {
      * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
      * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
      * 
                    
      *
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequestOrBuilder.java
index 446b907818..8f193aba28 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequestOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PartitionReadRequestOrBuilder.java
@@ -226,7 +226,7 @@ public interface PartitionReadRequestOrBuilder
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
@@ -248,7 +248,7 @@ public interface PartitionReadRequestOrBuilder
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
@@ -270,7 +270,7 @@ public interface PartitionReadRequestOrBuilder
    * [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
    * index keys in [index][google.spanner.v1.PartitionReadRequest.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.
    * 
                    
    *
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNode.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNode.java
index be91dfdf57..03dd67830d 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNode.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNode.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                    - * Node information for nodes appearing in a [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
+ * Node information for nodes appearing in a
+ * [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
  * 
                    
  *
  * Protobuf type {@code google.spanner.v1.PlanNode}
@@ -69,8 +70,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                    -   * The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between the two different kinds of
-   * nodes that can appear in a query plan.
+   * The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between
+   * the two different kinds of nodes that can appear in a query plan.
    * 
                    
    *
    * Protobuf enum {@code google.spanner.v1.PlanNode.Kind}
@@ -289,14 +290,14 @@ public interface ChildLinkOrBuilder
      *
      *
      * 
                    -     * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-     * to an output variable of the parent node. The field carries the name of
-     * the output variable.
-     * For example, a `TableScan` operator that reads rows from a table will
-     * have child links to the `SCALAR` nodes representing the output variables
-     * created for each column that is read by the operator. The corresponding
-     * `variable` fields will be set to the variable names assigned to the
-     * columns.
+     * Only present if the child node is
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+     * output variable of the parent node. The field carries the name of the
+     * output variable. For example, a `TableScan` operator that reads rows from
+     * a table will have child links to the `SCALAR` nodes representing the
+     * output variables created for each column that is read by the operator.
+     * The corresponding `variable` fields will be set to the variable names
+     * assigned to the columns.
      * 
                    
      *
      * string variable = 3;
@@ -309,14 +310,14 @@ public interface ChildLinkOrBuilder
      *
      *
      * 
                    -     * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-     * to an output variable of the parent node. The field carries the name of
-     * the output variable.
-     * For example, a `TableScan` operator that reads rows from a table will
-     * have child links to the `SCALAR` nodes representing the output variables
-     * created for each column that is read by the operator. The corresponding
-     * `variable` fields will be set to the variable names assigned to the
-     * columns.
+     * Only present if the child node is
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+     * output variable of the parent node. The field carries the name of the
+     * output variable. For example, a `TableScan` operator that reads rows from
+     * a table will have child links to the `SCALAR` nodes representing the
+     * output variables created for each column that is read by the operator.
+     * The corresponding `variable` fields will be set to the variable names
+     * assigned to the columns.
      * 
                    
      *
      * string variable = 3;
@@ -460,14 +461,14 @@ public com.google.protobuf.ByteString getTypeBytes() {
      *
      *
      * 
                    -     * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-     * to an output variable of the parent node. The field carries the name of
-     * the output variable.
-     * For example, a `TableScan` operator that reads rows from a table will
-     * have child links to the `SCALAR` nodes representing the output variables
-     * created for each column that is read by the operator. The corresponding
-     * `variable` fields will be set to the variable names assigned to the
-     * columns.
+     * Only present if the child node is
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+     * output variable of the parent node. The field carries the name of the
+     * output variable. For example, a `TableScan` operator that reads rows from
+     * a table will have child links to the `SCALAR` nodes representing the
+     * output variables created for each column that is read by the operator.
+     * The corresponding `variable` fields will be set to the variable names
+     * assigned to the columns.
      * 
                    
      *
      * string variable = 3;
@@ -491,14 +492,14 @@ public java.lang.String getVariable() {
      *
      *
      * 
                    -     * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-     * to an output variable of the parent node. The field carries the name of
-     * the output variable.
-     * For example, a `TableScan` operator that reads rows from a table will
-     * have child links to the `SCALAR` nodes representing the output variables
-     * created for each column that is read by the operator. The corresponding
-     * `variable` fields will be set to the variable names assigned to the
-     * columns.
+     * Only present if the child node is
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+     * output variable of the parent node. The field carries the name of the
+     * output variable. For example, a `TableScan` operator that reads rows from
+     * a table will have child links to the `SCALAR` nodes representing the
+     * output variables created for each column that is read by the operator.
+     * The corresponding `variable` fields will be set to the variable names
+     * assigned to the columns.
      * 
                    
      *
      * string variable = 3;
@@ -1099,14 +1100,14 @@ public Builder setTypeBytes(com.google.protobuf.ByteString value) {
        *
        *
        * 
                    -       * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-       * to an output variable of the parent node. The field carries the name of
-       * the output variable.
-       * For example, a `TableScan` operator that reads rows from a table will
-       * have child links to the `SCALAR` nodes representing the output variables
-       * created for each column that is read by the operator. The corresponding
-       * `variable` fields will be set to the variable names assigned to the
-       * columns.
+       * Only present if the child node is
+       * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+       * output variable of the parent node. The field carries the name of the
+       * output variable. For example, a `TableScan` operator that reads rows from
+       * a table will have child links to the `SCALAR` nodes representing the
+       * output variables created for each column that is read by the operator.
+       * The corresponding `variable` fields will be set to the variable names
+       * assigned to the columns.
        * 
                    
        *
        * string variable = 3;
@@ -1129,14 +1130,14 @@ public java.lang.String getVariable() {
        *
        *
        * 
                    -       * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-       * to an output variable of the parent node. The field carries the name of
-       * the output variable.
-       * For example, a `TableScan` operator that reads rows from a table will
-       * have child links to the `SCALAR` nodes representing the output variables
-       * created for each column that is read by the operator. The corresponding
-       * `variable` fields will be set to the variable names assigned to the
-       * columns.
+       * Only present if the child node is
+       * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+       * output variable of the parent node. The field carries the name of the
+       * output variable. For example, a `TableScan` operator that reads rows from
+       * a table will have child links to the `SCALAR` nodes representing the
+       * output variables created for each column that is read by the operator.
+       * The corresponding `variable` fields will be set to the variable names
+       * assigned to the columns.
        * 
                    
        *
        * string variable = 3;
@@ -1159,14 +1160,14 @@ public com.google.protobuf.ByteString getVariableBytes() {
        *
        *
        * 
                    -       * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-       * to an output variable of the parent node. The field carries the name of
-       * the output variable.
-       * For example, a `TableScan` operator that reads rows from a table will
-       * have child links to the `SCALAR` nodes representing the output variables
-       * created for each column that is read by the operator. The corresponding
-       * `variable` fields will be set to the variable names assigned to the
-       * columns.
+       * Only present if the child node is
+       * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+       * output variable of the parent node. The field carries the name of the
+       * output variable. For example, a `TableScan` operator that reads rows from
+       * a table will have child links to the `SCALAR` nodes representing the
+       * output variables created for each column that is read by the operator.
+       * The corresponding `variable` fields will be set to the variable names
+       * assigned to the columns.
        * 
                    
        *
        * string variable = 3;
@@ -1188,14 +1189,14 @@ public Builder setVariable(java.lang.String value) {
        *
        *
        * 
                    -       * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-       * to an output variable of the parent node. The field carries the name of
-       * the output variable.
-       * For example, a `TableScan` operator that reads rows from a table will
-       * have child links to the `SCALAR` nodes representing the output variables
-       * created for each column that is read by the operator. The corresponding
-       * `variable` fields will be set to the variable names assigned to the
-       * columns.
+       * Only present if the child node is
+       * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+       * output variable of the parent node. The field carries the name of the
+       * output variable. For example, a `TableScan` operator that reads rows from
+       * a table will have child links to the `SCALAR` nodes representing the
+       * output variables created for each column that is read by the operator.
+       * The corresponding `variable` fields will be set to the variable names
+       * assigned to the columns.
        * 
                    
        *
        * string variable = 3;
@@ -1213,14 +1214,14 @@ public Builder clearVariable() {
        *
        *
        * 
                    -       * Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-       * to an output variable of the parent node. The field carries the name of
-       * the output variable.
-       * For example, a `TableScan` operator that reads rows from a table will
-       * have child links to the `SCALAR` nodes representing the output variables
-       * created for each column that is read by the operator. The corresponding
-       * `variable` fields will be set to the variable names assigned to the
-       * columns.
+       * Only present if the child node is
+       * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+       * output variable of the parent node. The field carries the name of the
+       * output variable. For example, a `TableScan` operator that reads rows from
+       * a table will have child links to the `SCALAR` nodes representing the
+       * output variables created for each column that is read by the operator.
+       * The corresponding `variable` fields will be set to the variable names
+       * assigned to the columns.
        * 
                    
        *
        * string variable = 3;
@@ -2434,7 +2435,8 @@ public com.google.spanner.v1.PlanNode.ShortRepresentation getDefaultInstanceForT
    *
    *
    * 
                    -   * The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+   * The `PlanNode`'s index in [node
+   * list][google.spanner.v1.QueryPlan.plan_nodes].
    * 
                    
    *
    * int32 index = 1;
@@ -2455,9 +2457,9 @@ public int getIndex() {
    * 
                        * Used to determine the type of node. May be needed for visualizing
    * different kinds of nodes differently. For example, If the node is a
-   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-   * which can be used to directly embed a description of the node in its
-   * parent.
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+   * condensed representation which can be used to directly embed a description
+   * of the node in its parent.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -2475,9 +2477,9 @@ public int getKindValue() {
    * 
                        * Used to determine the type of node. May be needed for visualizing
    * different kinds of nodes differently. For example, If the node is a
-   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-   * which can be used to directly embed a description of the node in its
-   * parent.
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+   * condensed representation which can be used to directly embed a description
+   * of the node in its parent.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -2627,7 +2629,8 @@ public com.google.spanner.v1.PlanNode.ChildLinkOrBuilder getChildLinksOrBuilder(
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -2643,7 +2646,8 @@ public boolean hasShortRepresentation() {
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -2661,7 +2665,8 @@ public com.google.spanner.v1.PlanNode.ShortRepresentation getShortRepresentation
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -3039,7 +3044,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                    -   * Node information for nodes appearing in a [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
+   * Node information for nodes appearing in a
+   * [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
    * 
                    
    *
    * Protobuf type {@code google.spanner.v1.PlanNode}
@@ -3380,7 +3386,8 @@ public Builder mergeFrom(
      *
      *
      * 
                    -     * The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+     * The `PlanNode`'s index in [node
+     * list][google.spanner.v1.QueryPlan.plan_nodes].
      * 
                    
      *
      * int32 index = 1;
@@ -3396,7 +3403,8 @@ public int getIndex() {
      *
      *
      * 
                    -     * The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+     * The `PlanNode`'s index in [node
+     * list][google.spanner.v1.QueryPlan.plan_nodes].
      * 
                    
      *
      * int32 index = 1;
@@ -3416,7 +3424,8 @@ public Builder setIndex(int value) {
      *
      *
      * 
                    -     * The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+     * The `PlanNode`'s index in [node
+     * list][google.spanner.v1.QueryPlan.plan_nodes].
      * 
                    
      *
      * int32 index = 1;
@@ -3438,9 +3447,9 @@ public Builder clearIndex() {
      * 
                          * Used to determine the type of node. May be needed for visualizing
      * different kinds of nodes differently. For example, If the node is a
-     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-     * which can be used to directly embed a description of the node in its
-     * parent.
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+     * condensed representation which can be used to directly embed a description
+     * of the node in its parent.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -3458,9 +3467,9 @@ public int getKindValue() {
      * 
                          * Used to determine the type of node. May be needed for visualizing
      * different kinds of nodes differently. For example, If the node is a
-     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-     * which can be used to directly embed a description of the node in its
-     * parent.
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+     * condensed representation which can be used to directly embed a description
+     * of the node in its parent.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -3481,9 +3490,9 @@ public Builder setKindValue(int value) {
      * 
                          * Used to determine the type of node. May be needed for visualizing
      * different kinds of nodes differently. For example, If the node is a
-     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-     * which can be used to directly embed a description of the node in its
-     * parent.
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+     * condensed representation which can be used to directly embed a description
+     * of the node in its parent.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -3503,9 +3512,9 @@ public com.google.spanner.v1.PlanNode.Kind getKind() {
      * 
                          * Used to determine the type of node. May be needed for visualizing
      * different kinds of nodes differently. For example, If the node is a
-     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-     * which can be used to directly embed a description of the node in its
-     * parent.
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+     * condensed representation which can be used to directly embed a description
+     * of the node in its parent.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -3529,9 +3538,9 @@ public Builder setKind(com.google.spanner.v1.PlanNode.Kind value) {
      * 
                          * Used to determine the type of node. May be needed for visualizing
      * different kinds of nodes differently. For example, If the node is a
-     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-     * which can be used to directly embed a description of the node in its
-     * parent.
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+     * condensed representation which can be used to directly embed a description
+     * of the node in its parent.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -4034,7 +4043,8 @@ public com.google.spanner.v1.PlanNode.ChildLink.Builder addChildLinksBuilder(int
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4049,7 +4059,8 @@ public boolean hasShortRepresentation() {
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4070,7 +4081,8 @@ public com.google.spanner.v1.PlanNode.ShortRepresentation getShortRepresentation
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4094,7 +4106,8 @@ public Builder setShortRepresentation(
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4115,7 +4128,8 @@ public Builder setShortRepresentation(
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4145,7 +4159,8 @@ public Builder mergeShortRepresentation(
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4165,7 +4180,8 @@ public Builder clearShortRepresentation() {
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4181,7 +4197,8 @@ public Builder clearShortRepresentation() {
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -4201,7 +4218,8 @@ public Builder clearShortRepresentation() {
      *
      *
      * 
                    -     * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+     * Condensed representation for
+     * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
      * 
                    
      *
      * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNodeOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNodeOrBuilder.java
index dea5935593..8fa6e99b64 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNodeOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/PlanNodeOrBuilder.java
@@ -28,7 +28,8 @@ public interface PlanNodeOrBuilder
    *
    *
    * 
                    -   * The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+   * The `PlanNode`'s index in [node
+   * list][google.spanner.v1.QueryPlan.plan_nodes].
    * 
                    
    *
    * int32 index = 1;
@@ -43,9 +44,9 @@ public interface PlanNodeOrBuilder
    * 
                        * Used to determine the type of node. May be needed for visualizing
    * different kinds of nodes differently. For example, If the node is a
-   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-   * which can be used to directly embed a description of the node in its
-   * parent.
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+   * condensed representation which can be used to directly embed a description
+   * of the node in its parent.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -60,9 +61,9 @@ public interface PlanNodeOrBuilder
    * 
                        * Used to determine the type of node. May be needed for visualizing
    * different kinds of nodes differently. For example, If the node is a
-   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-   * which can be used to directly embed a description of the node in its
-   * parent.
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+   * condensed representation which can be used to directly embed a description
+   * of the node in its parent.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.Kind kind = 2;
@@ -157,7 +158,8 @@ public interface PlanNodeOrBuilder
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -170,7 +172,8 @@ public interface PlanNodeOrBuilder
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
@@ -183,7 +186,8 @@ public interface PlanNodeOrBuilder
    *
    *
    * 
                    -   * Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+   * Condensed representation for
+   * [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
    * 
                    
    *
    * .google.spanner.v1.PlanNode.ShortRepresentation short_representation = 5;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlan.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlan.java
index 394641a2ae..30f4a95bf4 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlan.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlan.java
@@ -73,8 +73,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -89,8 +89,8 @@ public java.util.List getPlanNodesList() {
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -106,8 +106,8 @@ public java.util.List getPlanNodesList() {
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -122,8 +122,8 @@ public int getPlanNodesCount() {
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -138,8 +138,8 @@ public com.google.spanner.v1.PlanNode getPlanNodes(int index) {
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -554,8 +554,8 @@ private void ensurePlanNodesIsMutable() {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -573,8 +573,8 @@ public java.util.List getPlanNodesList() {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -592,8 +592,8 @@ public int getPlanNodesCount() {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -611,8 +611,8 @@ public com.google.spanner.v1.PlanNode getPlanNodes(int index) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -636,8 +636,8 @@ public Builder setPlanNodes(int index, com.google.spanner.v1.PlanNode value) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -658,8 +658,8 @@ public Builder setPlanNodes(int index, com.google.spanner.v1.PlanNode.Builder bu
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -683,8 +683,8 @@ public Builder addPlanNodes(com.google.spanner.v1.PlanNode value) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -708,8 +708,8 @@ public Builder addPlanNodes(int index, com.google.spanner.v1.PlanNode value) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -730,8 +730,8 @@ public Builder addPlanNodes(com.google.spanner.v1.PlanNode.Builder builderForVal
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -752,8 +752,8 @@ public Builder addPlanNodes(int index, com.google.spanner.v1.PlanNode.Builder bu
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -775,8 +775,8 @@ public Builder addAllPlanNodes(
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -797,8 +797,8 @@ public Builder clearPlanNodes() {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -819,8 +819,8 @@ public Builder removePlanNodes(int index) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -834,8 +834,8 @@ public com.google.spanner.v1.PlanNode.Builder getPlanNodesBuilder(int index) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -853,8 +853,8 @@ public com.google.spanner.v1.PlanNodeOrBuilder getPlanNodesOrBuilder(int index)
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -873,8 +873,8 @@ public com.google.spanner.v1.PlanNodeOrBuilder getPlanNodesOrBuilder(int index)
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -889,8 +889,8 @@ public com.google.spanner.v1.PlanNode.Builder addPlanNodesBuilder() {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -905,8 +905,8 @@ public com.google.spanner.v1.PlanNode.Builder addPlanNodesBuilder(int index) {
      *
      * 
                          * The nodes in the query plan. Plan nodes are returned in pre-order starting
-     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-     * `plan_nodes`.
+     * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+     * corresponds to its index in `plan_nodes`.
      * 
                    
      *
      * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlanOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlanOrBuilder.java
index 219ed42080..7b09d935bb 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlanOrBuilder.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/QueryPlanOrBuilder.java
@@ -29,8 +29,8 @@ public interface QueryPlanOrBuilder
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -42,8 +42,8 @@ public interface QueryPlanOrBuilder
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -55,8 +55,8 @@ public interface QueryPlanOrBuilder
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -68,8 +68,8 @@ public interface QueryPlanOrBuilder
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
@@ -81,8 +81,8 @@ public interface QueryPlanOrBuilder
    *
    * 
                        * The nodes in the query plan. Plan nodes are returned in pre-order starting
-   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-   * `plan_nodes`.
+   * with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+   * corresponds to its index in `plan_nodes`.
    * 
                    
    *
    * repeated .google.spanner.v1.PlanNode plan_nodes = 1;
diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequest.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequest.java
index bd3294af90..2ae6e5b964 100644
--- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequest.java
+++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequest.java
@@ -88,7 +88,7 @@ public enum OrderBy implements com.google.protobuf.ProtocolMessageEnum {
      * 
                          * 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;
@@ -101,7 +101,7 @@ public enum OrderBy implements com.google.protobuf.ProtocolMessageEnum {
      * 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;
@@ -126,7 +126,7 @@ public enum OrderBy implements com.google.protobuf.ProtocolMessageEnum {
      * 
                          * 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;
@@ -140,7 +140,7 @@ public enum OrderBy implements com.google.protobuf.ProtocolMessageEnum {
      * 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; @@ -257,7 +257,7 @@ public enum LockHint implements com.google.protobuf.ProtocolMessageEnum { * 
                          * Default value.
      *
-     * LOCK_HINT_UNSPECIFIED is equivalent to LOCK_HINT_SHARED.
+     * `LOCK_HINT_UNSPECIFIED` is equivalent to `LOCK_HINT_SHARED`.
      *
                    * * LOCK_HINT_UNSPECIFIED = 0; @@ -302,8 +302,8 @@ public enum LockHint implements com.google.protobuf.ProtocolMessageEnum { * 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. * @@ -326,7 +326,7 @@ public enum LockHint implements com.google.protobuf.ProtocolMessageEnum { * 
                          * Default value.
      *
-     * LOCK_HINT_UNSPECIFIED is equivalent to LOCK_HINT_SHARED.
+     * `LOCK_HINT_UNSPECIFIED` is equivalent to `LOCK_HINT_SHARED`.
      *
                    * * LOCK_HINT_UNSPECIFIED = 0; @@ -373,8 +373,8 @@ public enum LockHint implements com.google.protobuf.ProtocolMessageEnum { * 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. * @@ -791,11 +791,11 @@ public com.google.protobuf.ByteString getColumnsBytes(int index) { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -822,11 +822,11 @@ public boolean hasKeySet() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -853,11 +853,11 @@ public com.google.spanner.v1.KeySet getKeySet() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -876,7 +876,7 @@ public com.google.spanner.v1.KeySetOrBuilder getKeySetOrBuilder() { * * 
                        * 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.
    *
                    * @@ -920,8 +920,8 @@ public com.google.protobuf.ByteString getResumeToken() { * * * 
                    -   * 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.
    *
                    @@ -1051,7 +1051,7 @@ public com.google.spanner.v1.DirectedReadOptionsOrBuilder getDirectedReadOptions * 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. * * @@ -1073,11 +1073,12 @@ public boolean getDataBoostEnabled() { * 
                        * 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).
    *
                    * * @@ -1097,11 +1098,12 @@ public int getOrderByValue() { * 
                        * 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).
    *
                    * * @@ -2652,11 +2654,11 @@ public Builder addColumnsBytes(com.google.protobuf.ByteString value) { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2682,11 +2684,11 @@ public boolean hasKeySet() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2716,11 +2718,11 @@ public com.google.spanner.v1.KeySet getKeySet() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2754,11 +2756,11 @@ public Builder setKeySet(com.google.spanner.v1.KeySet value) { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2789,11 +2791,11 @@ public Builder setKeySet(com.google.spanner.v1.KeySet.Builder builderForValue) { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2832,11 +2834,11 @@ public Builder mergeKeySet(com.google.spanner.v1.KeySet value) { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2867,11 +2869,11 @@ public Builder clearKeySet() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2897,11 +2899,11 @@ public com.google.spanner.v1.KeySet.Builder getKeySetBuilder() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2929,11 +2931,11 @@ public com.google.spanner.v1.KeySetOrBuilder getKeySetOrBuilder() { * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -2963,7 +2965,7 @@ public com.google.spanner.v1.KeySetOrBuilder getKeySetOrBuilder() { * * 
                          * 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.
      *
                    * @@ -2981,7 +2983,7 @@ public long getLimit() { * * 
                          * 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.
      *
                    * @@ -3003,7 +3005,7 @@ public Builder setLimit(long value) { * * 
                          * 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.
      *
                    * @@ -3097,8 +3099,8 @@ public Builder clearResumeToken() { * * * 
                    -     * 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.
      *
                    @@ -3116,8 +3118,8 @@ public com.google.protobuf.ByteString getPartitionToken() { * * * 
                    -     * 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.
      *
                    @@ -3141,8 +3143,8 @@ public Builder setPartitionToken(com.google.protobuf.ByteString value) { * * * 
                    -     * 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.
      *
                    @@ -3557,7 +3559,7 @@ public com.google.spanner.v1.DirectedReadOptionsOrBuilder getDirectedReadOptions * 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. * * @@ -3577,7 +3579,7 @@ public boolean getDataBoostEnabled() { * 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. * * @@ -3601,7 +3603,7 @@ public Builder setDataBoostEnabled(boolean value) { * 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. * * @@ -3624,11 +3626,12 @@ public Builder clearDataBoostEnabled() { * 
                          * 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).
      *
                    * * @@ -3648,11 +3651,12 @@ public int getOrderByValue() { * 
                          * 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).
      *
                    * * @@ -3675,11 +3679,12 @@ public Builder setOrderByValue(int value) { * 
                          * 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).
      *
                    * * @@ -3701,11 +3706,12 @@ public com.google.spanner.v1.ReadRequest.OrderBy getOrderBy() { * 
                          * 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).
      *
                    * * @@ -3731,11 +3737,12 @@ public Builder setOrderBy(com.google.spanner.v1.ReadRequest.OrderBy value) { * 
                          * 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).
      *
                    * * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequestOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequestOrBuilder.java index 09909ff935..3cf4fa6a43 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequestOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/ReadRequestOrBuilder.java @@ -228,11 +228,11 @@ public interface ReadRequestOrBuilder * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -256,11 +256,11 @@ public interface ReadRequestOrBuilder * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -284,11 +284,11 @@ public interface ReadRequestOrBuilder * If the [partition_token][google.spanner.v1.ReadRequest.partition_token] * field is empty, rows are yielded in table primary key order (if * [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - * [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - * not empty, rows will be yielded in an unspecified order. + * (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + * [partition_token][google.spanner.v1.ReadRequest.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. * * @@ -301,7 +301,7 @@ public interface ReadRequestOrBuilder * * 
                        * 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.
    *
                    * @@ -333,8 +333,8 @@ public interface ReadRequestOrBuilder * * * 
                    -   * 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.
    *
                    @@ -426,7 +426,7 @@ public interface ReadRequestOrBuilder * 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. * * @@ -442,11 +442,12 @@ public interface ReadRequestOrBuilder * 
                        * 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).
    *
                    * * @@ -463,11 +464,12 @@ public interface ReadRequestOrBuilder * 
                        * 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).
    *
                    * * diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptions.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptions.java index a918e14e30..aa0e8411d3 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptions.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptions.java @@ -70,22 +70,22 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
                    -   * The relative priority for requests. Note that priority is not applicable
+   * The relative priority for requests. Note that priority isn't applicable
    * for [BeginTransaction][google.spanner.v1.Spanner.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.
    *
                    * * Protobuf enum {@code google.spanner.v1.RequestOptions.Priority} @@ -311,14 +311,14 @@ public com.google.spanner.v1.RequestOptions.Priority getPriority() { * 
                        * 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.
    *
                    * * string request_tag = 2; @@ -344,14 +344,14 @@ public java.lang.String getRequestTag() { * 
                        * 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.
    *
                    * * string request_tag = 2; @@ -381,16 +381,16 @@ public com.google.protobuf.ByteString getRequestTagBytes() { * * 
                        * 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.
    *
                    * * string transaction_tag = 3; @@ -415,16 +415,16 @@ public java.lang.String getTransactionTag() { * * 
                        * 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.
    *
                    * * string transaction_tag = 3; @@ -934,14 +934,14 @@ public Builder clearPriority() { * 
                          * 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.
      *
                    * * string request_tag = 2; @@ -966,14 +966,14 @@ public java.lang.String getRequestTag() { * 
                          * 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.
      *
                    * * string request_tag = 2; @@ -998,14 +998,14 @@ public com.google.protobuf.ByteString getRequestTagBytes() { * 
                          * 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.
      *
                    * * string request_tag = 2; @@ -1029,14 +1029,14 @@ public Builder setRequestTag(java.lang.String value) { * 
                          * 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.
      *
                    * * string request_tag = 2; @@ -1056,14 +1056,14 @@ public Builder clearRequestTag() { * 
                          * 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.
      *
                    * * string request_tag = 2; @@ -1089,16 +1089,16 @@ public Builder setRequestTagBytes(com.google.protobuf.ByteString value) { * * 
                          * 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.
      *
                    * * string transaction_tag = 3; @@ -1122,16 +1122,16 @@ public java.lang.String getTransactionTag() { * * 
                          * 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.
      *
                    * * string transaction_tag = 3; @@ -1155,16 +1155,16 @@ public com.google.protobuf.ByteString getTransactionTagBytes() { * * 
                          * 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.
      *
                    * * string transaction_tag = 3; @@ -1187,16 +1187,16 @@ public Builder setTransactionTag(java.lang.String value) { * * 
                          * 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.
      *
                    * * string transaction_tag = 3; @@ -1215,16 +1215,16 @@ public Builder clearTransactionTag() { * * 
                          * 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.
      *
                    * * string transaction_tag = 3; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptionsOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptionsOrBuilder.java index 7fb354d75e..49e2d07348 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptionsOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/RequestOptionsOrBuilder.java @@ -56,14 +56,14 @@ public interface RequestOptionsOrBuilder * 
                        * 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.
    *
                    * * string request_tag = 2; @@ -78,14 +78,14 @@ public interface RequestOptionsOrBuilder * 
                        * 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.
    *
                    * * string request_tag = 2; @@ -99,16 +99,16 @@ public interface RequestOptionsOrBuilder * * 
                        * 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.
    *
                    * * string transaction_tag = 3; @@ -122,16 +122,16 @@ public interface RequestOptionsOrBuilder * * 
                        * 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.
    *
                    * * string transaction_tag = 3; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Session.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Session.java index 6ca8532d86..c4c2be7437 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Session.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/Session.java @@ -327,7 +327,7 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() { * * * 
                    -   * 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.
    *
                    * @@ -346,7 +346,7 @@ public boolean hasApproximateLastUseTime() { * * * 
                    -   * 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.
    *
                    * @@ -367,7 +367,7 @@ public com.google.protobuf.Timestamp getApproximateLastUseTime() { * * * 
                    -   * 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.
    *
                    * @@ -442,13 +442,14 @@ public com.google.protobuf.ByteString getCreatorRoleBytes() { * * * 
                    -   * 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
-   * [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via
-   * [BatchCreateSessions][google.spanner.v1.Spanner.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
+   * [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create
+   * multiplexed sessions. Don't use
+   * [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to
+   * create a multiplexed session. You can't delete or list multiplexed
+   * sessions.
    *
                    * * bool multiplexed = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -1545,7 +1546,7 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() { * * * 
                    -     * 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.
      *
                    * @@ -1563,7 +1564,7 @@ public boolean hasApproximateLastUseTime() { * * * 
                    -     * 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.
      *
                    * @@ -1587,7 +1588,7 @@ public com.google.protobuf.Timestamp getApproximateLastUseTime() { * * * 
                    -     * 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.
      *
                    * @@ -1613,7 +1614,7 @@ public Builder setApproximateLastUseTime(com.google.protobuf.Timestamp value) { * * * 
                    -     * 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.
      *
                    * @@ -1637,7 +1638,7 @@ public Builder setApproximateLastUseTime( * * * 
                    -     * 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.
      *
                    * @@ -1668,7 +1669,7 @@ public Builder mergeApproximateLastUseTime(com.google.protobuf.Timestamp value) * * * 
                    -     * 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.
      *
                    * @@ -1691,7 +1692,7 @@ public Builder clearApproximateLastUseTime() { * * * 
                    -     * 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.
      *
                    * @@ -1709,7 +1710,7 @@ public com.google.protobuf.Timestamp.Builder getApproximateLastUseTimeBuilder() * * * 
                    -     * 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.
      *
                    * @@ -1731,7 +1732,7 @@ public com.google.protobuf.TimestampOrBuilder getApproximateLastUseTimeOrBuilder * * * 
                    -     * 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.
      *
                    * @@ -1873,13 +1874,14 @@ public Builder setCreatorRoleBytes(com.google.protobuf.ByteString value) { * * * 
                    -     * 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
-     * [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via
-     * [BatchCreateSessions][google.spanner.v1.Spanner.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
+     * [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create
+     * multiplexed sessions. Don't use
+     * [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to
+     * create a multiplexed session. You can't delete or list multiplexed
+     * sessions.
      *
                    * * bool multiplexed = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -1895,13 +1897,14 @@ public boolean getMultiplexed() { * * * 
                    -     * 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
-     * [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via
-     * [BatchCreateSessions][google.spanner.v1.Spanner.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
+     * [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create
+     * multiplexed sessions. Don't use
+     * [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to
+     * create a multiplexed session. You can't delete or list multiplexed
+     * sessions.
      *
                    * * bool multiplexed = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -1921,13 +1924,14 @@ public Builder setMultiplexed(boolean value) { * * * 
                    -     * 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
-     * [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via
-     * [BatchCreateSessions][google.spanner.v1.Spanner.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
+     * [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create
+     * multiplexed sessions. Don't use
+     * [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to
+     * create a multiplexed session. You can't delete or list multiplexed
+     * sessions.
      *
                    * * bool multiplexed = 6 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SessionOrBuilder.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SessionOrBuilder.java index 4ad812a2ca..127dea4f25 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SessionOrBuilder.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SessionOrBuilder.java @@ -197,7 +197,7 @@ java.lang.String getLabelsOrDefault( * * * 
                    -   * 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.
    *
                    * @@ -213,7 +213,7 @@ java.lang.String getLabelsOrDefault( * * * 
                    -   * 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.
    *
                    * @@ -229,7 +229,7 @@ java.lang.String getLabelsOrDefault( * * * 
                    -   * 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.
    *
                    * @@ -269,13 +269,14 @@ java.lang.String getLabelsOrDefault( * * * 
                    -   * 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
-   * [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via
-   * [BatchCreateSessions][google.spanner.v1.Spanner.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
+   * [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create
+   * multiplexed sessions. Don't use
+   * [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to
+   * create a multiplexed session. You can't delete or list multiplexed
+   * sessions.
    *
                    * * bool multiplexed = 6 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerProto.java b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerProto.java index cc3a13e16a..2774c37b02 100644 --- a/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerProto.java +++ b/proto-google-cloud-spanner-v1/src/main/java/com/google/spanner/v1/SpannerProto.java @@ -196,7 +196,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\020session_template\030\002 \001(\0132\032.google.spanner.v1.Session\022\032\n\r" + "session_count\030\003 \001(\005B\003\340A\002\"J\n" + "\033BatchCreateSessionsResponse\022+\n" - + "\007session\030\001 \003(\0132\032.google.spanner.v1.Session\"\243\003\n" + + "\007session\030\001 \003(\0132\032.google.spanner.v1.Session\"\270\003\n" + "\007Session\022\021\n" + "\004name\030\001 \001(\tB\003\340A\003\0226\n" + "\006labels\030\002 \003(\0132&.google.spanner.v1.Session.LabelsEntry\0224\n" @@ -207,9 +207,9 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\013multiplexed\030\006 \001(\010B\003\340A\001\032-\n" + "\013LabelsEntry\022\013\n" + "\003key\030\001 \001(\t\022\r\n" - + "\005value\030\002 \001(\t:\0028\001:t\352Aq\n" - + "\036spanner.googleapis.com/Session\022Oprojects/{project}/instances/{i" - + "nstance}/databases/{database}/sessions/{session}\"I\n" + + "\005value\030\002 \001(\t:\0028\001:\210\001\352A\204\001\n" + + "\036spanner.googleapis.com/Session\022Oprojects/{project}/instances/" + + "{instance}/databases/{database}/sessions/{session}*\010sessions2\007session\"I\n" + "\021GetSessionRequest\0224\n" + "\004name\030\001 \001(\tB&\340A\002\372A \n" + "\036spanner.googleapis.com/Session\"\207\001\n" @@ -235,25 +235,25 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\017PRIORITY_MEDIUM\020\002\022\021\n\r" + "PRIORITY_HIGH\020\003\"\352\004\n" + "\023DirectedReadOptions\022R\n" - + "\020include_replicas\030\001 \001(\01326.google.spa" - + "nner.v1.DirectedReadOptions.IncludeReplicasH\000\022R\n" - + "\020exclude_replicas\030\002 \001(\01326.google" - + ".spanner.v1.DirectedReadOptions.ExcludeReplicasH\000\032\255\001\n" + + "\020include_replicas\030\001" + + " \001(\01326.google.spanner.v1.DirectedReadOptions.IncludeReplicasH\000\022R\n" + + "\020exclude_replicas\030\002" + + " \001(\01326.google.spanner.v1.DirectedReadOptions.ExcludeReplicasH\000\032\255\001\n" + "\020ReplicaSelection\022\020\n" + "\010location\030\001 \001(\t\022J\n" - + "\004type\030\002 \001(\0162<.google.spanner." - + "v1.DirectedReadOptions.ReplicaSelection.Type\";\n" + + "\004type\030\002 " + + "\001(\0162<.google.spanner.v1.DirectedReadOptions.ReplicaSelection.Type\";\n" + "\004Type\022\024\n" + "\020TYPE_UNSPECIFIED\020\000\022\016\n\n" + "READ_WRITE\020\001\022\r\n" + "\tREAD_ONLY\020\002\032\206\001\n" + "\017IncludeReplicas\022S\n" - + "\022replica_selections\030\001 \003(\01327.goog" - + "le.spanner.v1.DirectedReadOptions.ReplicaSelection\022\036\n" + + "\022replica_selections\030\001" + + " \003(\01327.google.spanner.v1.DirectedReadOptions.ReplicaSelection\022\036\n" + "\026auto_failover_disabled\030\002 \001(\010\032f\n" + "\017ExcludeReplicas\022S\n" - + "\022replica_selections\030\001" - + " \003(\01327.google.spanner.v1.DirectedReadOptions.ReplicaSelectionB\n\n" + + "\022replica_selections\030\001 \003(\01327.google." + + "spanner.v1.DirectedReadOptions.ReplicaSelectionB\n\n" + "\010replicas\"\215\007\n" + "\021ExecuteSqlRequest\0227\n" + "\007session\030\001 \001(\tB&\340A\002\372A \n" @@ -261,8 +261,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\013transaction\030\002 \001(\0132&.google.spanner.v1.TransactionSelector\022\020\n" + "\003sql\030\003 \001(\tB\003\340A\002\022\'\n" + "\006params\030\004 \001(\0132\027.google.protobuf.Struct\022I\n" - + "\013param_types\030\005" - + " \003(\01324.google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry\022\024\n" + + "\013param_types\030\005 \003(\0132" + + "4.google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry\022\024\n" + "\014resume_token\030\006 \001(\014\022B\n\n" + "query_mode\030\007 \001(\0162..google.spanner.v1.ExecuteSqlRequest.QueryMode\022\027\n" + "\017partition_token\030\010 \001(\014\022\r\n" @@ -289,26 +289,26 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\026ExecuteBatchDmlRequest\0227\n" + "\007session\030\001 \001(\tB&\340A\002\372A \n" + "\036spanner.googleapis.com/Session\022@\n" - + "\013transaction\030\002" - + " \001(\0132&.google.spanner.v1.TransactionSelectorB\003\340A\002\022L\n\n" - + "statements\030\003 \003(\013" - + "23.google.spanner.v1.ExecuteBatchDmlRequest.StatementB\003\340A\002\022\022\n" + + "\013transaction\030\002 \001(\0132&.g" + + "oogle.spanner.v1.TransactionSelectorB\003\340A\002\022L\n\n" + + "statements\030\003 \003(\01323.google.spanner.v" + + "1.ExecuteBatchDmlRequest.StatementB\003\340A\002\022\022\n" + "\005seqno\030\004 \001(\003B\003\340A\002\022:\n" + "\017request_options\030\005 \001(\0132!.google.spanner.v1.RequestOptions\022\034\n" + "\017last_statements\030\006 \001(\010B\003\340A\001\032\354\001\n" + "\tStatement\022\020\n" + "\003sql\030\001 \001(\tB\003\340A\002\022\'\n" + "\006params\030\002 \001(\0132\027.google.protobuf.Struct\022X\n" - + "\013param_types\030\003 \003(\0132C.google.spanner." - + "v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry\032J\n" + + "\013param_types\030\003 " + + "\003(\0132C.google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry\032J\n" + "\017ParamTypesEntry\022\013\n" + "\003key\030\001 \001(\t\022&\n" + "\005value\030\002 \001(\0132\027.google.spanner.v1.Type:\0028\001\"\303\001\n" + "\027ExecuteBatchDmlResponse\0221\n" + "\013result_sets\030\001 \003(\0132\034.google.spanner.v1.ResultSet\022\"\n" + "\006status\030\002 \001(\0132\022.google.rpc.Status\022Q\n" - + "\017precommit_token\030\003 \001(\01323.google.spa" - + "nner.v1.MultiplexedSessionPrecommitTokenB\003\340A\001\"H\n" + + "\017precommit_token\030\003" + + " \001(\01323.google.spanner.v1.MultiplexedSessionPrecommitTokenB\003\340A\001\"H\n" + "\020PartitionOptions\022\034\n" + "\024partition_size_bytes\030\001 \001(\003\022\026\n" + "\016max_partitions\030\002 \001(\003\"\243\003\n" @@ -318,8 +318,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\013transaction\030\002 \001(\0132&.google.spanner.v1.TransactionSelector\022\020\n" + "\003sql\030\003 \001(\tB\003\340A\002\022\'\n" + "\006params\030\004 \001(\0132\027.google.protobuf.Struct\022M\n" - + "\013param_types\030\005 \003(\01328.google.spanner" - + ".v1.PartitionQueryRequest.ParamTypesEntry\022>\n" + + "\013param_types\030\005" + + " \003(\01328.google.spanner.v1.PartitionQueryRequest.ParamTypesEntry\022>\n" + "\021partition_options\030\006 \001(\0132#.google.spanner.v1.PartitionOptions\032J\n" + "\017ParamTypesEntry\022\013\n" + "\003key\030\001 \001(\t\022&\n" @@ -356,8 +356,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\022data_boost_enabled\030\017 \001(\010\022=\n" + "\010order_by\030\020" + " \001(\0162&.google.spanner.v1.ReadRequest.OrderByB\003\340A\001\022?\n" - + "\tlock_hint\030\021 \001(\0162\'.goo" - + "gle.spanner.v1.ReadRequest.LockHintB\003\340A\001\"T\n" + + "\tlock_hint\030\021" + + " \001(\0162\'.google.spanner.v1.ReadRequest.LockHintB\003\340A\001\"T\n" + "\007OrderBy\022\030\n" + "\024ORDER_BY_UNSPECIFIED\020\000\022\030\n" + "\024ORDER_BY_PRIMARY_KEY\020\001\022\025\n" @@ -369,8 +369,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\027BeginTransactionRequest\0227\n" + "\007session\030\001 \001(\tB&\340A\002\372A \n" + "\036spanner.googleapis.com/Session\022;\n" - + "\007options\030\002 \001(\0132%.goo" - + "gle.spanner.v1.TransactionOptionsB\003\340A\002\022:\n" + + "\007options\030\002" + + " \001(\0132%.google.spanner.v1.TransactionOptionsB\003\340A\002\022:\n" + "\017request_options\030\003 \001(\0132!.google.spanner.v1.RequestOptions\0226\n" + "\014mutation_key\030\004" + " \001(\0132\033.google.spanner.v1.MutationB\003\340A\001\"\320\003\n\r" @@ -385,8 +385,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\020max_commit_delay\030\010" + " \001(\0132\031.google.protobuf.DurationB\003\340A\001\022:\n" + "\017request_options\030\006 \001(\0132!.google.spanner.v1.RequestOptions\022Q\n" - + "\017precommit_token\030\t \001(\01323.google.sp" - + "anner.v1.MultiplexedSessionPrecommitTokenB\003\340A\001B\r\n" + + "\017precommit_token\030\t" + + " \001(\01323.google.spanner.v1.MultiplexedSessionPrecommitTokenB\003\340A\001B\r\n" + "\013transaction\"g\n" + "\017RollbackRequest\0227\n" + "\007session\030\001 \001(\tB&\340A\002\372A \n" @@ -396,8 +396,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\007session\030\001 \001(\tB&\340A\002\372A \n" + "\036spanner.googleapis.com/Session\022:\n" + "\017request_options\030\003 \001(\0132!.google.spanner.v1.RequestOptions\022P\n" - + "\017mutation_groups\030\004" - + " \003(\01322.google.spanner.v1.BatchWriteRequest.MutationGroupB\003\340A\002\022,\n" + + "\017mutation_groups\030\004 \003(\01322.google" + + ".spanner.v1.BatchWriteRequest.MutationGroupB\003\340A\002\022,\n" + "\037exclude_txn_from_change_streams\030\005 \001(\010B\003\340A\001\032D\n\r" + "MutationGroup\0223\n" + "\tmutations\030\001 \003(\0132\033.google.spanner.v1.MutationB\003\340A\002\"\177\n" @@ -406,73 +406,73 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\006status\030\002 \001(\0132\022.google.rpc.Status\0224\n" + "\020commit_timestamp\030\003 \001(\0132\032.google.protobuf.Timestamp2\213\030\n" + "\007Spanner\022\246\001\n\r" - + "CreateSession\022\'.google.spanner.v1.CreateSessionRequest\032\032.google.spanner" - + ".v1.Session\"P\332A\010database\202\323\344\223\002?\":/v1/{dat" - + "abase=projects/*/instances/*/databases/*}/sessions:\001*\022\340\001\n" - + "\023BatchCreateSessions\022-.google.spanner.v1.BatchCreateSessionsReq" - + "uest\032..google.spanner.v1.BatchCreateSess" - + "ionsResponse\"j\332A\026database,session_count\202" - + "\323\344\223\002K\"F/v1/{database=projects/*/instance" - + "s/*/databases/*}/sessions:batchCreate:\001*\022\227\001\n\n" - + "GetSession\022$.google.spanner.v1.GetSessionRequest\032\032.google.spanner.v1.Sessio" - + "n\"G\332A\004name\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}\022\256\001\n" - + "\014ListSessions\022&.google.spanner.v1.ListSess" - + "ionsRequest\032\'.google.spanner.v1.ListSess" - + "ionsResponse\"M\332A\010database\202\323\344\223\002<\022:/v1/{da" - + "tabase=projects/*/instances/*/databases/*}/sessions\022\231\001\n\r" - + "DeleteSession\022\'.google.spanner.v1.DeleteSessionRequest\032\026.google." - + "protobuf.Empty\"G\332A\004name\202\323\344\223\002:*8/v1/{name" - + "=projects/*/instances/*/databases/*/sessions/*}\022\243\001\n\n" - + "ExecuteSql\022$.google.spanner.v1.ExecuteSqlRequest\032\034.google.spanner.v1" - + ".ResultSet\"Q\202\323\344\223\002K\"F/v1/{session=project" - + "s/*/instances/*/databases/*/sessions/*}:executeSql:\001*\022\276\001\n" - + "\023ExecuteStreamingSql\022$.google.spanner.v1.ExecuteSqlRequest\032#.go" - + "ogle.spanner.v1.PartialResultSet\"Z\202\323\344\223\002T" - + "\"O/v1/{session=projects/*/instances/*/da" - + "tabases/*/sessions/*}:executeStreamingSql:\001*0\001\022\300\001\n" - + "\017ExecuteBatchDml\022).google.spanner.v1.ExecuteBatchDmlRequest\032*.google.s" - + "panner.v1.ExecuteBatchDmlResponse\"V\202\323\344\223\002" - + "P\"K/v1/{session=projects/*/instances/*/d" - + "atabases/*/sessions/*}:executeBatchDml:\001*\022\221\001\n" - + "\004Read\022\036.google.spanner.v1.ReadReque" - + "st\032\034.google.spanner.v1.ResultSet\"K\202\323\344\223\002E" - + "\"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*\022\254\001\n\r" - + "StreamingRead\022\036.google.spanner.v1.ReadRequest\032" - + "#.google.spanner.v1.PartialResultSet\"T\202\323" - + "\344\223\002N\"I/v1/{session=projects/*/instances/" - + "*/databases/*/sessions/*}:streamingRead:\001*0\001\022\311\001\n" - + "\020BeginTransaction\022*.google.spanner.v1.BeginTransactionRequest\032\036.google.s" - + "panner.v1.Transaction\"i\332A\017session,option" - + "s\202\323\344\223\002Q\"L/v1/{session=projects/*/instanc" - + "es/*/databases/*/sessions/*}:beginTransaction:\001*\022\353\001\n" - + "\006Commit\022 .google.spanner.v1." - + "CommitRequest\032!.google.spanner.v1.CommitResponse\"\233\001\332A" - + " session,transaction_id,mutations\332A(session,single_use_transaction," - + "mutations\202\323\344\223\002G\"B/v1/{session=projects/*" - + "/instances/*/databases/*/sessions/*}:commit:\001*\022\260\001\n" - + "\010Rollback\022\".google.spanner.v1.RollbackRequest\032\026.google.protobuf.Empty\"" - + "h\332A\026session,transaction_id\202\323\344\223\002I\"D/v1/{s" - + "ession=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*\022\267\001\n" - + "\016PartitionQuery\022(.google.spanner.v1.PartitionQueryR" - + "equest\032$.google.spanner.v1.PartitionResp" - + "onse\"U\202\323\344\223\002O\"J/v1/{session=projects/*/in" - + "stances/*/databases/*/sessions/*}:partitionQuery:\001*\022\264\001\n\r" - + "PartitionRead\022\'.google.spanner.v1.PartitionReadRequest\032$.google." - + "spanner.v1.PartitionResponse\"T\202\323\344\223\002N\"I/v" - + "1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*\022\310\001\n\n" - + "BatchWrite\022$.google.spanner.v1.BatchWrite" - + "Request\032%.google.spanner.v1.BatchWriteRe" - + "sponse\"k\332A\027session,mutation_groups\202\323\344\223\002K" - + "\"F/v1/{session=projects/*/instances/*/da" - + "tabases/*/sessions/*}:batchWrite:\001*0\001\032w\312" - + "A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https:" - + "//www.googleapis.com/auth/spanner.dataB\221\002\n" - + "\025com.google.spanner.v1B\014SpannerProtoP\001" - + "Z5cloud.google.com/go/spanner/apiv1/span" - + "nerpb;spannerpb\252\002\027Google.Cloud.Spanner.V" - + "1\312\002\027Google\\Cloud\\Spanner\\V1\352\002\032Google::Cloud::Spanner::V1\352A_\n" - + "\037spanner.googleapis.com/Database\022 * * SERIALIZABLE = 1; @@ -150,8 +151,9 @@ public enum IsolationLevel implements com.google.protobuf.ProtocolMessageEnum { * actually occurred in parallel. Spanner assigns commit timestamps that * reflect the order of committed transactions to implement this property. * Spanner offers a stronger guarantee than serializability called external - * consistency. For further details, please refer to - * https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability. + * consistency. For more information, see + * [TrueTime and external + * consistency](https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability). * * * SERIALIZABLE = 1; diff --git a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/keys.proto b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/keys.proto index 9eadda470d..bce2a07b02 100644 --- a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/keys.proto +++ b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/keys.proto @@ -152,8 +152,8 @@ message KeySet { // encoded as described [here][google.spanner.v1.TypeCode]. repeated google.protobuf.ListValue keys = 1; - // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about - // key range specifications. + // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more + // information about key range specifications. repeated KeyRange ranges = 2; // For convenience `all` can be set to `true` to indicate that this diff --git a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/mutation.proto b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/mutation.proto index c8af1af8e2..41f032b969 100644 --- a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/mutation.proto +++ b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/mutation.proto @@ -32,13 +32,16 @@ option ruby_package = "Google::Cloud::Spanner::V1"; // applied to a Cloud Spanner database by sending them in a // [Commit][google.spanner.v1.Spanner.Commit] call. message Mutation { - // Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and + // Arguments to [insert][google.spanner.v1.Mutation.insert], + // [update][google.spanner.v1.Mutation.update], + // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and // [replace][google.spanner.v1.Mutation.replace] operations. message Write { // Required. The table whose rows will be written. string table = 1 [(google.api.field_behavior) = REQUIRED]; - // The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written. + // The names of the columns in + // [table][google.spanner.v1.Mutation.Write.table] to be written. // // The list of columns must contain enough columns to allow // Cloud Spanner to derive values for all primary key columns in the @@ -48,11 +51,13 @@ message Mutation { // The values to be written. `values` can contain more than one // list of values. If it does, then multiple rows are written, one // for each entry in `values`. Each list in `values` must have - // exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns] - // above. Sending multiple lists is equivalent to sending multiple - // `Mutation`s, each containing one `values` entry and repeating - // [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are - // encoded as described [here][google.spanner.v1.TypeCode]. + // exactly as many entries as there are entries in + // [columns][google.spanner.v1.Mutation.Write.columns] above. Sending + // multiple lists is equivalent to sending multiple `Mutation`s, each + // containing one `values` entry and repeating + // [table][google.spanner.v1.Mutation.Write.table] and + // [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in + // each list are encoded as described [here][google.spanner.v1.TypeCode]. repeated google.protobuf.ListValue values = 3; } @@ -61,12 +66,12 @@ message Mutation { // Required. The table whose rows will be deleted. string table = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete. The - // primary keys must be specified in the order in which they appear in the - // `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL - // statement used to create the table). - // Delete is idempotent. The transaction will succeed even if some or all - // rows do not exist. + // Required. The primary keys of the rows within + // [table][google.spanner.v1.Mutation.Delete.table] to delete. The primary + // keys must be specified in the order in which they appear in the `PRIMARY + // KEY()` clause of the table's equivalent DDL statement (the DDL statement + // used to create the table). Delete is idempotent. The transaction will + // succeed even if some or all rows do not exist. KeySet key_set = 2 [(google.api.field_behavior) = REQUIRED]; } @@ -80,19 +85,22 @@ message Mutation { // already exist, the transaction fails with error `NOT_FOUND`. Write update = 2; - // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then - // its column values are overwritten with the ones provided. Any - // column values not explicitly written are preserved. + // Like [insert][google.spanner.v1.Mutation.insert], except that if the row + // already exists, then its column values are overwritten with the ones + // provided. Any column values not explicitly written are preserved. // - // When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT - // NULL` columns in the table must be given a value. This holds true - // even when the row already exists and will therefore actually be updated. + // When using + // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as + // when using [insert][google.spanner.v1.Mutation.insert], all `NOT NULL` + // columns in the table must be given a value. This holds true even when the + // row already exists and will therefore actually be updated. Write insert_or_update = 3; - // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is - // deleted, and the column values provided are inserted - // instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not - // explicitly written become `NULL`. + // Like [insert][google.spanner.v1.Mutation.insert], except that if the row + // already exists, it is deleted, and the column values provided are + // inserted instead. Unlike + // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this + // means any values not explicitly written become `NULL`. // // In an interleaved table, if you create the child table with the // `ON DELETE CASCADE` annotation, then replacing a parent row diff --git a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/query_plan.proto b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/query_plan.proto index 104828457c..cc7ff5ab68 100644 --- a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/query_plan.proto +++ b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/query_plan.proto @@ -26,10 +26,11 @@ option java_package = "com.google.spanner.v1"; option php_namespace = "Google\\Cloud\\Spanner\\V1"; option ruby_package = "Google::Cloud::Spanner::V1"; -// Node information for nodes appearing in a [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes]. +// Node information for nodes appearing in a +// [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes]. message PlanNode { - // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between the two different kinds of - // nodes that can appear in a query plan. + // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between + // the two different kinds of nodes that can appear in a query plan. enum Kind { // Not specified. KIND_UNSPECIFIED = 0; @@ -58,14 +59,14 @@ message PlanNode { // with the output variable. string type = 2; - // Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds - // to an output variable of the parent node. The field carries the name of - // the output variable. - // For example, a `TableScan` operator that reads rows from a table will - // have child links to the `SCALAR` nodes representing the output variables - // created for each column that is read by the operator. The corresponding - // `variable` fields will be set to the variable names assigned to the - // columns. + // Only present if the child node is + // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an + // output variable of the parent node. The field carries the name of the + // output variable. For example, a `TableScan` operator that reads rows from + // a table will have child links to the `SCALAR` nodes representing the + // output variables created for each column that is read by the operator. + // The corresponding `variable` fields will be set to the variable names + // assigned to the columns. string variable = 3; } @@ -83,14 +84,15 @@ message PlanNode { map subqueries = 2; } - // The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes]. + // The `PlanNode`'s index in [node + // list][google.spanner.v1.QueryPlan.plan_nodes]. int32 index = 1; // Used to determine the type of node. May be needed for visualizing // different kinds of nodes differently. For example, If the node is a - // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation - // which can be used to directly embed a description of the node in its - // parent. + // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a + // condensed representation which can be used to directly embed a description + // of the node in its parent. Kind kind = 2; // The display name for the node. @@ -99,7 +101,8 @@ message PlanNode { // List of child node `index`es and their relationship to this parent. repeated ChildLink child_links = 4; - // Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes. + // Condensed representation for + // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes. ShortRepresentation short_representation = 5; // Attributes relevant to the node contained in a group of key-value pairs. @@ -122,7 +125,7 @@ message PlanNode { // Contains an ordered list of nodes appearing in the query plan. message QueryPlan { // The nodes in the query plan. Plan nodes are returned in pre-order starting - // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in - // `plan_nodes`. + // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` + // corresponds to its index in `plan_nodes`. repeated PlanNode plan_nodes = 1; } diff --git a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/spanner.proto b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/spanner.proto index c8e2d080fa..e4ce605ec4 100644 --- a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/spanner.proto +++ b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/spanner.proto @@ -66,14 +66,14 @@ service Spanner { // transaction internally, and count toward the one transaction // limit. // - // Active sessions use additional server resources, so it is a good idea to + // Active sessions use additional server resources, so it's a good idea to // delete idle and unneeded sessions. - // Aside from explicit deletes, Cloud Spanner may delete sessions for which no + // Aside from explicit deletes, Cloud Spanner can delete sessions when no // operations are sent for more than an hour. If a session is deleted, // requests to it return `NOT_FOUND`. // // Idle sessions can be kept alive by sending a trivial SQL query - // periodically, e.g., `"SELECT 1"`. + // periodically, for example, `"SELECT 1"`. rpc CreateSession(CreateSessionRequest) returns (Session) { option (google.api.http) = { post: "/v1/{database=projects/*/instances/*/databases/*}/sessions" @@ -95,7 +95,7 @@ service Spanner { option (google.api.method_signature) = "database,session_count"; } - // Gets a session. Returns `NOT_FOUND` if the session does not exist. + // Gets a session. Returns `NOT_FOUND` if the session doesn't exist. // This is mainly useful for determining whether a session is still // alive. rpc GetSession(GetSessionRequest) returns (Session) { @@ -113,9 +113,9 @@ service Spanner { option (google.api.method_signature) = "database"; } - // Ends a session, releasing server resources associated with it. This will - // asynchronously trigger cancellation of any operations that are running with - // this session. + // Ends a session, releasing server resources associated with it. This + // asynchronously triggers the cancellation of any operations that are running + // with this session. rpc DeleteSession(DeleteSessionRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=projects/*/instances/*/databases/*/sessions/*}" @@ -124,7 +124,7 @@ service Spanner { } // 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; + // method can't be used to return a result set larger than 10 MiB; // if the query yields more data than that, the query fails with // a `FAILED_PRECONDITION` error. // @@ -136,6 +136,9 @@ service Spanner { // Larger result sets can be fetched in streaming fashion by calling // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] // instead. + // + // The query string can be SQL or [Graph Query Language + // (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). rpc ExecuteSql(ExecuteSqlRequest) returns (ResultSet) { option (google.api.http) = { post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql" @@ -148,6 +151,9 @@ service Spanner { // [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. + // + // The query string can be SQL or [Graph Query Language + // (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). rpc ExecuteStreamingSql(ExecuteSqlRequest) returns (stream PartialResultSet) { option (google.api.http) = { post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql" @@ -177,7 +183,7 @@ service Spanner { // 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 + // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. This method can't be // used to return a result set larger than 10 MiB; if the read matches more // data than that, the read fails with a `FAILED_PRECONDITION` // error. @@ -227,8 +233,8 @@ service Spanner { // `Commit` might return an `ABORTED` error. This can occur at any time; // commonly, the cause is conflicts with concurrent // 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. + // reasons. If `Commit` returns `ABORTED`, the caller should retry + // the transaction from the beginning, reusing 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. @@ -245,14 +251,14 @@ service Spanner { "session,single_use_transaction,mutations"; } - // Rolls back a transaction, releasing any locks it holds. It is a good + // Rolls back a transaction, releasing any locks it holds. It's 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 ultimately // decides not to commit. // // `Rollback` returns `OK` if it successfully aborts the transaction, the - // transaction was already aborted, or the transaction is not + // transaction was already aborted, or the transaction isn't // found. `Rollback` never returns `ABORTED`. rpc Rollback(RollbackRequest) returns (google.protobuf.Empty) { option (google.api.http) = { @@ -263,16 +269,16 @@ service Spanner { } // 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 + // operation in parallel. Each of the returned partition tokens can be used // by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to - // specify a subset of the query result to read. The same session and - // read-only transaction must be used by the PartitionQueryRequest used to - // create the partition tokens and the ExecuteSqlRequests that use the + // specify a subset of the query result to read. The same session and + // read-only transaction must be used by the `PartitionQueryRequest` used to + // create the partition tokens and the `ExecuteSqlRequests` that use the // partition tokens. // // Partition tokens become invalid when the session used to create them // 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 + // old. When any of these happen, it isn't possible to resume the query, and // the whole operation must be restarted from the beginning. rpc PartitionQuery(PartitionQueryRequest) returns (PartitionResponse) { option (google.api.http) = { @@ -282,18 +288,18 @@ service Spanner { } // 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 + // 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 result to read. The same session and read-only - // transaction must be used by the PartitionReadRequest used to create the - // partition tokens and the ReadRequests that use the partition tokens. There - // are no ordering guarantees on rows returned among the returned partition - // tokens, or even within each individual StreamingRead call issued with a - // partition_token. + // subset of the read result to read. The same session and read-only + // transaction must be used by the `PartitionReadRequest` used to create the + // partition tokens and the `ReadRequests` that use the partition tokens. + // There are no ordering guarantees on rows returned among the returned + // partition tokens, or even within each individual `StreamingRead` call + // issued with a `partition_token`. // // Partition tokens become invalid when the session used to create them // 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 + // old. When any of these happen, it isn't possible to resume the read, and // the whole operation must be restarted from the beginning. rpc PartitionRead(PartitionReadRequest) returns (PartitionResponse) { option (google.api.http) = { @@ -306,15 +312,15 @@ service Spanner { // transactions. All mutations in a group are committed atomically. However, // mutations across groups can be committed non-atomically in an unspecified // order and thus, they must be independent of each other. Partial failure is - // possible, i.e., some groups may have been committed successfully, while - // some may have failed. The results of individual batches are streamed into - // the response as the batches are applied. + // possible, that is, some groups might have been committed successfully, + // while some might have failed. The results of individual batches are + // streamed into the response as the batches are applied. // - // BatchWrite requests are not replay protected, meaning that each mutation - // group may be applied more than once. Replays of non-idempotent mutations - // may have undesirable effects. For example, replays of an insert mutation - // may produce an already exists error or if you use generated or commit - // timestamp-based keys, it may result in additional rows being added to the + // `BatchWrite` requests are not replay protected, meaning that each mutation + // group can be applied more than once. Replays of non-idempotent mutations + // can have undesirable effects. For example, replays of an insert mutation + // can produce an already exists error or if you use generated or commit + // timestamp-based keys, it can result in additional rows being added to the // mutation's table. We recommend structuring your mutation groups to be // idempotent to avoid this issue. rpc BatchWrite(BatchWriteRequest) returns (stream BatchWriteResponse) { @@ -351,13 +357,13 @@ message BatchCreateSessionsRequest { } ]; - // Parameters to be applied to each created session. + // Parameters to apply to each created session. Session session_template = 2; // 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 // [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count] // as necessary). int32 session_count = 3 [(google.api.field_behavior) = REQUIRED]; @@ -375,6 +381,8 @@ message Session { option (google.api.resource) = { type: "spanner.googleapis.com/Session" pattern: "projects/{project}/instances/{instance}/databases/{database}/sessions/{session}" + plural: "sessions" + singular: "session" }; // Output only. The name of the session. This is always system-assigned. @@ -395,7 +403,7 @@ message Session { google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // 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. google.protobuf.Timestamp approximate_last_use_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; @@ -403,13 +411,14 @@ message Session { // The database role which created this session. string creator_role = 5; - // 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 - // [CreateSession][google.spanner.v1.Spanner.CreateSession] but not via - // [BatchCreateSessions][google.spanner.v1.Spanner.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 + // [`sessions.create`][google.spanner.v1.Spanner.CreateSession] to create + // multiplexed sessions. Don't use + // [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions] to + // create a multiplexed session. You can't delete or list multiplexed + // sessions. bool multiplexed = 6 [(google.api.field_behavior) = OPTIONAL]; } @@ -477,22 +486,22 @@ message DeleteSessionRequest { // Common request options for various APIs. message RequestOptions { - // The relative priority for requests. Note that priority is not applicable + // The relative priority for requests. Note that priority isn't applicable // for [BeginTransaction][google.spanner.v1.Spanner.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. enum Priority { // `PRIORITY_UNSPECIFIED` is equivalent to `PRIORITY_HIGH`. PRIORITY_UNSPECIFIED = 0; @@ -512,35 +521,35 @@ message RequestOptions { // 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. string request_tag = 2; // 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. string transaction_tag = 3; } -// 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. message DirectedReadOptions { // The directed read replica selector. // Callers must provide one or more of the following fields for replica @@ -553,12 +562,12 @@ message DirectedReadOptions { // 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. message ReplicaSelection { // Indicates the type of replica. @@ -573,22 +582,22 @@ message DirectedReadOptions { READ_ONLY = 2; } - // The location or region of the serving requests, e.g. "us-east1". + // The location or region of the serving requests, for example, "us-east1". string location = 1; // The type of replica. Type type = 2; } - // 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. message IncludeReplicas { // The directed read replica selector. repeated ReplicaSelection replica_selections = 1; - // 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`. bool auto_failover_disabled = 2; } @@ -599,18 +608,18 @@ message DirectedReadOptions { repeated ReplicaSelection replica_selections = 1; } - // Required. At most one of either include_replicas or exclude_replicas + // Required. At most one of either `include_replicas` or `exclude_replicas` // should be present in the message. oneof replicas { - // 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. IncludeReplicas include_replicas = 1; - // 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. ExcludeReplicas exclude_replicas = 2; } @@ -630,7 +639,7 @@ message ExecuteSqlRequest { // 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; @@ -657,7 +666,7 @@ message ExecuteSqlRequest { // 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. @@ -677,13 +686,13 @@ message ExecuteSqlRequest { // 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 SET OPTIONS (allow_gc=false) // ``` // @@ -708,7 +717,7 @@ message ExecuteSqlRequest { // 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. @@ -724,20 +733,20 @@ message ExecuteSqlRequest { // 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. google.protobuf.Struct params = 4; - // 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 // [params][google.spanner.v1.ExecuteSqlRequest.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 [Type][google.spanner.v1.Type] for more information // about SQL types. @@ -759,20 +768,20 @@ message ExecuteSqlRequest { // [QueryMode.NORMAL][google.spanner.v1.ExecuteSqlRequest.QueryMode.NORMAL]. QueryMode query_mode = 7; - // 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`. bytes partition_token = 8; // 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. int64 seqno = 9; @@ -789,19 +798,19 @@ message ExecuteSqlRequest { // 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. bool data_boost_enabled = 16; - // 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. bool last_statement = 17 [(google.api.field_behavior) = OPTIONAL]; } @@ -818,16 +827,16 @@ message ExecuteBatchDmlRequest { // 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. google.protobuf.Struct params = 2; - // 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 // [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as // JSON strings. @@ -862,26 +871,26 @@ message ExecuteBatchDmlRequest { // 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. int64 seqno = 4 [(google.api.field_behavior) = REQUIRED]; // Common options for this request. RequestOptions request_options = 5; - // 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. bool last_statements = 6 [(google.api.field_behavior) = OPTIONAL]; } @@ -932,36 +941,32 @@ message ExecuteBatchDmlResponse { // Otherwise, the error status of the first failed statement. google.rpc.Status status = 2; - // 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 // [Commit][google.spanner.v1.Spanner.Commit] request for this transaction. - // This feature is not yet supported and will result in an UNIMPLEMENTED - // error. MultiplexedSessionPrecommitToken precommit_token = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Options for a PartitionQueryRequest and -// PartitionReadRequest. +// Options for a `PartitionQueryRequest` and `PartitionReadRequest`. message PartitionOptions { - // **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. int64 partition_size_bytes = 1; - // **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. int64 max_partitions = 2; } @@ -973,22 +978,23 @@ message PartitionQueryRequest { (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" } ]; - // 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. TransactionSelector transaction = 2; - // 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 - // [ExecuteStreamingSql][google.spanner.v1.Spanner.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 + // [`ExecuteStreamingSql`][google.spanner.v1.Spanner.ExecuteStreamingSql] with + // a `PartitionedDml` transaction for large, partition-friendly DML + // operations. string sql = 3 [(google.api.field_behavior) = REQUIRED]; // Parameter names and values that bind to placeholders in the SQL string. @@ -997,16 +1003,16 @@ message PartitionQueryRequest { // 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. google.protobuf.Struct params = 4; - // 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 // [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings. // @@ -1055,7 +1061,7 @@ message PartitionReadRequest { // [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names // index keys in [index][google.spanner.v1.PartitionReadRequest.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. KeySet key_set = 6 [(google.api.field_behavior) = REQUIRED]; @@ -1066,9 +1072,9 @@ message PartitionReadRequest { // Information returned for each partition returned in a // PartitionResponse. message Partition { - // 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. bytes partition_token = 1; } @@ -1089,13 +1095,13 @@ message ReadRequest { enum 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. @@ -1106,7 +1112,7 @@ message ReadRequest { enum 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. @@ -1137,8 +1143,8 @@ message ReadRequest { // 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. // @@ -1185,16 +1191,16 @@ message ReadRequest { // If the [partition_token][google.spanner.v1.ReadRequest.partition_token] // field is empty, rows are yielded in table primary key order (if // [index][google.spanner.v1.ReadRequest.index] is empty) or index key order - // (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the - // [partition_token][google.spanner.v1.ReadRequest.partition_token] field is - // not empty, rows will be yielded in an unspecified order. + // (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the + // [partition_token][google.spanner.v1.ReadRequest.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. KeySet key_set = 6 [(google.api.field_behavior) = REQUIRED]; // 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. int64 limit = 8; @@ -1206,8 +1212,8 @@ message ReadRequest { // that yielded this token. bytes resume_token = 9; - // 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. bytes partition_token = 10; @@ -1221,17 +1227,18 @@ message ReadRequest { // 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. bool data_boost_enabled = 15; // 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). OrderBy order_by = 16 [(google.api.field_behavior) = OPTIONAL]; // Optional. Lock Hint for the request, it can only be used with read-write @@ -1253,17 +1260,15 @@ message BeginTransactionRequest { // 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. RequestOptions request_options = 3; // 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. Mutation mutation_key = 4 [(google.api.field_behavior) = OPTIONAL]; } @@ -1285,7 +1290,7 @@ message CommitRequest { // 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 // [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and // [Commit][google.spanner.v1.Spanner.Commit] instead. @@ -1297,16 +1302,16 @@ message CommitRequest { // this list. repeated Mutation mutations = 4; - // If `true`, then statistics related to the transaction will be included in + // If `true`, then statistics related to the transaction is included in // the [CommitResponse][google.spanner.v1.CommitResponse.commit_stats]. // Default value is `false`. bool return_commit_stats = 5; - // 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. google.protobuf.Duration max_commit_delay = 8 [(google.api.field_behavior) = OPTIONAL]; @@ -1314,11 +1319,9 @@ message CommitRequest { RequestOptions request_options = 6; // 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. MultiplexedSessionPrecommitToken precommit_token = 9 [(google.api.field_behavior) = OPTIONAL]; } @@ -1358,18 +1361,9 @@ message BatchWriteRequest { repeated MutationGroup mutation_groups = 4 [(google.api.field_behavior) = REQUIRED]; - // 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. bool exclude_txn_from_change_streams = 5 [(google.api.field_behavior) = OPTIONAL]; } diff --git a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/transaction.proto b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/transaction.proto index 81e7649f46..d3ad6e8690 100644 --- a/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/transaction.proto +++ b/proto-google-cloud-spanner-v1/src/main/proto/google/spanner/v1/transaction.proto @@ -166,8 +166,9 @@ message TransactionOptions { // actually occurred in parallel. Spanner assigns commit timestamps that // reflect the order of committed transactions to implement this property. // Spanner offers a stronger guarantee than serializability called external - // consistency. For further details, please refer to - // https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability. + // consistency. For more information, see + // [TrueTime and external + // consistency](https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability). SERIALIZABLE = 1; // All reads performed during the transaction observe a consistent snapshot From 0ef017ff56b19b75faa35b0514b1034e6d17a997 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Wed, 3 Sep 2025 02:26:26 +0000 Subject: [PATCH 07/12] chore: Update generation configuration at Wed Sep 3 02:26:18 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 712ebc365f..877bd58993 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: 376467058c288ad34dd7aafa892a95883e4acd0c +googleapis_commitish: 65afc22de9b311ccdc38e737cc2e3739608706dd libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner From dd40df8bfe417856c6b3ac62c32b046b18d701dd Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Thu, 4 Sep 2025 02:27:22 +0000 Subject: [PATCH 08/12] chore: Update generation configuration at Thu Sep 4 02:27:15 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 877bd58993..7d4b487c84 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: 65afc22de9b311ccdc38e737cc2e3739608706dd +googleapis_commitish: c249577397a9ae79e07db34925efd0984c2ef26a libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner From d5b94d738deea3a24552b12330ca6555c3620d6d Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Fri, 5 Sep 2025 02:29:09 +0000 Subject: [PATCH 09/12] chore: Update generation configuration at Fri Sep 5 02:29:03 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 7d4b487c84..0c55c5f3b2 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.0 -googleapis_commitish: c249577397a9ae79e07db34925efd0984c2ef26a +googleapis_commitish: a6fb279349101a2e53aaad4c9f02c57871812153 libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner From 0b33fd86ed39e3ba1820a3c2ece3df9a5f80b28e Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Sat, 6 Sep 2025 02:25:30 +0000 Subject: [PATCH 10/12] chore: Update generation configuration at Sat Sep 6 02:25:24 UTC 2025 --- .github/workflows/hermetic_library_generation.yaml | 2 +- generation_config.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/hermetic_library_generation.yaml b/.github/workflows/hermetic_library_generation.yaml index 02d55be1f0..04e4063f52 100644 --- a/.github/workflows/hermetic_library_generation.yaml +++ b/.github/workflows/hermetic_library_generation.yaml @@ -37,7 +37,7 @@ jobs: with: fetch-depth: 0 token: ${{ secrets.CLOUD_JAVA_BOT_TOKEN }} - - uses: googleapis/sdk-platform-java/.github/scripts@v2.62.0 + - uses: googleapis/sdk-platform-java/.github/scripts@v2.62.1 if: env.SHOULD_RUN == 'true' with: base_ref: ${{ github.base_ref }} diff --git a/generation_config.yaml b/generation_config.yaml index 0c55c5f3b2..e50efaba97 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ -gapic_generator_version: 2.62.0 -googleapis_commitish: a6fb279349101a2e53aaad4c9f02c57871812153 +gapic_generator_version: 2.62.1 +googleapis_commitish: 46403a9acec0719c130b33eb38b2ee62a45f9f6c libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner From 93a6e21e70f7beb8c69aa76069818abe580032c5 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Sat, 6 Sep 2025 02:28:36 +0000 Subject: [PATCH 11/12] chore: generate libraries at Sat Sep 6 02:25:53 UTC 2025 --- .kokoro/presubmit/graalvm-native-a.cfg | 2 +- .kokoro/presubmit/graalvm-native-b.cfg | 2 +- .kokoro/presubmit/graalvm-native-c.cfg | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.kokoro/presubmit/graalvm-native-a.cfg b/.kokoro/presubmit/graalvm-native-a.cfg index 5816d61073..a562a6398b 100644 --- a/.kokoro/presubmit/graalvm-native-a.cfg +++ b/.kokoro/presubmit/graalvm-native-a.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_a:3.52.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_a:3.52.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { diff --git a/.kokoro/presubmit/graalvm-native-b.cfg b/.kokoro/presubmit/graalvm-native-b.cfg index 7986fd6731..2257ccce67 100644 --- a/.kokoro/presubmit/graalvm-native-b.cfg +++ b/.kokoro/presubmit/graalvm-native-b.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_b:3.52.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_b:3.52.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { diff --git a/.kokoro/presubmit/graalvm-native-c.cfg b/.kokoro/presubmit/graalvm-native-c.cfg index acecfce1bf..a9294de35a 100644 --- a/.kokoro/presubmit/graalvm-native-c.cfg +++ b/.kokoro/presubmit/graalvm-native-c.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_c:3.52.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_c:3.52.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { From 8471747461072afbecf9bc959b19e9f621b0e508 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Tue, 9 Sep 2025 02:29:06 +0000 Subject: [PATCH 12/12] chore: Update generation configuration at Tue Sep 9 02:28:58 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index e50efaba97..88d36608f5 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.62.1 -googleapis_commitish: 46403a9acec0719c130b33eb38b2ee62a45f9f6c +googleapis_commitish: 2585041b27d424ed4496d163671a95a7e1af4c31 libraries_bom_version: 26.67.0 libraries: - api_shortname: spanner