From 9c769d3a0e67e4df9b9e8eee480124c2700a7e6c Mon Sep 17 00:00:00 2001
From: Google APIs <noreply@google.com>
Date: Wed, 27 Feb 2019 14:53:20 -0800
Subject: [PATCH] Synchronize new proto/yaml changes.

PiperOrigin-RevId: 235997788
---
 .../cloud/bigquery/storage/v1beta1/avro.proto |  2 +-
 .../storage/v1beta1/read_options.proto        | 13 +++++---
 .../bigquery/storage/v1beta1/storage.proto    | 32 +++++++++----------
 .../storage/v1beta1/table_reference.proto     |  2 +-
 4 files changed, 26 insertions(+), 23 deletions(-)

diff --git a/google/cloud/bigquery/storage/v1beta1/avro.proto b/google/cloud/bigquery/storage/v1beta1/avro.proto
index b75de8f2..699d70a6 100644
--- a/google/cloud/bigquery/storage/v1beta1/avro.proto
+++ b/google/cloud/bigquery/storage/v1beta1/avro.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/google/cloud/bigquery/storage/v1beta1/read_options.proto b/google/cloud/bigquery/storage/v1beta1/read_options.proto
index 84307ce4..8a3c6669 100644
--- a/google/cloud/bigquery/storage/v1beta1/read_options.proto
+++ b/google/cloud/bigquery/storage/v1beta1/read_options.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -30,10 +30,13 @@ message TableReadOptions {
   repeated string selected_fields = 1;
 
   // Optional. SQL text filtering statement, similar to a WHERE clause in
-  // a query. Currently, we support combinations of predicates that are
-  // a comparison between a column and a constant value in SQL statement.
-  // Aggregates are not supported.
+  // a query. Currently, only a single predicate that is a comparison between
+  // a column and a constant value is supported. Aggregates are not supported.
   //
-  // Example: "a > DATE '2014-9-27' AND (b > 5 and C LIKE 'date')"
+  // Examples: "int_field > 5"
+  //           "date_field = CAST('2014-9-27' as DATE)"
+  //           "nullable_field is not NULL"
+  //           "st_equals(geo_field, st_geofromtext("POINT(2, 2)"))"
+  //           "numeric_field BETWEEN 1.0 AND 5.0"
   string row_restriction = 2;
 }
diff --git a/google/cloud/bigquery/storage/v1beta1/storage.proto b/google/cloud/bigquery/storage/v1beta1/storage.proto
index 7396355f..3e6686ff 100644
--- a/google/cloud/bigquery/storage/v1beta1/storage.proto
+++ b/google/cloud/bigquery/storage/v1beta1/storage.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -100,8 +100,8 @@ service BigQueryStorage {
 
 // Information about a single data stream within a read session.
 message Stream {
-  // Name of the stream. In the form
-  // `/projects/{project_id}/stream/{stream_id}`
+  // Name of the stream, in the form
+  // `projects/{project_id}/locations/{location}/streams/{stream_id}`.
   string name = 1;
 
   // Rows in the stream.
@@ -119,8 +119,8 @@ message StreamPosition {
 
 // Information returned from a `CreateReadSession` request.
 message ReadSession {
-  // Unique identifier for the session. In the form
-  // `projects/{project_id}/sessions/{session_id}`
+  // Unique identifier for the session, in the form
+  // `projects/{project_id}/locations/{location}/sessions/{session_id}`.
   string name = 1;
 
   // Time at which the session becomes invalid. After this time, subsequent
@@ -151,7 +151,7 @@ message CreateReadSessionRequest {
   // Required. Reference to the table to read.
   TableReference table_reference = 1;
 
-  // Required. String of the form "projects/your-project-id" indicating the
+  // Required. String of the form `projects/{project_id}` indicating the
   // project this ReadSession is associated with. This is the project that will
   // be billed for usage.
   string parent = 6;
@@ -175,6 +175,16 @@ message CreateReadSessionRequest {
   DataFormat format = 5;
 }
 
+// Data format for input or output data.
+enum DataFormat {
+  // Data format is unspecified.
+  DATA_FORMAT_UNSPECIFIED = 0;
+
+  // Avro is a standard open source row based file format.
+  // See https://avro.apache.org/ for more details.
+  AVRO = 1;
+}
+
 // Requesting row data via `ReadRows` must provide Stream position information.
 message ReadRowsRequest {
   // Required. Identifier of the position in the stream to start reading from.
@@ -256,13 +266,3 @@ message SplitReadStreamResponse {
   // Remainder stream. Will contain the tail of |original_stream|.
   Stream remainder_stream = 2;
 }
-
-// Data format for input or output data.
-enum DataFormat {
-  // Data format is unspecified.
-  DATA_FORMAT_UNSPECIFIED = 0;
-
-  // Avro is a standard open source row based file format.
-  // See https://avro.apache.org/ for more details.
-  AVRO = 1;
-}
diff --git a/google/cloud/bigquery/storage/v1beta1/table_reference.proto b/google/cloud/bigquery/storage/v1beta1/table_reference.proto
index a493fac9..758864a5 100644
--- a/google/cloud/bigquery/storage/v1beta1/table_reference.proto
+++ b/google/cloud/bigquery/storage/v1beta1/table_reference.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.