Skip to content

Commit 1c04557

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
docs: [Spanner] A comment for field ranges in message .google.spanner.v1.KeySet is changed (#8548)
* docs: A comment for field `ranges` in message `.google.spanner.v1.KeySet` is changed docs: A comment for message `Mutation` is changed docs: A comment for field `columns` in message `.google.spanner.v1.Mutation` is changed docs: A comment for field `values` in message `.google.spanner.v1.Mutation` is changed docs: A comment for field `key_set` in message `.google.spanner.v1.Mutation` is changed docs: A comment for field `insert_or_update` in message `.google.spanner.v1.Mutation` is changed docs: A comment for field `replace` in message `.google.spanner.v1.Mutation` is changed docs: A comment for message `PlanNode` is changed docs: A comment for enum `Kind` is changed docs: A comment for field `variable` in message `.google.spanner.v1.PlanNode` is changed docs: A comment for field `index` in message `.google.spanner.v1.PlanNode` is changed docs: A comment for field `kind` in message `.google.spanner.v1.PlanNode` is changed docs: A comment for field `short_representation` in message `.google.spanner.v1.PlanNode` is changed docs: A comment for field `plan_nodes` in message `.google.spanner.v1.QueryPlan` is changed docs: A comment for method `CreateSession` in service `Spanner` is changed docs: A comment for method `GetSession` in service `Spanner` is changed docs: A comment for method `DeleteSession` in service `Spanner` is changed docs: A comment for method `ExecuteSql` in service `Spanner` is changed docs: A comment for method `ExecuteStreamingSql` in service `Spanner` is changed docs: A comment for method `Read` in service `Spanner` is changed docs: A comment for method `Commit` in service `Spanner` is changed docs: A comment for method `Rollback` in service `Spanner` is changed docs: A comment for method `PartitionQuery` in service `Spanner` is changed docs: A comment for method `PartitionRead` in service `Spanner` is changed docs: A comment for method `BatchWrite` in service `Spanner` is changed docs: A comment for field `session_template` in message `.google.spanner.v1.BatchCreateSessionsRequest` is changed docs: A comment for field `session_count` in message `.google.spanner.v1.BatchCreateSessionsRequest` is changed docs: A comment for field `approximate_last_use_time` in message `.google.spanner.v1.Session` is changed docs: A comment for field `multiplexed` in message `.google.spanner.v1.Session` is changed docs: A comment for enum `Priority` is changed docs: A comment for field `request_tag` in message `.google.spanner.v1.RequestOptions` is changed docs: A comment for field `transaction_tag` in message `.google.spanner.v1.RequestOptions` is changed docs: A comment for message `DirectedReadOptions` is changed docs: A comment for message `DirectedReadOptions` is changed docs: A comment for message `DirectedReadOptions` is changed docs: A comment for field `location` in message `.google.spanner.v1.DirectedReadOptions` is changed docs: A comment for field `auto_failover_disabled` in message `.google.spanner.v1.DirectedReadOptions` is changed docs: A comment for field `include_replicas` in message `.google.spanner.v1.DirectedReadOptions` is changed docs: A comment for field `exclude_replicas` in message `.google.spanner.v1.DirectedReadOptions` is changed docs: A comment for enum value `PROFILE` in enum `QueryMode` is changed docs: A comment for field `optimizer_version` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `optimizer_statistics_package` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `transaction` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `params` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `param_types` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `partition_token` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `seqno` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `data_boost_enabled` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `last_statement` in message `.google.spanner.v1.ExecuteSqlRequest` is changed docs: A comment for field `params` in message `.google.spanner.v1.ExecuteBatchDmlRequest` is changed docs: A comment for field `param_types` in message `.google.spanner.v1.ExecuteBatchDmlRequest` is changed docs: A comment for field `seqno` in message `.google.spanner.v1.ExecuteBatchDmlRequest` is changed docs: A comment for field `last_statements` in message `.google.spanner.v1.ExecuteBatchDmlRequest` is changed docs: A comment for field `precommit_token` in message `.google.spanner.v1.ExecuteBatchDmlResponse` is changed docs: A comment for message `PartitionOptions` is changed docs: A comment for field `partition_size_bytes` in message `.google.spanner.v1.PartitionOptions` is changed docs: A comment for field `max_partitions` in message `.google.spanner.v1.PartitionOptions` is changed docs: A comment for field `transaction` in message `.google.spanner.v1.PartitionQueryRequest` is changed docs: A comment for field `sql` in message `.google.spanner.v1.PartitionQueryRequest` is changed docs: A comment for field `params` in message `.google.spanner.v1.PartitionQueryRequest` is changed docs: A comment for field `param_types` in message `.google.spanner.v1.PartitionQueryRequest` is changed docs: A comment for field `key_set` in message `.google.spanner.v1.PartitionReadRequest` is changed docs: A comment for field `partition_token` in message `.google.spanner.v1.Partition` is changed docs: A comment for enum value `ORDER_BY_UNSPECIFIED` in enum `OrderBy` is changed docs: A comment for enum value `ORDER_BY_PRIMARY_KEY` in enum `OrderBy` is changed docs: A comment for enum value `LOCK_HINT_UNSPECIFIED` in enum `LockHint` is changed docs: A comment for enum value `LOCK_HINT_EXCLUSIVE` in enum `LockHint` is changed docs: A comment for field `key_set` in message `.google.spanner.v1.ReadRequest` is changed docs: A comment for field `limit` in message `.google.spanner.v1.ReadRequest` is changed docs: A comment for field `partition_token` in message `.google.spanner.v1.ReadRequest` is changed docs: A comment for field `data_boost_enabled` in message `.google.spanner.v1.ReadRequest` is changed docs: A comment for field `order_by` in message `.google.spanner.v1.ReadRequest` is changed docs: A comment for field `request_options` in message `.google.spanner.v1.BeginTransactionRequest` is changed docs: A comment for field `mutation_key` in message `.google.spanner.v1.BeginTransactionRequest` is changed docs: A comment for field `single_use_transaction` in message `.google.spanner.v1.CommitRequest` is changed docs: A comment for field `return_commit_stats` in message `.google.spanner.v1.CommitRequest` is changed docs: A comment for field `max_commit_delay` in message `.google.spanner.v1.CommitRequest` is changed docs: A comment for field `precommit_token` in message `.google.spanner.v1.CommitRequest` is changed docs: A comment for field `exclude_txn_from_change_streams` in message `.google.spanner.v1.BatchWriteRequest` is changed docs: A comment for enum value `SERIALIZABLE` in enum `IsolationLevel` is changed PiperOrigin-RevId: 800749899 Source-Link: googleapis/googleapis@39c8072 Source-Link: googleapis/googleapis-gen@42cfcdb Copy-Tag: eyJwIjoiU3Bhbm5lci8uT3dsQm90LnlhbWwiLCJoIjoiNDJjZmNkYmJhYjFjYmUxMmY0ZTA5Njg5NTkxZjlkZmYwNjlmMDg3ZSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent a768f72 commit 1c04557

48 files changed

Lines changed: 982 additions & 989 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎Spanner/metadata/V1/Spanner.php‎

21 Bytes
Binary file not shown.

‎Spanner/samples/V1/SpannerClient/batch_create_sessions.php‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@
3737
* @param string $formattedDatabase The database in which the new sessions are created. Please see
3838
* {@see SpannerClient::databaseName()} for help formatting this field.
3939
* @param int $sessionCount The number of sessions to be created in this batch call.
40-
* The API may return fewer than the requested number of sessions. If a
40+
* The API can return fewer than the requested number of sessions. If a
4141
* specific number of sessions are desired, the client can make additional
42-
* calls to BatchCreateSessions (adjusting
42+
* calls to `BatchCreateSessions` (adjusting
4343
* [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
4444
* as necessary).
4545
*/

‎Spanner/samples/V1/SpannerClient/batch_write.php‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -36,15 +36,15 @@
3636
* transactions. All mutations in a group are committed atomically. However,
3737
* mutations across groups can be committed non-atomically in an unspecified
3838
* order and thus, they must be independent of each other. Partial failure is
39-
* possible, i.e., some groups may have been committed successfully, while
40-
* some may have failed. The results of individual batches are streamed into
41-
* the response as the batches are applied.
39+
* possible, that is, some groups might have been committed successfully,
40+
* while some might have failed. The results of individual batches are
41+
* streamed into the response as the batches are applied.
4242
*
43-
* BatchWrite requests are not replay protected, meaning that each mutation
44-
* group may be applied more than once. Replays of non-idempotent mutations
45-
* may have undesirable effects. For example, replays of an insert mutation
46-
* may produce an already exists error or if you use generated or commit
47-
* timestamp-based keys, it may result in additional rows being added to the
43+
* `BatchWrite` requests are not replay protected, meaning that each mutation
44+
* group can be applied more than once. Replays of non-idempotent mutations
45+
* can have undesirable effects. For example, replays of an insert mutation
46+
* can produce an already exists error or if you use generated or commit
47+
* timestamp-based keys, it can result in additional rows being added to the
4848
* mutation's table. We recommend structuring your mutation groups to be
4949
* idempotent to avoid this issue.
5050
*

‎Spanner/samples/V1/SpannerClient/commit.php‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@
3636
* `Commit` might return an `ABORTED` error. This can occur at any time;
3737
* commonly, the cause is conflicts with concurrent
3838
* transactions. However, it can also happen for a variety of other
39-
* reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
40-
* the transaction from the beginning, re-using the same session.
39+
* reasons. If `Commit` returns `ABORTED`, the caller should retry
40+
* the transaction from the beginning, reusing the same session.
4141
*
4242
* On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
4343
* for example, if the client job experiences a 1+ hour networking failure.

‎Spanner/samples/V1/SpannerClient/create_session.php‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,14 +40,14 @@
4040
* transaction internally, and count toward the one transaction
4141
* limit.
4242
*
43-
* Active sessions use additional server resources, so it is a good idea to
43+
* Active sessions use additional server resources, so it's a good idea to
4444
* delete idle and unneeded sessions.
45-
* Aside from explicit deletes, Cloud Spanner may delete sessions for which no
45+
* Aside from explicit deletes, Cloud Spanner can delete sessions when no
4646
* operations are sent for more than an hour. If a session is deleted,
4747
* requests to it return `NOT_FOUND`.
4848
*
4949
* Idle sessions can be kept alive by sending a trivial SQL query
50-
* periodically, e.g., `"SELECT 1"`.
50+
* periodically, for example, `"SELECT 1"`.
5151
*
5252
* @param string $formattedDatabase The database in which the new session is created. Please see
5353
* {@see SpannerClient::databaseName()} for help formatting this field.

‎Spanner/samples/V1/SpannerClient/delete_session.php‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@
2828
use Google\Cloud\Spanner\V1\DeleteSessionRequest;
2929

3030
/**
31-
* Ends a session, releasing server resources associated with it. This will
32-
* asynchronously trigger cancellation of any operations that are running with
33-
* this session.
31+
* Ends a session, releasing server resources associated with it. This
32+
* asynchronously triggers the cancellation of any operations that are running
33+
* with this session.
3434
*
3535
* @param string $formattedName The name of the session to delete. Please see
3636
* {@see SpannerClient::sessionName()} for help formatting this field.

‎Spanner/samples/V1/SpannerClient/execute_batch_dml.php‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,12 +49,12 @@
4949
* @param string $statementsSql The DML string.
5050
* @param int $seqno A per-transaction sequence number used to identify this request.
5151
* This field makes each request idempotent such that if the request is
52-
* received multiple times, at most one will succeed.
52+
* received multiple times, at most one succeeds.
5353
*
5454
* The sequence number must be monotonically increasing within the
5555
* transaction. If a request arrives for the first time with an out-of-order
56-
* sequence number, the transaction may be aborted. Replays of previously
57-
* handled requests will yield the same response as the first execution.
56+
* sequence number, the transaction might be aborted. Replays of previously
57+
* handled requests yield the same response as the first execution.
5858
*/
5959
function execute_batch_dml_sample(
6060
string $formattedSession,

‎Spanner/samples/V1/SpannerClient/execute_sql.php‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030

3131
/**
3232
* Executes an SQL statement, returning all results in a single reply. This
33-
* method cannot be used to return a result set larger than 10 MiB;
33+
* method can't be used to return a result set larger than 10 MiB;
3434
* if the query yields more data than that, the query fails with
3535
* a `FAILED_PRECONDITION` error.
3636
*
@@ -43,6 +43,9 @@
4343
* [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
4444
* instead.
4545
*
46+
* The query string can be SQL or [Graph Query Language
47+
* (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
48+
*
4649
* @param string $formattedSession The session in which the SQL query should be performed. Please see
4750
* {@see SpannerClient::sessionName()} for help formatting this field.
4851
* @param string $sql The SQL string.

‎Spanner/samples/V1/SpannerClient/execute_streaming_sql.php‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,9 @@
3636
* the size of the returned result set. However, no individual row in the
3737
* result set can exceed 100 MiB, and no column value can exceed 10 MiB.
3838
*
39+
* The query string can be SQL or [Graph Query Language
40+
* (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
41+
*
3942
* @param string $formattedSession The session in which the SQL query should be performed. Please see
4043
* {@see SpannerClient::sessionName()} for help formatting this field.
4144
* @param string $sql The SQL string.

‎Spanner/samples/V1/SpannerClient/get_session.php‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
use Google\Cloud\Spanner\V1\Session;
3030

3131
/**
32-
* Gets a session. Returns `NOT_FOUND` if the session does not exist.
32+
* Gets a session. Returns `NOT_FOUND` if the session doesn't exist.
3333
* This is mainly useful for determining whether a session is still
3434
* alive.
3535
*

0 commit comments

Comments
 (0)