Skip to content

Commit 31f26fe

Browse files
cloud-java-botcloud-java-bot
authored
chore: Update generation configuration at Tue Sep 10 17:17:52 UTC 2024 (googleapis#2634)
* chore: Update generation configuration at Tue Sep 10 02:21:41 UTC 2024 * chore: Update generation configuration at Tue Sep 10 17:17:52 UTC 2024 * chore: generate libraries at Tue Sep 10 17:18:15 UTC 2024
1 parent 904a439 commit 31f26fe

14 files changed

+204
-72
lines changed

‎README.md

Lines changed: 22 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,17 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
1919
<dependency>
2020
<groupId>com.google.cloud</groupId>
2121
<artifactId>libraries-bom</artifactId>
22-
<version>26.44.0</version>
22+
<version>26.45.0</version>
2323
<type>pom</type>
2424
<scope>import</scope>
2525
</dependency>
26+
<dependency>
27+
<groupId>io.opentelemetry</groupId>
28+
<artifactId>opentelemetry-bom</artifactId>
29+
<version>1.41.0</version>
30+
<type>pom</type>
31+
<scope>import</scope>
32+
</dependency>
2633
</dependencies>
2734
</dependencyManagement>
2835

@@ -42,7 +49,7 @@ If you are using Maven without the BOM, add this to your dependencies:
4249
<dependency>
4350
<groupId>com.google.cloud</groupId>
4451
<artifactId>google-cloud-bigquerystorage</artifactId>
45-
<version>3.8.1</version>
52+
<version>3.9.0</version>
4653
</dependency>
4754

4855
```
@@ -57,13 +64,13 @@ implementation 'com.google.cloud:google-cloud-bigquerystorage'
5764
If you are using Gradle without BOM, add this to your dependencies:
5865

5966
```Groovy
60-
implementation 'com.google.cloud:google-cloud-bigquerystorage:3.8.1'
67+
implementation 'com.google.cloud:google-cloud-bigquerystorage:3.9.0'
6168
```
6269

6370
If you are using SBT, add this to your dependencies:
6471

6572
```Scala
66-
libraryDependencies += "com.google.cloud" % "google-cloud-bigquerystorage" % "3.8.1"
73+
libraryDependencies += "com.google.cloud" % "google-cloud-bigquerystorage" % "3.9.0"
6774
```
6875
<!-- {x-version-update-end} -->
6976

@@ -106,50 +113,19 @@ use this BigQuery Storage Client Library.
106113

107114
Samples are in the [`samples/`](https://github.com/googleapis/java-bigquerystorage/tree/main/samples) directory.
108115

109-
| Sample | Source Code | Try it |
110-
|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
111-
| Json Writer Stream Cdc | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/JsonWriterStreamCdc.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/JsonWriterStreamCdc.java) |
116+
| Sample | Source Code | Try it |
117+
| --------------------------- | --------------------------------- | ------ |
118+
| Export Open Telemetry | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/ExportOpenTelemetry.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/ExportOpenTelemetry.java) |
119+
| Json Writer Stream Cdc | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/JsonWriterStreamCdc.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/JsonWriterStreamCdc.java) |
112120
| Parallel Write Committed Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/ParallelWriteCommittedStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/ParallelWriteCommittedStream.java) |
113-
| Storage Arrow Sample | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/StorageArrowSample.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/StorageArrowSample.java) |
114-
| Storage Sample | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/StorageSample.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/StorageSample.java) |
115-
| Write Buffered Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteBufferedStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteBufferedStream.java) |
116-
| Write Committed Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteCommittedStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteCommittedStream.java) |
117-
| Write Pending Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WritePendingStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WritePendingStream.java) |
118-
| Write To Default Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteToDefaultStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteToDefaultStream.java) |
119-
| Export OpenTelemetry Metrics | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/ExportOpenTelemetry.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/ExportOpenTelemetry.java) |
121+
| Storage Arrow Sample | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/StorageArrowSample.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/StorageArrowSample.java) |
122+
| Storage Sample | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/StorageSample.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/StorageSample.java) |
123+
| Write Buffered Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteBufferedStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteBufferedStream.java) |
124+
| Write Committed Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteCommittedStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteCommittedStream.java) |
125+
| Write Pending Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WritePendingStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WritePendingStream.java) |
126+
| Write To Default Stream | [source code](https://github.com/googleapis/java-bigquerystorage/blob/main/samples/snippets/src/main/java/com/example/bigquerystorage/WriteToDefaultStream.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-bigquerystorage&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/bigquerystorage/WriteToDefaultStream.java) |
120127

121-
## OpenTelemetry Support
122128

123-
The client supports emitting metrics to OpenTelemetry. This is disabled by default. It can be enabled by calling
124-
125-
```aidl
126-
JsonStreamWriter.Builder.setEnableOpenTelemetry(true)
127-
```
128-
The following attributes are supported.
129-
130-
| Key | Value |
131-
|-----------------|-----------------------------------------------------------|
132-
| `table_id` | Holds fully qualified name of destination table |
133-
| `writer_id` | Specifies writer instance id associated with queue lengths. |
134-
| `trace_field_1` | If a colon-separated traceId is provided, this holds the first portion. Must be non-empty. Currently populated only for Dataflow. |
135-
| `trace_field_2` | If a colon-separated traceId is provided, this holds the second portion. Must be non-empty. Currently populated only for Dataflow. |
136-
| `trace_field_3` | If a colon-separated traceId is provided, this holds the third portion. Must be non-empty. Currently populated only for Dataflow. |
137-
| `error_code` | Specifies error code in the event an append request fails, or a connection ends. |
138-
| `is_retry` | Indicates this was a retry operation. This can be set for either ack’ed requests or connection retry attempts. |
139-
140-
141-
The following metrics are supported.
142-
143-
| Name | Kind | Description |
144-
|------------------------------|---------------------|------------------------------------------------------------------------------------------------------------------|
145-
| `append_requests_acked` | Synchronous counter | Counts number of requests acked by the server |
146-
| `append_request_bytes_acked` | Synchronous counter | Counts byte size of requests acked by the server |
147-
| `append_rows_acked` | Synchronous counter | Counts number of rows in requests acked by the server |
148-
| `active_connection_count` | Asynchronous gauge | Reports number of active connections |
149-
| `inflight_queue_length` | Asynchronous gauge | Reports length of inflight queue. This queue contains sent append requests waiting for response from the server. |
150-
| `network_response_latency` | Histogram | Reports time taken in milliseconds for a response to arrive once a message has been sent over the network. |
151-
| `connection_start_count` | Synchronous counter | Counts number of connection attempts made, regardless of whether these are initial or retry. |
152-
| `connection_end_count` | Synchronous counter | Counts number of connection end events. This is decorated with the error code. |
153129

154130
## Troubleshooting
155131

@@ -251,7 +227,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
251227
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-bigquerystorage/java11.html
252228
[stability-image]: https://img.shields.io/badge/stability-stable-green
253229
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigquerystorage.svg
254-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerystorage/3.8.1
230+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerystorage/3.9.0
255231
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
256232
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
257233
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

‎generation_config.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
gapic_generator_version: 2.44.0
2-
googleapis_commitish: cb39bdd75da491466f6c92bc73cd46b0fbd6ba9a
1+
gapic_generator_version: 2.45.0
2+
googleapis_commitish: 02f62c8e241a9f95f0d183785354e90e35388cbd
33
libraries_bom_version: 26.45.0
44
libraries:
55
- api_shortname: bigquerystorage

‎google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadSettings.java

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,9 @@
4747
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
4848
* build() is called, the tree of builders is called to create the complete settings object.
4949
*
50-
* <p>For example, to set the total timeout of createReadSession to 30 seconds:
50+
* <p>For example, to set the
51+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
52+
* of createReadSession:
5153
*
5254
* <pre>{@code
5355
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -64,10 +66,21 @@
6466
* .createReadSessionSettings()
6567
* .getRetrySettings()
6668
* .toBuilder()
67-
* .setTotalTimeout(Duration.ofSeconds(30))
69+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
70+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
71+
* .setMaxAttempts(5)
72+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
73+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
74+
* .setRetryDelayMultiplier(1.3)
75+
* .setRpcTimeoutMultiplier(1.5)
76+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
6877
* .build());
6978
* BaseBigQueryReadSettings baseBigQueryReadSettings = baseBigQueryReadSettingsBuilder.build();
7079
* }</pre>
80+
*
81+
* Please refer to the [Client Side Retry
82+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
83+
* additional support in setting retries.
7184
*/
7285
@Generated("by gapic-generator-java")
7386
public class BaseBigQueryReadSettings extends ClientSettings<BaseBigQueryReadSettings> {

‎google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteSettings.java

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,9 @@
4747
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
4848
* build() is called, the tree of builders is called to create the complete settings object.
4949
*
50-
* <p>For example, to set the total timeout of createWriteStream to 30 seconds:
50+
* <p>For example, to set the
51+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
52+
* of createWriteStream:
5153
*
5254
* <pre>{@code
5355
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -63,10 +65,21 @@
6365
* .createWriteStreamSettings()
6466
* .getRetrySettings()
6567
* .toBuilder()
66-
* .setTotalTimeout(Duration.ofSeconds(30))
68+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
69+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
70+
* .setMaxAttempts(5)
71+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
72+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
73+
* .setRetryDelayMultiplier(1.3)
74+
* .setRpcTimeoutMultiplier(1.5)
75+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
6776
* .build());
6877
* BigQueryWriteSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
6978
* }</pre>
79+
*
80+
* Please refer to the [Client Side Retry
81+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
82+
* additional support in setting retries.
7083
*/
7184
@Generated("by gapic-generator-java")
7285
public class BigQueryWriteSettings extends ClientSettings<BigQueryWriteSettings> {

‎google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryReadStubSettings.java

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,9 @@
6363
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
6464
* build() is called, the tree of builders is called to create the complete settings object.
6565
*
66-
* <p>For example, to set the total timeout of createReadSession to 30 seconds:
66+
* <p>For example, to set the
67+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
68+
* of createReadSession:
6769
*
6870
* <pre>{@code
6971
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -80,10 +82,21 @@
8082
* .createReadSessionSettings()
8183
* .getRetrySettings()
8284
* .toBuilder()
83-
* .setTotalTimeout(Duration.ofSeconds(30))
85+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
86+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
87+
* .setMaxAttempts(5)
88+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
89+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
90+
* .setRetryDelayMultiplier(1.3)
91+
* .setRpcTimeoutMultiplier(1.5)
92+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
8493
* .build());
8594
* BigQueryReadStubSettings baseBigQueryReadSettings = baseBigQueryReadSettingsBuilder.build();
8695
* }</pre>
96+
*
97+
* Please refer to the [Client Side Retry
98+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
99+
* additional support in setting retries.
87100
*/
88101
@Generated("by gapic-generator-java")
89102
public class BigQueryReadStubSettings extends StubSettings<BigQueryReadStubSettings> {

0 commit comments

Comments
 (0)