google-cloud-bigquery-storage-v1 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3798a072676c62908039d13ce88cbc15c3a12f46c4d488837d2d4bac64091fa
-  data.tar.gz: 7dbccdae836e087be63b5a4291c94b45af21ef026893b6ecd5935df2ee5c7577
+  metadata.gz: 703332e4ce288caa3087714d2396c597a59be06c8419d4d4ebb181128eb7e699
+  data.tar.gz: 52241ca1467778c2ebbe3bd278093a5bc0421cf540aa1f3efdc57b48b9b7073a
 SHA512:
-  metadata.gz: 6f8775594ee0f4a9990d97b3437107e7392326e0230cea5695bdc3837f4c422d227659a3f6ae999c43e23e635faf8189195fc42930cf331918618e7d65924ee7
-  data.tar.gz: e1c115f3b2758f26e80dfe4179d32bc77211f8666058816275a4d8b91ed64c4089335a4224a52025ca3b292b3ca59a27701b982429b4bb33faca0e3857f5e1c4
+  metadata.gz: eff8e669467b02d0cc0e1bf2871728890becb60548b7ce3e8c055130a58e703c412578f5a8d1fa769f0995ed00efa4fd25a4c2e8baa99ac0fbaf77b425360436
+  data.tar.gz: 1acc21d67a2ee9cb1bbc481c0ed85768a5ec42eec2bb31587373089e102f88df914a5e0d7cd15b010ebc79208de2ac596e65bbd556c02a064c1b1f33469df4c9

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

@@ -82,22 +82,22 @@ module Google
 
                   default_config.rpcs.get_write_stream.timeout = 600.0
                   default_config.rpcs.get_write_stream.retry_policy = {
-                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14, 8]
                   }
 
                   default_config.rpcs.finalize_write_stream.timeout = 600.0
                   default_config.rpcs.finalize_write_stream.retry_policy = {
-                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14, 8]
                   }
 
                   default_config.rpcs.batch_commit_write_streams.timeout = 600.0
                   default_config.rpcs.batch_commit_write_streams.retry_policy = {
-                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14, 8]
                   }
 
                   default_config.rpcs.flush_rows.timeout = 600.0
                   default_config.rpcs.flush_rows.retry_policy = {
-                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14, 8]
                   }
 
                   default_config

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

@@ -22,7 +22,7 @@ module Google
     module Bigquery
       module Storage
         module V1
-          VERSION = "0.20.0"
+          VERSION = "0.21.0"
         end
       end
     end

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

@@ -190,18 +190,23 @@ module Google
 
           # 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.
+          # Because AppendRows is a bidirectional streaming RPC, certain parts of the
+          # AppendRowsRequest need only be specified for the first request before
+          # switching table destinations. You can also switch table destinations within
+          # the same connection for the default stream.
           #
           # 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 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.
+          #     Required. The write_stream identifies the append operation. It must be
+          #     provided in the following scenarios:
+          #
+          #     * In the first request to an AppendRows connection.
+          #
+          #     * In all subsequent requests to an AppendRows connection, if you use the
+          #     same connection to write to multiple tables or change the input schema for
+          #     default streams.
           #
           #     For explicitly created write streams, the format is:
           #
@@ -210,6 +215,22 @@ module Google
           #     For the special default stream, the format is:
           #
           #     * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`.
+          #
+          #     An example of a possible sequence of requests with write_stream fields
+          #     within a single connection:
+          #
+          #     * r1: \\{write_stream: stream_name_1}
+          #
+          #     * r2: \\{write_stream: /*omit*/}
+          #
+          #     * r3: \\{write_stream: /*omit*/}
+          #
+          #     * r4: \\{write_stream: stream_name_2}
+          #
+          #     * r5: \\{write_stream: stream_name_2}
+          #
+          #     The destination changed in request_4, so the write_stream field must be
+          #     populated in all subsequent requests in this stream.
           # @!attribute [rw] offset
           #   @return [::Google::Protobuf::Int64Value]
           #     If present, the write is only performed if the next append offset is same
@@ -251,9 +272,14 @@ module Google
             # 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.
+            #     The protocol buffer schema used to serialize the data. Provide this value
+            #     whenever:
+            #
+            #     * You send the first request of an RPC connection.
+            #
+            #     * You change the input schema.
+            #
+            #     * You specify a new destination table.
             # @!attribute [rw] rows
             #   @return [::Google::Cloud::Bigquery::Storage::V1::ProtoRows]
             #     Serialized row data in protobuf message format.
@@ -274,10 +300,9 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # An enum to indicate how to interpret missing values. Missing values are
-            # fields present in user schema but missing in rows. A missing value can
-            # represent a NULL or a column default value defined in BigQuery table
-            # schema.
+            # An enum to indicate how to interpret missing values of fields that are
+            # present in user schema but missing in rows. A missing value can represent a
+            # NULL or a column default value defined in BigQuery table schema.
             module MissingValueInterpretation
               # Invalid missing value interpretation. Requests with this value will be
               # rejected.

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

@@ -69,10 +69,10 @@ module Google
           #     metadata from the table which might be incomplete or stale.
           # @!attribute [r] estimated_total_physical_file_size
           #   @return [::Integer]
-          #     Output only. A pre-projected estimate of the total physical size (in bytes)
-          #     of files this session will scan when all streams are completely consumed.
-          #     This estimate does not depend on the selected columns and can be based on
-          #     metadata from the table which might be incomplete or stale. Only set for
+          #     Output only. A pre-projected estimate of the total physical size of files
+          #     (in bytes) that this session will scan when all streams are consumed. This
+          #     estimate is independent of the selected columns and can be based on
+          #     incomplete or stale metadata from the table.  This field is only set for
           #     BigLake tables.
           # @!attribute [r] estimated_row_count
           #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-storage-v1
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-23 00:00:00.000000000 Z
+date: 2023-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common