google-cloud-bigquery-storage-v1 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3321ce1006bfab7c7513dedf48c006e0f30a930a0b2bc5e1ae9dfe775dd276d4
-  data.tar.gz: dc10dc964e656decaa880405ec57ce0aa2c61edef92cf29f897b252d8a1ba815
+  metadata.gz: 3a95d34616ffc1455f203b27be3825854e709526a5cfe3e4c72db03faa5351b2
+  data.tar.gz: 8af44f131742eaf8ce8f843d85509b7f89edfd5e4098a85770e78a537d1ab13a
 SHA512:
-  metadata.gz: fa4151bc016d5daea090d012dc307b73dc05dd4006c760b42e330ec0267c075dbc2aaefc989ad1dda861e967c94b1eafa38fc2fe62fb50f54ae8d2dd74cb5b60
-  data.tar.gz: ee14302ce6f9129d58897a79ac7e5d1eb6c13dd3a21c9d5e2edfbd062122653b2bdc4ac4d93b3ea23b0467b0e77c60658fffd16279b3000c9a6d57b6c8bbad69
+  metadata.gz: 77d2465381c89df36bfebfb685ff9ba73f7f7f099c61996277e44d8ed37b0f922f11cebfd52cf6e143923d0935d39f62a24d0e473718faa27c8c0d489e1955ff
+  data.tar.gz: fe39b9210c5843f6e3ad6fc5f5aaa068139dff0f941681b0b0003defdd566a13ac773fb0e66e7fbfa351acbec535a0d65a2904f0ba29e87ff7a59fde9fdf87b4

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=BigQuery Storage V1 API
+--title="BigQuery Storage V1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest.new #
 response = client.create_read_session request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-bigquery-storage-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-bigquery-storage-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/storage)

data/lib/google/cloud/bigquery/storage/v1/big_query_read/credentials.rb

@@ -28,7 +28,6 @@ module Google
             class Credentials < ::Google::Auth::Credentials
               self.scope = [
                 "https://www.googleapis.com/auth/bigquery",
-                "https://www.googleapis.com/auth/bigquery.readonly",
                 "https://www.googleapis.com/auth/cloud-platform"
               ]
               self.env_vars = [

data/lib/google/cloud/bigquery/storage/v1/big_query_write/client.rb

@@ -306,6 +306,13 @@ module Google
               # finalized (via the `FinalizeWriteStream` rpc), and the stream is explicitly
               # committed via the `BatchCommitWriteStreams` rpc.
               #
+              # Note: For users coding against the gRPC api directly, it may be
+              # necessary to supply the x-goog-request-params system parameter
+              # with `write_stream=<full_write_stream_name>`.
+              #
+              # More information about system parameters:
+              # https://cloud.google.com/apis/docs/system-parameters
+              #
               # @param request [::Gapic::StreamInput, ::Enumerable<::Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest, ::Hash>]
               #   An enumerable of {::Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest} instances.
               # @param options [::Gapic::CallOptions, ::Hash]

data/lib/google/cloud/bigquery/storage/v1/storage_pb.rb

@@ -121,6 +121,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :INVALID_STREAM_STATE, 5
       value :STREAM_FINALIZED, 6
       value :SCHEMA_MISMATCH_EXTRA_FIELDS, 7
+      value :OFFSET_ALREADY_EXISTS, 8
+      value :OFFSET_OUT_OF_RANGE, 9
     end
   end
 end

data/lib/google/cloud/bigquery/storage/v1/storage_services_pb.rb

@@ -134,6 +134,13 @@ module Google
               # * For PENDING streams, data is not made visible until the stream itself is
               # finalized (via the `FinalizeWriteStream` rpc), and the stream is explicitly
               # committed via the `BatchCommitWriteStreams` rpc.
+              #
+              # Note: For users coding against the gRPC api directly, it may be
+              # necessary to supply the x-goog-request-params system parameter
+              # with `write_stream=<full_write_stream_name>`.
+              #
+              # More information about system parameters:
+              # https://cloud.google.com/apis/docs/system-parameters
               rpc :AppendRows, stream(::Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest), stream(::Google::Cloud::Bigquery::Storage::V1::AppendRowsResponse)
               # Gets information about a write stream.
               rpc :GetWriteStream, ::Google::Cloud::Bigquery::Storage::V1::GetWriteStreamRequest, ::Google::Cloud::Bigquery::Storage::V1::WriteStream

data/lib/google/cloud/bigquery/storage/v1/stream_pb.rb

@@ -20,6 +20,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :read_options, :message, 8, "google.cloud.bigquery.storage.v1.ReadSession.TableReadOptions"
       repeated :streams, :message, 10, "google.cloud.bigquery.storage.v1.ReadStream"
       optional :estimated_total_bytes_scanned, :int64, 12
+      optional :trace_id, :string, 13
       oneof :schema do
         optional :avro_schema, :message, 4, "google.cloud.bigquery.storage.v1.AvroSchema"
         optional :arrow_schema, :message, 5, "google.cloud.bigquery.storage.v1.ArrowSchema"

data/lib/google/cloud/bigquery/storage/v1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Bigquery
       module Storage
         module V1
-          VERSION = "0.9.0"
+          VERSION = "0.10.0"
         end
       end
     end

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

@@ -27,6 +27,8 @@ module Google
         ##
         # To load this package, including all its services, and instantiate a client:
         #
+        # @example
+        #
         #     require "google/cloud/bigquery/storage/v1"
         #     client = ::Google::Cloud::Bigquery::Storage::V1::BigQueryRead::Client.new
         #

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/storage.rb

@@ -189,10 +189,12 @@ module Google
           #     request.
           #
           #     For explicitly created write streams, the format is:
-          #     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`
+          #
+          #     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`
           #
           #     For the special default stream, the format is:
-          #     `projects/{project}/datasets/{dataset}/tables/{table}/_default`.
+          #
+          #     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`.
           # @!attribute [rw] offset
           #   @return [::Google::Protobuf::Int64Value]
           #     If present, the write is only performed if the next append offset is same
@@ -403,6 +405,12 @@ module Google
               # There is a schema mismatch and it is caused by user schema has extra
               # field than bigquery schema.
               SCHEMA_MISMATCH_EXTRA_FIELDS = 7
+
+              # Offset already exists.
+              OFFSET_ALREADY_EXISTS = 8
+
+              # Offset out of range.
+              OFFSET_OUT_OF_RANGE = 9
             end
           end
         end

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

@@ -64,6 +64,14 @@ module Google
           #     Output only. An estimate on the number of bytes this session will scan when
           #     all streams are completely consumed. This estimate is based on
           #     metadata from the table which might be incomplete or stale.
+          # @!attribute [rw] trace_id
+          #   @return [::String]
+          #     Optional. ID set by client to annotate a session identity.  This does not need
+          #     to be strictly unique, but instead the same ID should be used to group
+          #     logically connected sessions (e.g. All using the same ID for all sessions
+          #     needed to complete a Spark SQL query is reasonable).
+          #
+          #     Maximum length is 256 bytes.
           class ReadSession
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-storage-v1
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-08 00:00:00.000000000 Z
+date: 2022-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -219,7 +219,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the BigQuery Storage V1 API