google-cloud-bigquery-storage-v1 0.7.0 → 0.9.1

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

data/proto_docs/google/cloud/bigquery/storage/v1/protobuf.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigquery
+      module Storage
+        module V1
+          # ProtoSchema describes the schema of the serialized protocol buffer data rows.
+          # @!attribute [rw] proto_descriptor
+          #   @return [::Google::Protobuf::DescriptorProto]
+          #     Descriptor for input message.  The provided descriptor must be self
+          #     contained, such that data rows sent can be fully decoded using only the
+          #     single descriptor.  For data rows that are compositions of multiple
+          #     independent messages, this means the descriptor may need to be transformed
+          #     to only use nested types:
+          #     https://developers.google.com/protocol-buffers/docs/proto#nested
+          #
+          #     For additional information for how proto types and values map onto BigQuery
+          #     see: https://cloud.google.com/bigquery/docs/write-api#data_type_conversions
+          class ProtoSchema
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] serialized_rows
+          #   @return [::Array<::String>]
+          #     A sequence of rows serialized as a Protocol Buffer.
+          #
+          #     See https://developers.google.com/protocol-buffers/docs/overview for more
+          #     information on deserializing this field.
+          class ProtoRows
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/bigquery/storage/v1/storage.rb

@@ -69,7 +69,7 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Estimated stream statistics for a given Stream.
+          # Estimated stream statistics for a given read Stream.
           # @!attribute [rw] progress
           #   @return [::Google::Cloud::Bigquery::Storage::V1::StreamStats::Progress]
           #     Represents the progress of the current stream.
