google-cloud-bigquery-storage 1.1.0 → 1.2.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 99fa16fbfd8f2777f53291386ef2c22ad0131bbfc5fa2b72a85f05ab4ff29c0b
4
- data.tar.gz: 29019cfd53d836cb2edebc340cd89dca447084a7d06b209469c0ae387e6ba9b1
3
+ metadata.gz: 0d5e0bad9012092ec8c9694dab238e3f7319ee54661a69644d3c941cb74bb81a
4
+ data.tar.gz: 7ffdc5ac2b9b80771bfa97feabe48495ec8c45cf337beb38bae10d43b56e7658
5
5
  SHA512:
6
- metadata.gz: 4edc5b6b842f07c36a7504461e62d8e3363df45f4a24ab5201d056ed880f5d5c774d39a058a9e1b8a9179b41c7be7c3d3f46acbc6004014f551aa381b6fcc2e6
7
- data.tar.gz: b864344418dd1fcb562ef15da832e15f38704d6fb6600599b8fe64a6571136b1ce5f46041b4cb19e68eb65ec956d9bb39f31e4cd6bfddb5eea953422dd348738
6
+ metadata.gz: f9db24c78a24cb3362aef33ed44f95ba8ee8339c586ae7b29e94eadbc807d994a4089deefaa4d8fa80cd8e0f0daf055492744fa8c8c6b617031f6f6c97681e4a
7
+ data.tar.gz: 9fd77e3f6459d27d351fc8b8e5f089466e3156f716fe94078315399c13c75a844da2f6bb19abe823b09cfb61017687c4655a962dda0dcf1f95823c5025232de0
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=BigQuery Storage API
2
+ --title="BigQuery Storage API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-bigquery-storage
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  `::Google::Cloud::Bigquery::Storage::V1::BigQueryRead::Credentials`):
68
68
 
69
- 1. `BIGQUERY_STORAGE_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `BIGQUERY_STORAGE_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `BIGQUERY_STORAGE_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `BIGQUERY_STORAGE_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/bigquery/storage"
@@ -82,8 +82,8 @@ client = Google::Cloud::Bigquery::Storage.big_query_read
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/bigquery/storage"
@@ -93,7 +93,7 @@ client = Google::Cloud::Bigquery::Storage.big_query_read do |config|
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/bigquery/storage"
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Bigquery
23
23
  module Storage
24
- VERSION = "1.1.0"
24
+ VERSION = "1.2.1"
25
25
  end
26
26
  end
27
27
  end
@@ -77,6 +77,41 @@ module Google
77
77
  package_module.const_get(:BigQueryRead).const_get(:Client).new(&block)
78
78
  end
79
79
 
80
+ ##
81
+ # Create a new client object for BigQueryWrite.
82
+ #
83
+ # By default, this returns an instance of
84
+ # [Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client](https://googleapis.dev/ruby/google-cloud-bigquery-storage-v1/latest/Google/Cloud/Bigquery/Storage/V1/BigQueryWrite/Client.html)
85
+ # for version V1 of the API.
86
+ # However, you can specify specify a different API version by passing it in the
87
+ # `version` parameter. If the BigQueryWrite service is
88
+ # supported by that API version, and the corresponding gem is available, the
89
+ # appropriate versioned client will be returned.
90
+ #
91
+ # ## About BigQueryWrite
92
+ #
93
+ # BigQuery Write API.
94
+ #
95
+ # The Write API can be used to write data to BigQuery.
96
+ #
97
+ # For supplementary information about the Write API, see:
98
+ # https://cloud.google.com/bigquery/docs/write-api
99
+ #
100
+ # @param version [::String, ::Symbol] The API version to connect to. Optional.
101
+ # Defaults to `:v1`.
102
+ # @return [BigQueryWrite::Client] A client object for the specified version.
103
+ #
104
+ def self.big_query_write version: :v1, &block
105
+ require "google/cloud/bigquery/storage/#{version.to_s.downcase}"
106
+
107
+ package_name = Google::Cloud::Bigquery::Storage
108
+ .constants
109
+ .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
110
+ .first
111
+ package_module = Google::Cloud::Bigquery::Storage.const_get package_name
112
+ package_module.const_get(:BigQueryWrite).const_get(:Client).new(&block)
113
+ end
114
+
80
115
  ##
81
116
  # Configure the google-cloud-bigquery-storage library.
82
117
  #
metadata CHANGED
@@ -1,43 +1,49 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-storage
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-03-09 00:00:00.000000000 Z
11
+ date: 2022-01-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-bigquery-storage-v1
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - "~>"
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0.8'
20
+ - - "<"
18
21
  - !ruby/object:Gem::Version
19
- version: '0.0'
22
+ version: 2.a
20
23
  type: :runtime
21
24
  prerelease: false
22
25
  version_requirements: !ruby/object:Gem::Requirement
23
26
  requirements:
24
- - - "~>"
27
+ - - ">="
28
+ - !ruby/object:Gem::Version
29
+ version: '0.8'
30
+ - - "<"
25
31
  - !ruby/object:Gem::Version
26
- version: '0.0'
32
+ version: 2.a
27
33
  - !ruby/object:Gem::Dependency
28
34
  name: google-cloud-core
29
35
  requirement: !ruby/object:Gem::Requirement
30
36
  requirements:
31
37
  - - "~>"
32
38
  - !ruby/object:Gem::Version
33
- version: '1.5'
39
+ version: '1.6'
34
40
  type: :runtime
35
41
  prerelease: false
36
42
  version_requirements: !ruby/object:Gem::Requirement
37
43
  requirements:
38
44
  - - "~>"
39
45
  - !ruby/object:Gem::Version
40
- version: '1.5'
46
+ version: '1.6'
41
47
  - !ruby/object:Gem::Dependency
42
48
  name: google-style
43
49
  requirement: !ruby/object:Gem::Requirement
@@ -182,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
182
188
  - !ruby/object:Gem::Version
183
189
  version: '0'
184
190
  requirements: []
185
- rubygems_version: 3.2.13
191
+ rubygems_version: 3.3.4
186
192
  signing_key:
187
193
  specification_version: 4
188
194
  summary: API Client library for the BigQuery Storage API