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.
*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.
*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.
*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.
*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.
*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.
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.
*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.
*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.
*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.
*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 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 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 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:
*
* 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:
*
* The query string can be SQL or [Graph Query Language
+ * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
+ *
* Sample code:
*
* 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 `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 `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 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 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 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 6f8f8fc5421..8eb67081efe 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"`.
* {@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) {
*
*/
public void createSession(
@@ -1184,7 +1188,7 @@ public void batchCreateSessions(
*
*
* {@code
@@ -1279,6 +1287,9 @@ public final UnaryCallable
*/
default void executeStreamingSql(
@@ -919,7 +923,7 @@ default void executeBatchDml(
* {@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.
*
*
*/
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).
*
* 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(
*
*
*
@@ -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"`.
*
- * 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.
*
- * 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(
*
*
*
@@ -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(
*
*
*
- * 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.
*
- * 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(
*
*
*
@@ -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(
*
*
*
- * 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.
*
- * 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
* 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(
*
*
*
@@ -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
- * 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.
*
- * 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
* 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
* 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
*/
@@ -2427,15 +2445,15 @@ public com.google.common.util.concurrent.ListenableFuture
- * 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 1b0588c32e2..698601c466c 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 82af100d346..8a90552039e 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 2da32834318..6737e384e65 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 7fa457c8552..00e79021029 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 c339d7cc25a..3290558bc05 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 53b0dc73282..297c7a8e283 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
- * 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 a59ee4466b3..bde61cc6bc6 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 f2802f745be..130f6e7c650 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 25405eec0e1..0749a26f8d5 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 660f2552af8..ce7b064cf05 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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 f248d5b2d0d..98d86cc96c0 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 331200367fb..2da5aef4e1a 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 476b32ea983..bde57013ec0 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 5c08a58d0a0..8fd531908a0 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
*
*
- * 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
*
*
- * 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
*
*
- * 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() {
*
*
*
*
@@ -2295,15 +2295,15 @@ public boolean getDataBoostEnabled() {
*
*
*
- * 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.
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
*
*
*
@@ -5168,15 +5168,15 @@ public Builder clearDataBoostEnabled() {
*
*
*
- * 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(
*
*
*
*
@@ -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.
*
- * 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() {
*
*
*
*
@@ -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.
*
- * 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.
*
- * 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 3ccde99ff82..c3f479e50fe 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(
*
*
*
*
@@ -544,15 +544,15 @@ 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.
*
- * 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 74891a28554..c40e2bbbe87 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
- * 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
- * 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
- * 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 e2e423c325e..7e0eb34bc73 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 f3a0f904e71..47adefcfa87 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.Listrepeated .google.protobuf.ListValue values = 3;
@@ -495,11 +519,13 @@ public java.util.Listrepeated .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
*
*
- * 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.Listrepeated .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() {
*
*
*
*
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 be91dfdf577..03dd67830dd 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 @@
*
*
*
- * 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() {
*
*
*
*
@@ -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.
*
- * 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() {
*
*
*
*
@@ -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.
*
- * 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) {
*
*
*
*
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 446b9078180..8f193aba282 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.
*
- * 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
*
*
*
*
@@ -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.
*
- * 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 c50dcd8b558..4b4d088fe26 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 26260a40cae..eb79b78c800 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 fe64beb1d6f..749047b87a8 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 28befed7ab7..2d4eafb5c5a 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 9a495275406..118685bdf25 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 3180c9b48ec..8fa4b7af4e2 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
*
*
- * 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
*
*
- * 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
*
*
- * 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
*
@@ -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.
*
- * 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
*
@@ -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.
*
- * 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
*
@@ -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.
*
- * 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() {
*
*
*
*
@@ -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.
*
- * 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
*
@@ -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.
*
- * 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 db5570df53e..e637e57eb3f 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
*
*
*
*
@@ -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.
*
- * 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
*
*
*
*
@@ -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.
*
- * 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
*
*
*
*
@@ -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.
*
- * 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(
*
*
*
*
@@ -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.
*
- * 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 c82d29e239f..977ac885ea3 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.
*
- * 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 dea5935593c..8fa6e99b648 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 394641a2ae0..30f4a95bf4e 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
* 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
* 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
* 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 219ed420801..7b09d935bbb 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 bd3294af900..2ae6e5b964a 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 09909ff935b..3cf4fa6a43a 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 a918e14e308..aa0e8411d34 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 7fb354d75ec..49e2d07348c 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 6ca8532d86c..c4c2be7437a 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 4ad812a2cad..127dea4f253 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 cc3a13e16a5..2774c37b023 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\022SERIALIZABLE = 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 9eadda470d8..bce2a07b02f 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 c8af1af8e23..41f032b9695 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 104828457cf..cc7ff5ab684 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