@@ -162,6 +162,249 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Request message for `CreateWriteStream`.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. Reference to the table to which the stream belongs, in the format
+          #     of `projects/{project}/datasets/{dataset}/tables/{table}`.
+          # @!attribute [rw] write_stream
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::WriteStream]
+          #     Required. Stream to be created.
+          class CreateWriteStreamRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for `AppendRows`.
+          #
+          # Due to the nature of AppendRows being a bidirectional streaming RPC, certain
+          # parts of the AppendRowsRequest need only be specified for the first request
+          # sent each time the gRPC network connection is opened/reopened.
+          # @!attribute [rw] write_stream
+          #   @return [::String]
+          #     Required. The write_stream identifies the target of the append operation, and only
+          #     needs to be specified as part of the first request on the gRPC connection.
+          #     If provided for subsequent requests, it must match the value of the first
+          #     request.
+          #
+          #     For explicitly created write streams, the format is:
+          #     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`
+          #
+          #     For the special default stream, the format is:
+          #     `projects/{project}/datasets/{dataset}/tables/{table}/_default`.
+          # @!attribute [rw] offset
+          #   @return [::Google::Protobuf::Int64Value]
+          #     If present, the write is only performed if the next append offset is same
+          #     as the provided value. If not present, the write is performed at the
+          #     current end of stream. Specifying a value for this field is not allowed
+          #     when calling AppendRows for the '_default' stream.
+          # @!attribute [rw] proto_rows
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest::ProtoData]
+          #     Rows in proto format.
+          # @!attribute [rw] trace_id
+          #   @return [::String]
+          #     Id set by client to annotate its identity. Only initial request setting is
+          #     respected.
+          class AppendRowsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # ProtoData contains the data rows and schema when constructing append
+            # requests.
+            # @!attribute [rw] writer_schema
+            #   @return [::Google::Cloud::Bigquery::Storage::V1::ProtoSchema]
+            #     Proto schema used to serialize the data.  This value only needs to be
+            #     provided as part of the first request on a gRPC network connection,
+            #     and will be ignored for subsequent requests on the connection.
+            # @!attribute [rw] rows
+            #   @return [::Google::Cloud::Bigquery::Storage::V1::ProtoRows]
+            #     Serialized row data in protobuf message format.
+            #     Currently, the backend expects the serialized rows to adhere to
+            #     proto2 semantics when appending rows, particularly with respect to
+            #     how default values are encoded.
+            class ProtoData
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Response message for `AppendRows`.
+          # @!attribute [rw] append_result
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::AppendRowsResponse::AppendResult]
+          #     Result if the append is successful.
+          # @!attribute [rw] error
+          #   @return [::Google::Rpc::Status]
+          #     Error returned when problems were encountered.  If present,
+          #     it indicates rows were not accepted into the system.
+          #     Users can retry or continue with other append requests within the
+          #     same connection.
+          #
+          #     Additional information about error signalling:
+          #
+          #     ALREADY_EXISTS: Happens when an append specified an offset, and the
+          #     backend already has received data at this offset.  Typically encountered
+          #     in retry scenarios, and can be ignored.
+          #
+          #     OUT_OF_RANGE: Returned when the specified offset in the stream is beyond
+          #     the current end of the stream.
+          #
+          #     INVALID_ARGUMENT: Indicates a malformed request or data.
+          #
+          #     ABORTED: Request processing is aborted because of prior failures.  The
+          #     request can be retried if previous failure is addressed.
+          #
+          #     INTERNAL: Indicates server side error(s) that can be retried.
+          # @!attribute [rw] updated_schema
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::TableSchema]
+          #     If backend detects a schema update, pass it to user so that user can
+          #     use it to input new type of message. It will be empty when no schema
+          #     updates have occurred.
+          class AppendRowsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # AppendResult is returned for successful append requests.
+            # @!attribute [rw] offset
+            #   @return [::Google::Protobuf::Int64Value]
+            #     The row offset at which the last append occurred. The offset will not be
+            #     set if appending using default streams.
+            class AppendResult
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Request message for `GetWriteStreamRequest`.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. Name of the stream to get, in the form of
+          #     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
+          class GetWriteStreamRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for `BatchCommitWriteStreams`.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. Parent table that all the streams should belong to, in the form of
+          #     `projects/{project}/datasets/{dataset}/tables/{table}`.
+          # @!attribute [rw] write_streams
+          #   @return [::Array<::String>]
+          #     Required. The group of streams that will be committed atomically.
+          class BatchCommitWriteStreamsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for `BatchCommitWriteStreams`.
+          # @!attribute [rw] commit_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which streams were committed in microseconds granularity.
+          #     This field will only exist when there are no stream errors.
+          #     **Note** if this field is not set, it means the commit was not successful.
+          # @!attribute [rw] stream_errors
+          #   @return [::Array<::Google::Cloud::Bigquery::Storage::V1::StorageError>]
+          #     Stream level error if commit failed. Only streams with error will be in
+          #     the list.
+          #     If empty, there is no error and all streams are committed successfully.
+          #     If non empty, certain streams have errors and ZERO stream is committed due
+          #     to atomicity guarantee.
+          class BatchCommitWriteStreamsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for invoking `FinalizeWriteStream`.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. Name of the stream to finalize, in the form of
+          #     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
+          class FinalizeWriteStreamRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for `FinalizeWriteStream`.
+          # @!attribute [rw] row_count
+          #   @return [::Integer]
+          #     Number of rows in the finalized stream.
+          class FinalizeWriteStreamResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for `FlushRows`.
+          # @!attribute [rw] write_stream
+          #   @return [::String]
+          #     Required. The stream that is the target of the flush operation.
+          # @!attribute [rw] offset
+          #   @return [::Google::Protobuf::Int64Value]
+          #     Ending offset of the flush operation. Rows before this offset(including
+          #     this offset) will be flushed.
+          class FlushRowsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Respond message for `FlushRows`.
+          # @!attribute [rw] offset
+          #   @return [::Integer]
+          #     The rows before this offset (including this offset) are flushed.
+          class FlushRowsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Structured custom BigQuery Storage error message. The error can be attached
+          # as error details in the returned rpc Status. In particular, the use of error
+          # codes allows more structured error handling, and reduces the need to evaluate
+          # unstructured error text strings.
+          # @!attribute [rw] code
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::StorageError::StorageErrorCode]
+          #     BigQuery Storage specific error code.
+          # @!attribute [rw] entity
+          #   @return [::String]
+          #     Name of the failed entity.
+          # @!attribute [rw] error_message
+          #   @return [::String]
+          #     Message that describes the error.
+          class StorageError
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Error code for `StorageError`.
+            module StorageErrorCode
+              # Default error.
+              STORAGE_ERROR_CODE_UNSPECIFIED = 0
+
+              # Table is not found in the system.
+              TABLE_NOT_FOUND = 1
+
+              # Stream is already committed.
+              STREAM_ALREADY_COMMITTED = 2
+
+              # Stream is not found.
+              STREAM_NOT_FOUND = 3
+
+              # Invalid Stream type.
+              # For example, you try to commit a stream that is not pending.
+              INVALID_STREAM_TYPE = 4
+
+              # Invalid Stream state.
+              # For example, you try to commit a stream that is not finalized or is
+              # garbaged.
+              INVALID_STREAM_STATE = 5
+
+              # Stream is finalized.
+              STREAM_FINALIZED = 6
+
+              # There is a schema mismatch and it is caused by user schema has extra
+              # field than bigquery schema.
+              SCHEMA_MISMATCH_EXTRA_FIELDS = 7
+            end
+          end
         end
       end
     end

