feat: add ResourceExhausted to retryable error for Write API unary ca…

…lls (#6422) docs: add multiplexing documentation PiperOrigin-RevId: 545839491 Source-Link: googleapis/googleapis@2b006af Source-Link: googleapis/googleapis-gen@0d52d38 Copy-Tag: eyJwIjoiQmlnUXVlcnlTdG9yYWdlLy5Pd2xCb3QueWFtbCIsImgiOiIwZDUyZDM4NWJkNGU3OGM3YjJjODM3NTUwMTNmZTEwM2U4MDRjMzg0In0=
googleapis · Jul 6, 2023 · debf9c4 · debf9c4
1 parent d59ca76
commit debf9c4
Show file tree

Hide file tree

Showing 6 changed files with 155 additions and 62 deletions.
diff --git a/BigQueryStorage/samples/V1/BigQueryWriteClient/append_rows.php b/BigQueryStorage/samples/V1/BigQueryWriteClient/append_rows.php
@@ -62,18 +62,38 @@
  * finalized (via the `FinalizeWriteStream` rpc), and the stream is explicitly
  * committed via the `BatchCommitWriteStreams` rpc.
  *
- * @param string $formattedWriteStream The write_stream identifies the target of the append operation,
- *                                     and only needs to be specified as part of the first request on the gRPC
- *                                     connection. If provided for subsequent requests, it must match the value of
- *                                     the first request.
+ * @param string $formattedWriteStream The write_stream identifies the append operation. It must be
+ *                                     provided in the following scenarios:
+ *
+ *                                     * In the first request to an AppendRows connection.
+ *
+ *                                     * In all subsequent requests to an AppendRows connection, if you use the
+ *                                     same connection to write to multiple tables or change the input schema for
+ *                                     default streams.
  *
  *                                     For explicitly created write streams, the format is:
  *
  *                                     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`
  *
  *                                     For the special default stream, the format is:
  *
- *                                     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`. Please see
+ *                                     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`.
+ *
+ *                                     An example of a possible sequence of requests with write_stream fields
+ *                                     within a single connection:
+ *
+ *                                     * r1: {write_stream: stream_name_1}
+ *
+ *                                     * r2: {write_stream: /*omit&#42;/}
+ *
+ *                                     * r3: {write_stream: /*omit&#42;/}
+ *
+ *                                     * r4: {write_stream: stream_name_2}
+ *
+ *                                     * r5: {write_stream: stream_name_2}
+ *
+ *                                     The destination changed in request_4, so the write_stream field must be
+ *                                     populated in all subsequent requests in this stream. Please see
  *                                     {@see BigQueryWriteClient::writeStreamName()} for help formatting this field.
  */
 function append_rows_sample(string $formattedWriteStream): void

diff --git a/BigQueryStorage/src/V1/AppendRowsRequest.php b/BigQueryStorage/src/V1/AppendRowsRequest.php
diff --git a/BigQueryStorage/src/V1/AppendRowsRequest/MissingValueInterpretation.php b/BigQueryStorage/src/V1/AppendRowsRequest/MissingValueInterpretation.php
diff --git a/BigQueryStorage/src/V1/AppendRowsRequest/ProtoData.php b/BigQueryStorage/src/V1/AppendRowsRequest/ProtoData.php