docs: Align session length with public documentation

feat: Expose estimated bytes that a session will scan. Committer: @emkornfield PiperOrigin-RevId: 396849937
googleapis · Sep 15, 2021 · 5661452 · 5661452
1 parent a27fb7a
commit 5661452
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 1 deletion.
diff --git a/google/cloud/bigquery/storage/v1/storage.proto b/google/cloud/bigquery/storage/v1/storage.proto
@@ -62,7 +62,7 @@ service BigQueryRead {
   // limits are enforced based on the number of pre-filtered rows, so some
   // filters can lead to lopsided assignments.
   //
-  // Read sessions automatically expire 24 hours after they are created and do
+  // Read sessions automatically expire 6 hours after they are created and do
   // not require manual clean-up by the caller.
   rpc CreateReadSession(CreateReadSessionRequest) returns (ReadSession) {
     option (google.api.http) = {

diff --git a/google/cloud/bigquery/storage/v1/stream.proto b/google/cloud/bigquery/storage/v1/stream.proto
@@ -126,6 +126,11 @@ message ReadSession {
   // in that case, the user will need to use a List method to get the streams
   // instead, which is not yet available.
   repeated ReadStream streams = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. An estimate on the number of bytes this session will scan when
+  // all streams are completely consumed. This estimate is based on
+  // metadata from the table which might be incomplete or stale.
+  int64 estimated_total_bytes_scanned = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Information about a single stream that gets data out of the storage system.