data/proto_docs/google/cloud/bigquery/storage/v1/stream.rb

@@ -117,6 +117,64 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Information about a single stream that gets data inside the storage system.
+          # @!attribute [r] name
+          #   @return [::String]
+          #     Output only. Name of the stream, in the form
+          #     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
+          # @!attribute [rw] type
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::WriteStream::Type]
+          #     Immutable. Type of the stream.
+          # @!attribute [r] create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. Create time of the stream. For the _default stream, this is the
+          #     creation_time of the table.
+          # @!attribute [r] commit_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. Commit time of the stream.
+          #     If a stream is of `COMMITTED` type, then it will have a commit_time same as
+          #     `create_time`. If the stream is of `PENDING` type, empty commit_time
+          #     means it is not committed.
+          # @!attribute [r] table_schema
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::TableSchema]
+          #     Output only. The schema of the destination table. It is only returned in
+          #     `CreateWriteStream` response. Caller should generate data that's
+          #     compatible with this schema to send in initial `AppendRowsRequest`.
+          #     The table schema could go out of date during the life time of the stream.
+          # @!attribute [rw] write_mode
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::WriteStream::WriteMode]
+          #     Immutable. Mode of the stream.
+          class WriteStream
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Type enum of the stream.
+            module Type
+              # Unknown type.
+              TYPE_UNSPECIFIED = 0
+
+              # Data will commit automatically and appear as soon as the write is
+              # acknowledged.
+              COMMITTED = 1
+
+              # Data is invisible until the stream is committed.
+              PENDING = 2
+
+              # Data is only visible up to the offset to which it was flushed.
+              BUFFERED = 3
+            end
+
+            # Mode enum of the stream.
+            module WriteMode
+              # Unknown type.
+              WRITE_MODE_UNSPECIFIED = 0
+
+              # Insert new records into the table.
+              # It is the default value if customers do not specify it.
+              INSERT = 1
+            end
+          end
+
           # Data format for input or output data.
           module DataFormat
             DATA_FORMAT_UNSPECIFIED = 0

