google-cloud-bigquery-storage-v1 0.2.1 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8a2fd2dae50772f81c0d7ac7f9bb91d31a53ae5de85f1446eae9b6a422451ff5
4
- data.tar.gz: 4dc33ffc503b2132fc39e8949e87cbdea6772d9338e67f3596c16846d1a25e7d
3
+ metadata.gz: 4d6b2b58b6ec1d62ff0957059dc1ecc2813d8fa60f3510ef73150f5d6c88a784
4
+ data.tar.gz: b93478fbc64e1af8a46b678bc1b69d83caa6a06464c6a0f0a57a52cef7e6bcb5
5
5
  SHA512:
6
- metadata.gz: 7413aad3b26e33f589dfbffacf104af97cda6bdc0a7518d8b4ac33735df32053fcbf1a812b93cc0b8ea300ffff94d2197823db2942faee2a466098dc328bd498
7
- data.tar.gz: b9a5ce9aebb17d83fdbdfd51f12952137c14b4cd256e354a2f8a1356fcb77ae9bde948aa1ba3fa588932de2a4a2588285f67a2ba7075b6d8b6b89d7e18f3dac3
6
+ metadata.gz: 996348195a97809a7ffca869b6480a64bf0fdb1c59ab8bfd62825ec8c28343c0a0ce000ef60a7997f4d50cef232ecb49f773bb6b57a58ead96fab68244710a3d
7
+ data.tar.gz: 0060cac7721ad246d905b1628fad4a306d9b1485c7e4c04424f46c65b41b268dd0e8e7dc0fb94a6cec2ec2e369c07dbbd03e5eadca27fc2a200861e8ccb519b7
data/README.md CHANGED
@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
18
18
 
19
19
  1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
20
20
  1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
21
+ 1. [Enable the API.](https://console.cloud.google.com/apis/library/bigquerystorage.googleapis.com)
21
22
  1. {file:AUTHENTICATION.md Set up authentication.}
22
23
 
23
24
  ## Quick Start
@@ -33,6 +34,9 @@ response = client.create_read_session request
33
34
  View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-bigquery-storage-v1/latest)
34
35
  for class and method documentation.
35
36
 
37
+ See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/storage)
38
+ for general usage information.
39
+
36
40
  ## Enabling Logging
37
41
 
38
42
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
@@ -35,3 +35,6 @@ module Google
35
35
  end
36
36
  end
37
37
  end
38
+
39
+ helper_path = ::File.join __dir__, "v1", "_helpers.rb"
40
+ require "google/cloud/bigquery/storage/v1/_helpers" if ::File.file? helper_path
@@ -73,7 +73,7 @@ module Google
73
73
  initial_delay: 0.1,
74
74
  max_delay: 60.0,
75
75
  multiplier: 1.3,
76
- retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
76
+ retry_codes: [4, 14]
77
77
  }
78
78
 
79
79
  default_config.rpcs.read_rows.timeout = 86_400.0
@@ -81,7 +81,7 @@ module Google
81
81
  initial_delay: 0.1,
82
82
  max_delay: 60.0,
83
83
  multiplier: 1.3,
84
- retry_codes: ["UNAVAILABLE"]
84
+ retry_codes: [14]
85
85
  }
86
86
 
87
87
  default_config.rpcs.split_read_stream.timeout = 600.0
@@ -89,7 +89,7 @@ module Google
89
89
  initial_delay: 0.1,
90
90
  max_delay: 60.0,
91
91
  multiplier: 1.3,
92
- retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
92
+ retry_codes: [4, 14]
93
93
  }
94
94
 
95
95
  default_config
@@ -513,7 +513,7 @@ module Google
513
513
 
514
514
  config_attr :endpoint, "bigquerystorage.googleapis.com", ::String
515
515
  config_attr :credentials, nil do |value|
516
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
516
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
517
517
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
518
518
  allowed.any? { |klass| klass === value }
519
519
  end
@@ -541,7 +541,7 @@ module Google
541
541
  def rpcs
542
542
  @rpcs ||= begin
543
543
  parent_rpcs = nil
544
- parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
544
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
545
545
  Rpcs.new parent_rpcs
546
546
  end
547
547
  end
@@ -553,7 +553,7 @@ module Google
553
553
  # Each configuration object is of type `Gapic::Config::Method` and includes
554
554
  # the following configuration fields:
555
555
  #
556
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
556
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
557
557
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
558
558
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
559
559
  # include the following keys:
@@ -56,7 +56,7 @@ module Google
56
56
  #
57
57
  # Read sessions automatically expire 24 hours after they are created and do
58
58
  # not require manual clean-up by the caller.
59
- rpc :CreateReadSession, CreateReadSessionRequest, ReadSession
59
+ rpc :CreateReadSession, ::Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest, ::Google::Cloud::Bigquery::Storage::V1::ReadSession
60
60
  # Reads rows from the stream in the format prescribed by the ReadSession.
61
61
  # Each response contains one or more table rows, up to a maximum of 100 MiB
62
62
  # per response; read requests which attempt to read individual rows larger
@@ -64,7 +64,7 @@ module Google
64
64
  #
65
65
  # Each request also returns a set of stream statistics reflecting the current
66
66
  # state of the stream.
67
- rpc :ReadRows, ReadRowsRequest, stream(ReadRowsResponse)
67
+ rpc :ReadRows, ::Google::Cloud::Bigquery::Storage::V1::ReadRowsRequest, stream(::Google::Cloud::Bigquery::Storage::V1::ReadRowsResponse)
68
68
  # Splits a given `ReadStream` into two `ReadStream` objects. These
