From 5880db046d57fb9ad096f78849c6c186c5824030 Mon Sep 17 00:00:00 2001 From: ohmayr Date: Wed, 21 Oct 2026 22:09:02 +0000 Subject: [PATCH 1/2] docs(bigquery-storage): mark ReadRows arrow serialization as preview The backend marks ReadRowsRequest.arrow_serialization_options as not yet available, but the read_rows() parameter had no preview marker. Label it [Private Preview], matching google-cloud-bigquery's timestamp_precision. --- .../google/cloud/bigquery_storage_v1/client.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py index 36a7ef4a51f3..3784c5791d44 100644 --- a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py +++ b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py @@ -160,9 +160,9 @@ def read_rows( arrow_serialization_options (Optional[Union[dict, \ ~google.cloud.bigquery_storage_v1.types.ArrowSerializationOptions \ ]]): - Arrow serialization options, such as buffer compression, to - send on every ``ReadRows`` request, including after a - reconnect. Only job default streams + [Private Preview] Arrow serialization options, such as buffer + compression, to send on every ``ReadRows`` request, including + after a reconnect. Only job default streams (``projects/{project}/locations/{location}/jobs/{job}/streams/_default``) accept them. From 16fa6b38919fd94f26bfbe0871e1a965d597c188 Mon Sep 17 00:00:00 2001 From: ohmayr Date: Wed, 21 Oct 2026 22:29:29 +0000 Subject: [PATCH 2/2] docs(bigquery-storage): mark ReadRows arrow serialization as beta Use [Beta] instead of [Private Preview], matching google-cloud-bigquery, which sends this field for ARROW query results and marks query_results_format and compression_codec as [Beta]. Also mark the field where the ReadRowsStream request_template docstring uses it as an example. --- .../google/cloud/bigquery_storage_v1/client.py | 6 +++--- .../google/cloud/bigquery_storage_v1/reader.py | 8 ++++---- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py index 3784c5791d44..750cac56ea1f 100644 --- a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py +++ b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/client.py @@ -160,9 +160,9 @@ def read_rows( arrow_serialization_options (Optional[Union[dict, \ ~google.cloud.bigquery_storage_v1.types.ArrowSerializationOptions \ ]]): - [Private Preview] Arrow serialization options, such as buffer - compression, to send on every ``ReadRows`` request, including - after a reconnect. Only job default streams + [Beta] Arrow serialization options, such as buffer compression, + to send on every ``ReadRows`` request, including after a + reconnect. Only job default streams (``projects/{project}/locations/{location}/jobs/{job}/streams/_default``) accept them. diff --git a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/reader.py b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/reader.py index 5a8bf4271458..6cff19078d23 100644 --- a/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/reader.py +++ b/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/reader.py @@ -133,10 +133,10 @@ def __init__( request_template (Optional[Union[dict, \ ~google.cloud.bigquery_storage_v1.types.ReadRowsRequest \ ]]): - Request fields, such as ``arrow_serialization_options``, to - send on every ``ReadRows`` request, including after a - reconnect. ``read_stream`` and ``offset`` are set from - ``name`` and the current stream offset. + Request fields, such as ``arrow_serialization_options`` + ([Beta]), to send on every ``ReadRows`` request, including + after a reconnect. ``read_stream`` and ``offset`` are set + from ``name`` and the current stream offset. Returns: Iterable[ \