data/proto_docs/google/cloud/bigquery/storage/v1/table.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigquery
+      module Storage
+        module V1
+          # Schema of a table.
+          # @!attribute [rw] fields
+          #   @return [::Array<::Google::Cloud::Bigquery::Storage::V1::TableFieldSchema>]
+          #     Describes the fields in a table.
+          class TableSchema
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # TableFieldSchema defines a single field/column within a table schema.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The field name. The name must contain only letters (a-z, A-Z),
+          #     numbers (0-9), or underscores (_), and must start with a letter or
+          #     underscore. The maximum length is 128 characters.
+          # @!attribute [rw] type
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::TableFieldSchema::Type]
+          #     Required. The field data type.
+          # @!attribute [rw] mode
+          #   @return [::Google::Cloud::Bigquery::Storage::V1::TableFieldSchema::Mode]
+          #     Optional. The field mode. The default value is NULLABLE.
+          # @!attribute [rw] fields
+          #   @return [::Array<::Google::Cloud::Bigquery::Storage::V1::TableFieldSchema>]
+          #     Optional. Describes the nested schema fields if the type property is set to STRUCT.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     Optional. The field description. The maximum length is 1,024 characters.
+          # @!attribute [rw] max_length
+          #   @return [::Integer]
+          #     Optional. Maximum length of values of this field for STRINGS or BYTES.
+          #
+          #     If max_length is not specified, no maximum length constraint is imposed
+          #     on this field.
+          #
+          #     If type = "STRING", then max_length represents the maximum UTF-8
+          #     length of strings in this field.
+          #
+          #     If type = "BYTES", then max_length represents the maximum number of
+          #     bytes in this field.
+          #
+          #     It is invalid to set this field if type is not "STRING" or "BYTES".
+          # @!attribute [rw] precision
+          #   @return [::Integer]
+          #     Optional. Precision (maximum number of total digits in base 10) and scale
+          #     (maximum number of digits in the fractional part in base 10) constraints
+          #     for values of this field for NUMERIC or BIGNUMERIC.
+          #
+          #     It is invalid to set precision or scale if type is not "NUMERIC" or
+          #     "BIGNUMERIC".
+          #
+          #     If precision and scale are not specified, no value range constraint is
+          #     imposed on this field insofar as values are permitted by the type.
+          #
+          #     Values of this NUMERIC or BIGNUMERIC field must be in this range when:
+          #
+          #     * Precision (P) and scale (S) are specified:
+          #       [-10^(P-S) + 10^(-S), 10^(P-S) - 10^(-S)]
+          #     * Precision (P) is specified but not scale (and thus scale is
+          #       interpreted to be equal to zero):
+          #       [-10^P + 1, 10^P - 1].
+          #
+          #     Acceptable values for precision and scale if both are specified:
+          #
+          #     * If type = "NUMERIC":
+          #       1 <= precision - scale <= 29 and 0 <= scale <= 9.
+          #     * If type = "BIGNUMERIC":
+          #       1 <= precision - scale <= 38 and 0 <= scale <= 38.
+          #
+          #     Acceptable values for precision if only precision is specified but not
+          #     scale (and thus scale is interpreted to be equal to zero):
+          #
+          #     * If type = "NUMERIC": 1 <= precision <= 29.
+          #     * If type = "BIGNUMERIC": 1 <= precision <= 38.
+          #
+          #     If scale is specified but not precision, then it is invalid.
+          # @!attribute [rw] scale
+          #   @return [::Integer]
+          #     Optional. See documentation for precision.
+          class TableFieldSchema
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            module Type
+              # Illegal value
+              TYPE_UNSPECIFIED = 0
+
+              # 64K, UTF8
+              STRING = 1
+
+              # 64-bit signed
+              INT64 = 2
+
+              # 64-bit IEEE floating point
+              DOUBLE = 3
+
+              # Aggregate type
+              STRUCT = 4
+
+              # 64K, Binary
+              BYTES = 5
+
+              # 2-valued
+              BOOL = 6
+
+              # 64-bit signed usec since UTC epoch
+              TIMESTAMP = 7
+
+              # Civil date - Year, Month, Day
+              DATE = 8
+
+              # Civil time - Hour, Minute, Second, Microseconds
+              TIME = 9
+
+              # Combination of civil date and civil time
+              DATETIME = 10
+
+              # Geography object
+              GEOGRAPHY = 11
+
+              # Numeric value
+              NUMERIC = 12
+
+              # BigNumeric value
+              BIGNUMERIC = 13
+
+              # Interval
+              INTERVAL = 14
+
+              # JSON, String
+              JSON = 15
+            end
+
+            module Mode
+              # Illegal value
+              MODE_UNSPECIFIED = 0
+
+              NULLABLE = 1
+
+              REQUIRED = 2
+
+              REPEATED = 3
+            end
+          end
+        end
+      end
+    end
+  end
+end