google-cloud-bigquery-storage-v1 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97e012ed12b5d17636615b23153be73fd4006ccc47ba0955a722139b09c2f53d
-  data.tar.gz: c2dd5d3b6a99d21fe96e99c2348e578307fbe67c5cd21c829385fdfa89e372df
+  metadata.gz: 3bf502ff137eb32c42f1c3886398c54f31ff15dfa6666c6286632b0235776574
+  data.tar.gz: 830ffcd051c2ca5934baf1f71c8686294b0f11a7a58a71393f95bf13ed7a4190
 SHA512:
-  metadata.gz: 40865f1fe1a363798ce1a66aa55f10b450ce09e9aaa6768b0d7c5723901face80a5cec1a4fd09e742e2b8a51f2638fd94bcdb25f650e65758f46612e14ea9fcc
-  data.tar.gz: 9d151f5e6c122112eafca91af8c33d21c01ce03d10895fddca917318300df57c00f2a9c86f9260a10ad5fb37ae02542c3e48d5e73681f1435b59b97b403c247e
+  metadata.gz: 8747321713667c4a27420608af7b15dd230f58b0aa63b158973713dfe8a9db5c54232ea2c19e530c62421602366077c22bdaaf50fe612267c43bbc374de8533d
+  data.tar.gz: ec6716922908c2053bfd2405880ecac28a7c4486f6d93b9def7260031e087d95aa6772d32e073864c1ae10d9acc412052f7565d51d098548496ede14ad5b3ddc

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

@@ -193,7 +193,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
               #
-              # @overload create_read_session(parent: nil, read_session: nil, max_stream_count: nil)
+              # @overload create_read_session(parent: nil, read_session: nil, max_stream_count: nil, preferred_min_stream_count: nil)
               #   Pass arguments to `create_read_session` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -214,6 +214,15 @@ module Google
               #     Typically, clients should either leave this unset to let the system to
               #     determine an upper bound OR set this a size for the maximum "units of work"
               #     it can gracefully handle.
+              #   @param preferred_min_stream_count [::Integer]
+              #     The minimum preferred stream count. This parameter can be used to inform
+              #     the service that there is a desired lower bound on the number of streams.
+              #     This is typically a target parallelism of the client (e.g. a Spark
+              #     cluster with N-workers would set this to a low multiple of N to ensure
+              #     good cluster utilization).
+              #
+              #     The system will make a best effort to provide at least this number of
+              #     streams, but in some cases might provide less.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Cloud::Bigquery::Storage::V1::ReadSession]

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

@@ -22,6 +22,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :read_session, :message, 2, "google.cloud.bigquery.storage.v1.ReadSession"
       optional :max_stream_count, :int32, 3
+      optional :preferred_min_stream_count, :int32, 4
     end
     add_message "google.cloud.bigquery.storage.v1.ReadRowsRequest" do
       optional :read_stream, :string, 1
@@ -77,6 +78,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.bigquery.storage.v1.AppendRowsResponse" do
       optional :updated_schema, :message, 3, "google.cloud.bigquery.storage.v1.TableSchema"
       repeated :row_errors, :message, 4, "google.cloud.bigquery.storage.v1.RowError"
+      optional :write_stream, :string, 5
       oneof :response do
         optional :append_result, :message, 1, "google.cloud.bigquery.storage.v1.AppendRowsResponse.AppendResult"
         optional :error, :message, 2, "google.rpc.Status"

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

@@ -22,7 +22,7 @@ module Google
     module Bigquery
       module Storage
         module V1
-          VERSION = "0.12.0"
+          VERSION = "0.13.0"
         end
       end
     end

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

@@ -42,6 +42,16 @@ module Google
           #     Typically, clients should either leave this unset to let the system to
           #     determine an upper bound OR set this a size for the maximum "units of work"
           #     it can gracefully handle.
+          # @!attribute [rw] preferred_min_stream_count
+          #   @return [::Integer]
+          #     The minimum preferred stream count. This parameter can be used to inform
+          #     the service that there is a desired lower bound on the number of streams.
+          #     This is typically a target parallelism of the client (e.g. a Spark
+          #     cluster with N-workers would set this to a low multiple of N to ensure
+          #     good cluster utilization).
+          #
+          #     The system will make a best effort to provide at least this number of
+          #     streams, but in some cases might provide less.
           class CreateReadSessionRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -183,6 +193,9 @@ module Google
           # 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.
+          #
+          # The size of a single AppendRowsRequest must be less than 10 MB in size.
+          # Requests larger than this return an error, typically `INVALID_ARGUMENT`.
           # @!attribute [rw] write_stream
           #   @return [::String]
           #     Required. The write_stream identifies the target of the append operation, and only
@@ -269,6 +282,10 @@ module Google
           #     If a request failed due to corrupted rows, no rows in the batch will be
           #     appended. The API will return row level error info, so that the caller can
           #     remove the bad rows and retry the request.
+          # @!attribute [rw] write_stream
+          #   @return [::String]
+          #     The target of the append operation. Matches the write_stream in the
+          #     corresponding request.
           class AppendRowsResponse
             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.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-01 00:00:00.000000000 Z
+date: 2022-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common