google-cloud-bigquery-storage-v1 0.1.0

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

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+          # Information about the ReadSession.
+          # @!attribute [r] name
+          #   @return [String]
+          #     Output only. Unique identifier for the session, in the form
+          #     `projects/{project_id}/locations/{location}/sessions/{session_id}`.
+          # @!attribute [r] expire_time
+          #   @return [Google::Protobuf::Timestamp]
+          #     Output only. Time at which the session becomes invalid. After this time, subsequent
+          #     requests to read this Session will return errors. The expire_time is
+          #     automatically assigned and currently cannot be specified or updated.
+          # @!attribute [rw] data_format
+          #   @return [Google::Cloud::Bigquery::Storage::V1::DataFormat]
+          #     Immutable. Data format of the output data.
+          # @!attribute [r] avro_schema
+          #   @return [Google::Cloud::Bigquery::Storage::V1::AvroSchema]
+          #     Output only. Avro schema.
+          # @!attribute [r] arrow_schema
+          #   @return [Google::Cloud::Bigquery::Storage::V1::ArrowSchema]
+          #     Output only. Arrow schema.
+          # @!attribute [rw] table
+          #   @return [String]
+          #     Immutable. Table that this ReadSession is reading from, in the form
+          #     `projects/{project_id}/datasets/{dataset_id}/tables/{table_id}`
+          # @!attribute [rw] table_modifiers
+          #   @return [Google::Cloud::Bigquery::Storage::V1::ReadSession::TableModifiers]
+          #     Optional. Any modifiers which are applied when reading from the specified table.
+          # @!attribute [rw] read_options
+          #   @return [Google::Cloud::Bigquery::Storage::V1::ReadSession::TableReadOptions]
+          #     Optional. Read options for this session (e.g. column selection, filters).
+          # @!attribute [r] streams
+          #   @return [Array<Google::Cloud::Bigquery::Storage::V1::ReadStream>]
+          #     Output only. A list of streams created with the session.
+          #
+          #     At least one stream is created with the session. In the future, larger
+          #     request_stream_count values *may* result in this list being unpopulated,
+          #     in that case, the user will need to use a List method to get the streams
+          #     instead, which is not yet available.
+          class ReadSession
+            include Google::Protobuf::MessageExts
+            extend Google::Protobuf::MessageExts::ClassMethods
+
+            # Additional attributes when reading a table.
+            # @!attribute [rw] snapshot_time
+            #   @return [Google::Protobuf::Timestamp]
+            #     The snapshot time of the table. If not set, interpreted as now.
+            class TableModifiers
+              include Google::Protobuf::MessageExts
+              extend Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Options dictating how we read a table.
+            # @!attribute [rw] selected_fields
+            #   @return [Array<String>]
+            #     Names of the fields in the table that should be read. If empty, all
+            #     fields will be read. If the specified field is a nested field, all
+            #     the sub-fields in the field will be selected. The output field order is
+            #     unrelated to the order of fields in selected_fields.
+            # @!attribute [rw] row_restriction
+            #   @return [String]
+            #     SQL text filtering statement, similar to a WHERE clause in a query.
+            #     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"
+            class TableReadOptions
+              include Google::Protobuf::MessageExts
+              extend Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Information about a single stream that gets data out of the storage system.
+          # Most of the information about `ReadStream` instances is aggregated, making
+          # `ReadStream` lightweight.
+          # @!attribute [r] name
+          #   @return [String]
+          #     Output only. Name of the stream, in the form
+          #     `projects/{project_id}/locations/{location}/sessions/{session_id}/streams/{stream_id}`.
+          class ReadStream
+            include Google::Protobuf::MessageExts
+            extend Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Data format for input or output data.
+          module DataFormat
+            DATA_FORMAT_UNSPECIFIED = 0
+
+            # Avro is a standard open source row based file format.
+            # See https://avro.apache.org/ for more details.
+            AVRO = 1
+
+            # Arrow is a standard open source column-based message format.
+            # See https://arrow.apache.org/ for more details.
+            ARROW = 2
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/protobuf/timestamp.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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 Protobuf
+    # A Timestamp represents a point in time independent of any time zone
+    # or calendar, represented as seconds and fractions of seconds at
+    # nanosecond resolution in UTC Epoch time. It is encoded using the
+    # Proleptic Gregorian Calendar which extends the Gregorian calendar
+    # backwards to year one. It is encoded assuming all minutes are 60
+    # seconds long, i.e. leap seconds are "smeared" so that no leap second
+    # table is needed for interpretation. Range is from
+    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
+    # By restricting to that range, we ensure that we can convert to
+    # and from  RFC 3339 date strings.
+    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    #
+    # # Examples
+    #
+    # Example 1: Compute Timestamp from POSIX `time()`.
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(time(NULL));
+    #     timestamp.set_nanos(0);
+    #
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
+    #
+    #     struct timeval tv;
+    #     gettimeofday(&tv, NULL);
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(tv.tv_sec);
+    #     timestamp.set_nanos(tv.tv_usec * 1000);
+    #
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
+    #
+    #     FILETIME ft;
+    #     GetSystemTimeAsFileTime(&ft);
+    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+    #
+    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+    #
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
+    #
+    #     long millis = System.currentTimeMillis();
+    #
+    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
+    #
+    #
+    # Example 5: Compute Timestamp from current time in Python.
+    #
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
+    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
+    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # ) to obtain a formatter capable of generating timestamps in this format.
+    # @!attribute [rw] seconds
+    #   @return [Integer]
+    #     Represents seconds of UTC time since Unix epoch
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+    #     9999-12-31T23:59:59Z inclusive.
+    # @!attribute [rw] nanos
+    #   @return [Integer]
+    #     Non-negative fractions of a second at nanosecond resolution. Negative
+    #     second values with fractions must still have non-negative nanos values
+    #     that count forward in time. Must be from 0 to 999,999,999
+    #     inclusive.
+    class Timestamp
+      include Google::Protobuf::MessageExts
+      extend Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: google-cloud-bigquery-storage-v1
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Google LLC
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gapic-common
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: google-cloud-errors
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: google-style
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.24.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.24.0
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: The BigQuery Storage API provides fast access to BigQuery managed storage.
+email: googleapis-packages@google.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".yardopts"
+- AUTHENTICATION.md
+- LICENSE.md
+- README.md
+- lib/google-cloud-bigquery-storage-v1.rb
+- lib/google/cloud/bigquery/storage/v1.rb
+- lib/google/cloud/bigquery/storage/v1/arrow_pb.rb
+- lib/google/cloud/bigquery/storage/v1/avro_pb.rb
+- lib/google/cloud/bigquery/storage/v1/big_query_read.rb
+- lib/google/cloud/bigquery/storage/v1/big_query_read/client.rb
+- lib/google/cloud/bigquery/storage/v1/big_query_read/credentials.rb
+- lib/google/cloud/bigquery/storage/v1/big_query_read/paths.rb
+- lib/google/cloud/bigquery/storage/v1/storage_pb.rb
+- lib/google/cloud/bigquery/storage/v1/storage_services_pb.rb
+- lib/google/cloud/bigquery/storage/v1/stream_pb.rb
+- lib/google/cloud/bigquery/storage/v1/version.rb
+- lib/google/cloud/common_resources_pb.rb
+- proto_docs/README.md
+- proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/resource.rb
+- proto_docs/google/cloud/bigquery/storage/v1/arrow.rb
+- proto_docs/google/cloud/bigquery/storage/v1/avro.rb
+- proto_docs/google/cloud/bigquery/storage/v1/storage.rb
+- proto_docs/google/cloud/bigquery/storage/v1/stream.rb
+- proto_docs/google/protobuf/timestamp.rb
+homepage: https://github.com/googleapis/google-cloud-ruby
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: API Client library for the BigQuery Storage V1 API
+test_files: []