@google-cloud/bigquery-storage-api 0.2.0 → 0.4.0

package/build/protos/google/cloud/bigquery/storage/v1/arrow.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/cloud/bigquery/storage/v1/avro.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/cloud/bigquery/storage/v1/protobuf.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/cloud/bigquery/storage/v1/storage.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -279,6 +279,18 @@ message ReadRowsRequest {
   // Requesting a larger offset is undefined. If not specified, start reading
   // from offset zero.
   int64 offset = 2;
+
+  // Specifies output serialization options. Only job _default streams are
+  // supported.
+  //
+  // This feature is not yet available.
+  oneof output_format_serialization_options {
+    // Optional. Options specific to the Apache Arrow output format.
+    //
+    // This feature is not yet available.
+    ArrowSerializationOptions arrow_serialization_options = 5
+        [(google.api.field_behavior) = OPTIONAL];
+  }
 }
 
 // Information on if the current connection is being throttled.
@@ -365,6 +377,13 @@ message ReadRowsResponse {
   // greater than 0, the client should skip decompression.
   optional int64 uncompressed_byte_size = 9
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The total estimated number of rows in the query results.
+  // Only populated when reading data from a BigQuery job.
+  //
+  // This feature is not yet available.
+  optional int64 total_estimated_row_count = 10
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Request message for `SplitReadStream`.
@@ -419,7 +438,7 @@ message CreateWriteStreamRequest {
 // switching table destinations. You can also switch table destinations within
 // the same connection for the default stream.
 //
-// The size of a single AppendRowsRequest must be less than 10 MB in size.
+// The size of a single AppendRowsRequest must be less than 20 MB in size.
 // Requests larger than this return an error, typically `INVALID_ARGUMENT`.
 message AppendRowsRequest {
   // Arrow schema and data.
@@ -559,6 +578,9 @@ message AppendRowsRequest {
   // time, set `missing_value_interpretations` to `NULL_VALUE` on those columns.
   MissingValueInterpretation default_missing_value_interpretation = 8
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Stats and telemetry data gathered on the client side.
+  ClientStats client_stats = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for `AppendRows`.
@@ -784,3 +806,68 @@ message RowError {
   // Description of the issue encountered when processing the row.
   string message = 3;
 }
+
+// Stats and telemetry data gathered on the client side about requests
+// being sent to the BigQuery Storage service, for internal use only.
+message ClientStats {
+  // Stats and telemetry data gathered on the client side about a single
+  // request.
+  message RequestStats {
+    // Optional. Timestamp indicating when the request was sent over the
+    // network, expressed in epoch milliseconds.
+    optional int64 send_time_millis = 1
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Number of pending requests at the moment this request was sent.
+    // This includes requests waiting to be sent, and those that are inflight.
+    optional int64 queued_requests_count = 2
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Aggregate connection metrics over a window interval.
+  message WindowStats {
+    // Optional. The maximum response latency observed in the window, expressed
+    // in milliseconds.
+    optional int64 max_response_latency_millis = 1
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The average response latency observed in the window, expressed
+    // in milliseconds.
+    optional int64 avg_response_latency_millis = 2
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The longest time spent waiting without receiving a response in
+    // the window. This could exceed max_response_latency_millis because the
+    // latter is evaluated only when a response is received. Expressed in
+    // milliseconds.
+    optional int64 longest_wait_no_response_millis = 3
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. How many requests were sent in the window.
+    optional int64 requests_sent_count = 4
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. How many responses were received in the window.
+    optional int64 responses_received_count = 5
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. How many bytes were sent in the window.
+    optional int64 bytes_sent_count = 6
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Start time of the window interval for which these stats are
+    // aggregated, expressed in epoch milliseconds.
+    optional int64 window_start_time_epoch_millis = 7
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Duration of the window interval for which these stats are
+    // aggregated, expressed in milliseconds.
+    optional int64 window_millis = 8 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Optional. Per-request stats.
+  RequestStats request_stats = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Windowed stats.
+  WindowStats window_stats = 2 [(google.api.field_behavior) = OPTIONAL];
+}

package/build/protos/google/cloud/bigquery/storage/v1/stream.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/cloud/bigquery/storage/v1/table.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.