diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py index 145d6b440f55..bd8782b42f66 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py @@ -220,9 +220,9 @@ def create_read_session( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.bigquery_storage_v1beta1.types.TableReference` - parent (str): Required. String of the form "projects/your-project-id" indicating the - project this ReadSession is associated with. This is the project that will - be billed for usage. + parent (str): 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. table_modifiers (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.TableModifiers]): Optional. Any modifiers to the Table (e.g. snapshot timestamp). If a dict is provided, it must be of the same form as the protobuf diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto index b75de8f266f1..699d70a671ec 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/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/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.proto index 84307ce475e9..8a3c66699f57 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.proto +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/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/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py index 97395666d8ea..2f9ab009c137 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py @@ -104,10 +104,13 @@ of fields in selected\_fields. row_restriction: 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. - Example: "a > DATE '2014-9-27' AND (b > 5 and C LIKE 'date')" + clause in a query. Currently, only a single predicate that is + a comparison between a column and a constant value is + supported. Aggregates are not supported. 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" """, # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.TableReadOptions) ), diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto index 7396355f0ed5..3e6686ffdb37 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/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/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py index e54743f275fc..8a246cebf944 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py @@ -981,8 +981,8 @@ Attributes: name: - Name of the stream. In the form - ``/projects/{project_id}/stream/{stream_id}`` + Name of the stream, in the form ``projects/{project_id}/locati + ons/{location}/streams/{stream_id}``. row_count: Rows in the stream. """, @@ -1022,8 +1022,8 @@ Attributes: name: - Unique identifier for the session. In the form - ``projects/{project_id}/sessions/{session_id}`` + Unique identifier for the session, in the form ``projects/{pro + ject_id}/locations/{location}/sessions/{session_id}``. expire_time: Time at which the session becomes invalid. After this time, subsequent requests to read this Session will return errors. @@ -1060,7 +1060,7 @@ table_reference: Required. Reference to the table to read. parent: - Required. String of the form "projects/your-project-id" + 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. table_modifiers: diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.proto index a493fac91b0e..758864a5533c 100644 --- a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.proto +++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/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. diff --git a/bigquery_storage/synth.metadata b/bigquery_storage/synth.metadata index 3cc183892efd..401e533d99fb 100644 --- a/bigquery_storage/synth.metadata +++ b/bigquery_storage/synth.metadata @@ -1,19 +1,19 @@ { - "updateTime": "2019-01-31T13:17:09.982059Z", + "updateTime": "2019-02-28T13:10:39.155085Z", "sources": [ { "generator": { "name": "artman", - "version": "0.16.7", - "dockerImage": "googleapis/artman@sha256:d6c8ced606eb49973ca95d2af7c55a681acc042db0f87d135968349e7bf6dd80" + "version": "0.16.14", + "dockerImage": "googleapis/artman@sha256:f3d61ae45abaeefb6be5f228cda22732c2f1b00fb687c79c4bd4f2c42bb1e1a7" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "9607c39973de36d319ec8861ac39a826163e21de", - "internalRef": "231680111" + "sha": "9c769d3a0e67e4df9b9e8eee480124c2700a7e6c", + "internalRef": "235997788" } } ],