69
69
  # `ReadStream` objects are referred to as the primary and the residual
70
70
  # streams of the split. The original `ReadStream` can still be read from in
@@ -77,7 +77,7 @@ module Google
77
77
  # original, primary, and residual, that original[0-j] = primary[0-j] and
78
78
  # original[j-n] = residual[0-m] once the streams have been read to
79
79
  # completion.
80
- rpc :SplitReadStream, SplitReadStreamRequest, SplitReadStreamResponse
80
+ rpc :SplitReadStream, ::Google::Cloud::Bigquery::Storage::V1::SplitReadStreamRequest, ::Google::Cloud::Bigquery::Storage::V1::SplitReadStreamResponse
81
81
  end
82
82
 
83
83
  Stub = Service.rpc_stub_class
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Storage
24
24
  module V1
25
- VERSION = "0.2.1"
25
+ VERSION = "0.2.6"
26
26
  end
27
27
  end
28
28
  end
@@ -43,12 +43,12 @@ module Google
43
43
  #
44
44
  # The ResourceDescriptor Yaml config will look like:
45
45
  #
46
- # resources:
47
- # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/\\{project}/topics/\\{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/\\{project}"
46
+ # resources:
47
+ # - type: "pubsub.googleapis.com/Topic"
48
+ # name_descriptor:
49
+ # - pattern: "projects/{project}/topics/{topic}"
50
+ # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
+ # parent_name_extractor: "projects/{project}"
52
52
  #
53
53
  # Sometimes, resources have multiple patterns, typically because they can
54
54
  # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
183
183
  # }
184
184
  # @!attribute [rw] plural
185
185
  # @return [::String]
186
- # The plural name used in the resource name, such as 'projects' for
187
- # the name of 'projects/\\{project}'. It is the same concept of the `plural`
188
- # field in k8s CRD spec
186
+ # The plural name used in the resource name and permission names, such as
187
+ # 'projects' for the resource name of 'projects/\\{project}' and the permission
188
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
189
+ # concept of the `plural` field in k8s CRD spec
189
190
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
191
+ #
192
+ # Note: The plural form is required even for singleton resources. See
193
+ # https://aip.dev/156
190
194
  # @!attribute [rw] singular
191
195
  # @return [::String]
192
196
  # The same concept of the `singular` field in k8s CRD spec
193
197
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
194
198
  # Such as "project" for the `resourcemanager.googleapis.com/Project` type.
199
+ # @!attribute [rw] style
200
+ # @return [::Array<::Google::Api::ResourceDescriptor::Style>]
201
+ # Style flag(s) for this resource.
202
+ # These indicate that a resource is expected to conform to a given
203
+ # style. See the specific style flags for additional information.
195
204
  class ResourceDescriptor
196
205
  include ::Google::Protobuf::MessageExts
197
206
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
211
220
  # that from being necessary once there are multiple patterns.)
212
221
  FUTURE_MULTI_PATTERN = 2
213
222
  end
223
+
224
+ # A flag representing a specific style that a resource claims to conform to.
225
+ module Style
226
+ # The unspecified value. Do not use.
227
+ STYLE_UNSPECIFIED = 0
228
+
229
+ # This resource is intended to be "declarative-friendly".
230
+ #
231
+ # Declarative-friendly resources must be more strictly consistent, and
232
+ # setting this to true communicates to tools that this resource should
233
+ # adhere to declarative-friendly expectations.
234
+ #
235
+ # Note: This is used by the API linter (linter.aip.dev) to enable
236
+ # additional checks.
237
+ DECLARATIVE_FRIENDLY = 1
238
+ end
214
239
  end
215
240
 
216
241
  # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
226
251
  # type: "pubsub.googleapis.com/Topic"
227
252
  # }];
228
253
  # }
254
+ #
255
+ # Occasionally, a field may reference an arbitrary resource. In this case,
256
+ # APIs use the special value * in their resource reference.
257
+ #
258
+ # Example:
259
+ #
260
+ # message GetIamPolicyRequest {
261
+ # string resource = 2 [(google.api.resource_reference) = {
262
+ # type: "*"
263
+ # }];
264
+ # }
229
265
  # @!attribute [rw] child_type
230
266
  # @return [::String]
231
267
  # The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
234
270
  #
235
271
  # Example:
236
272
  #
237
- # message ListLogEntriesRequest {
238
- # string parent = 1 [(google.api.resource_reference) = {
239
- # child_type: "logging.googleapis.com/LogEntry"
240
- # };
241
- # }
273
+ # message ListLogEntriesRequest {
274
+ # string parent = 1 [(google.api.resource_reference) = {
275
+ # child_type: "logging.googleapis.com/LogEntry"
276
+ # };
277
+ # }
242
278
  class ResourceReference
243
279
  include ::Google::Protobuf::MessageExts
244
280
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-storage-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.1
4
+ version: 0.2.6
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-05-26 00:00:00.000000000 Z
11
+ date: 2021-01-20 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '0.2'
19
+ version: '0.3'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '0.2'
26
+ version: '0.3'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: google-cloud-errors
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -199,7 +199,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
199
199
  - !ruby/object:Gem::Version
200
200
  version: '0'
201
201
  requirements: []
202
- rubygems_version: 3.0.6
202
+ rubygems_version: 3.2.6
203
203
  signing_key:
204
204
  specification_version: 4
205
205
  summary: API Client library for the BigQuery Storage V1 API