feat: add location to WriteStream and add WriteStreamView support

Google APIs · copybara-github · commit 1cf9407d5a7c · 2022-09-07T16:02:40.000-07:00
PiperOrigin-RevId: 472835596
diff --git a/google/cloud/bigquery/storage/v1/storage.proto b/google/cloud/bigquery/storage/v1/storage.proto
@@ -524,6 +524,10 @@ message GetWriteStreamRequest {
       type: "bigquerystorage.googleapis.com/WriteStream"
     }
   ];
+
+  // Indicates whether to get full or partial view of the WriteStream. If
+  // not set, view returned will be basic.
+  WriteStreamView view = 3;
 }
 
 // Request message for `BatchCommitWriteStreams`.
diff --git a/google/cloud/bigquery/storage/v1/stream.proto b/google/cloud/bigquery/storage/v1/stream.proto
@@ -203,6 +203,23 @@ message ReadStream {
   string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
+// WriteStreamView is a view enum that controls what details about a write
+// stream should be returned.
+enum WriteStreamView {
+  // The default / unset value.
+  WRITE_STREAM_VIEW_UNSPECIFIED = 0;
+
+  // The BASIC projection returns basic metadata about a write stream.  The
+  // basic view does not include schema information.  This is the default view
+  // returned by GetWriteStream.
+  BASIC = 1;
+
+  // The FULL projection returns all available write stream metadata, including
+  // the schema.  CreateWriteStream returns the full projection of write stream
+  // metadata.
+  FULL = 2;
+}
+
 // Information about a single stream that gets data inside the storage system.
 message WriteStream {
   option (google.api.resource) = {
@@ -261,4 +278,9 @@ message WriteStream {
 
   // Immutable. Mode of the stream.
   WriteMode write_mode = 7 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Immutable. The geographic location where the stream's dataset resides. See
+  // https://cloud.google.com/bigquery/docs/locations for supported
+  // locations.
+  string location = 8 [(google.api.field_behavior) = IMMUTABLE];
 }

Original file line number	Diff line number	Diff line change
`@@ -524,6 +524,10 @@ message GetWriteStreamRequest {`
`524`	`524`	`type: "bigquerystorage.googleapis.com/WriteStream"`
`525`	`525`	`}`
`526`	`526`	`];`
	`527`	`+`
	`528`	`+ // Indicates whether to get full or partial view of the WriteStream. If`
	`529`	`+ // not set, view returned will be basic.`
	`530`	`+ WriteStreamView view = 3;`
`527`	`531`	`}`
`528`	`532`
`529`	`533`	// Request message for `BatchCommitWriteStreams`.