google-cloud-bigquery-connection-v1 0.4.1 → 0.5.2

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: 35ac1c58ba4cf27b0e7a617cfcf5c391530d079d4514ab60127cc6a17965fd22
4
- data.tar.gz: 076261722eecafda60ceeba0b90164bd11366d5447af88d7770491606ca7fadb
3
+ metadata.gz: 487013f3885e23811eafe2566bf728c5519b2158f0e32a2b768e0dd567bbff82
4
+ data.tar.gz: 94782071919c707deba4f918dce7dedc887576a93bfae9bc896d5e8f331a44ce
5
5
  SHA512:
6
- metadata.gz: 206bd159f8ee1e1d9203abbece2de348a847bdb2c5757d4d257fc6358dbb556f99dc140c27e8218dca961cf7e97bd5a639af3dbdf1c387379eecf4e3572a5086
7
- data.tar.gz: 2113b5ca4f784178262c9d9b3996d4fb0bb9aa50dc7f881e6c545e117f47dd1152d2bd80e5713d7afc06cd54781d996a0b8f2f4591221a7957af048afdde62ab
6
+ metadata.gz: e453fb4312a2f065aed892164220130838138873f73deb84381a50025babef96b72dcb67d44343c800cde64db87b6ff6e430bf8f52d912b3a0dfe74f4eade60f
7
+ data.tar.gz: 63f2d8b7f7f93e938af786bf8561e77db05492d61f23dde286db04d2d0f87346df84a7962e46ec262a1a7d26dec0a9261b6e3249e7486b17d26505f270c42506
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-bigquery-connection-v1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Credentials}):
68
68
 
69
- 1. `BIGQUERY_CONNECTION_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `BIGQUERY_CONNECTION_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_CONNECTION_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `BIGQUERY_CONNECTION_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/connection/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.ne
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/connection/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.ne
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/connection/v1"
data/README.md CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/bigquery/connection/v1"
34
34
 
35
35
  client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::Bigquery::Connection::V1::CreateConnectionRequest.new # (request fields as keyword arguments...)
37
37
  response = client.create_connection request
38
38
  ```
39
39
 
@@ -1,8 +1,6 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/bigquery/connection/v1/connection.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
@@ -12,6 +10,8 @@ require 'google/iam/v1/policy_pb'
12
10
  require 'google/protobuf/empty_pb'
13
11
  require 'google/protobuf/field_mask_pb'
14
12
  require 'google/protobuf/wrappers_pb'
13
+ require 'google/protobuf'
14
+
15
15
  Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  add_file("google/cloud/bigquery/connection/v1/connection.proto", :syntax => :proto3) do
17
17
  add_message "google.cloud.bigquery.connection.v1.CreateConnectionRequest" do
@@ -49,6 +49,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
49
49
  oneof :properties do
50
50
  optional :cloud_sql, :message, 4, "google.cloud.bigquery.connection.v1.CloudSqlProperties"
51
51
  optional :aws, :message, 8, "google.cloud.bigquery.connection.v1.AwsProperties"
52
+ optional :cloud_spanner, :message, 21, "google.cloud.bigquery.connection.v1.CloudSpannerProperties"
52
53
  end
53
54
  end
54
55
  add_message "google.cloud.bigquery.connection.v1.CloudSqlProperties" do
@@ -66,9 +67,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
66
67
  optional :username, :string, 1
67
68
  optional :password, :string, 2
68
69
  end
70
+ add_message "google.cloud.bigquery.connection.v1.CloudSpannerProperties" do
71
+ optional :database, :string, 1
72
+ optional :use_parallelism, :bool, 2
73
+ end
69
74
  add_message "google.cloud.bigquery.connection.v1.AwsProperties" do
70
75
  oneof :authentication_method do
71
76
  optional :cross_account_role, :message, 2, "google.cloud.bigquery.connection.v1.AwsCrossAccountRole"
77
+ optional :access_role, :message, 3, "google.cloud.bigquery.connection.v1.AwsAccessRole"
72
78
  end
73
79
  end
74
80
  add_message "google.cloud.bigquery.connection.v1.AwsCrossAccountRole" do
@@ -76,6 +82,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
76
82
  optional :iam_user_id, :string, 2
77
83
  optional :external_id, :string, 3
78
84
  end
85
+ add_message "google.cloud.bigquery.connection.v1.AwsAccessRole" do
86
+ optional :iam_role_id, :string, 1
87
+ optional :identity, :string, 2
88
+ end
79
89
  end
80
90
  end
81
91
 
@@ -94,8 +104,10 @@ module Google
94
104
  CloudSqlProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlProperties").msgclass
95
105
  CloudSqlProperties::DatabaseType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlProperties.DatabaseType").enummodule
96
106
  CloudSqlCredential = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlCredential").msgclass
107
+ CloudSpannerProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSpannerProperties").msgclass
97
108
  AwsProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsProperties").msgclass
98
109
  AwsCrossAccountRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsCrossAccountRole").msgclass
110
+ AwsAccessRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsAccessRole").msgclass
99
111
  end
100
112
  end
101
113
  end
@@ -42,13 +42,12 @@ module Google
42
42
  # See {::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client::Configuration}
43
43
  # for a description of the configuration fields.
44
44
  #
45
- # ## Example
45
+ # @example
46
46
  #
47
- # To modify the configuration for all ConnectionService clients:
48
- #
49
- # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
50
- # config.timeout = 10.0
51
- # end
47
+ # # Modify the configuration for all ConnectionService clients
48
+ # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
49
+ # config.timeout = 10.0
50
+ # end
52
51
  #
53
52
  # @yield [config] Configure the Client client.
54
53
  # @yieldparam config [Client::Configuration]
@@ -70,28 +69,19 @@ module Google
70
69
 
71
70
  default_config.rpcs.get_connection.timeout = 60.0
72
71
  default_config.rpcs.get_connection.retry_policy = {
73
- initial_delay: 0.1,
74
- max_delay: 60.0,
75
- multiplier: 1.3,
76
- retry_codes: [4, 14]
72
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
77
73
  }
78
74
 
79
75
  default_config.rpcs.list_connections.timeout = 60.0
80
76
  default_config.rpcs.list_connections.retry_policy = {
81
- initial_delay: 0.1,
82
- max_delay: 60.0,
83
- multiplier: 1.3,
84
- retry_codes: [4, 14]
77
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
85
78
  }
86
79
 
87
80
  default_config.rpcs.update_connection.timeout = 60.0
88
81
 
89
82
  default_config.rpcs.delete_connection.timeout = 60.0
90
83
  default_config.rpcs.delete_connection.retry_policy = {
91
- initial_delay: 0.1,
92
- max_delay: 60.0,
93
- multiplier: 1.3,
94
- retry_codes: [4, 14]
84
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
95
85
  }
96
86
 
97
87
  default_config.rpcs.get_iam_policy.timeout = 60.0
@@ -129,19 +119,15 @@ module Google
129
119
  ##
130
120
  # Create a new ConnectionService client object.
131
121
  #
132
- # ## Examples
133
- #
134
- # To create a new ConnectionService client with the default
135
- # configuration:
136
- #
137
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
122
+ # @example
138
123
  #
139
- # To create a new ConnectionService client with a custom
140
- # configuration:
124
+ # # Create a client using the default configuration
125
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
141
126
  #
142
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
143
- # config.timeout = 10.0
144
- # end
127
+ # # Create a client using a custom configuration
128
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
129
+ # config.timeout = 10.0
130
+ # end
145
131
  #
146
132
  # @yield [config] Configure the ConnectionService client.
147
133
  # @yieldparam config [Client::Configuration]
@@ -161,14 +147,13 @@ module Google
161
147
 
162
148
  # Create credentials
163
149
  credentials = @config.credentials
164
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
150
+ # Use self-signed JWT if the endpoint is unchanged from default,
165
151
  # but only if the default endpoint does not have a region prefix.
166
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
167
- @config.endpoint == Client.configure.endpoint &&
152
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
168
153
  !@config.endpoint.split(".").first.include?("-")
169
154
  credentials ||= Credentials.default scope: @config.scope,
170
155
  enable_self_signed_jwt: enable_self_signed_jwt
171
- if credentials.is_a?(String) || credentials.is_a?(Hash)
156
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
172
157
  credentials = Credentials.new credentials, scope: @config.scope
173
158
  end
174
159
  @quota_project_id = @config.quota_project
@@ -219,6 +204,21 @@ module Google
219
204
  #
220
205
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
221
206
  #
207
+ # @example Basic example
208
+ # require "google/cloud/bigquery/connection/v1"
209
+ #
210
+ # # Create a client object. The client can be reused for multiple calls.
211
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
212
+ #
213
+ # # Create a request. To set request fields, pass in keyword arguments.
214
+ # request = Google::Cloud::Bigquery::Connection::V1::CreateConnectionRequest.new
215
+ #
216
+ # # Call the create_connection method.
217
+ # result = client.create_connection request
218
+ #
219
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
220
+ # p result
221
+ #
222
222
  def create_connection request, options = nil
223
223
  raise ::ArgumentError, "request must be provided" if request.nil?
224
224
 
@@ -236,16 +236,20 @@ module Google
236
236
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
237
237
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
238
238
 
239
- header_params = {
240
- "parent" => request.parent
241
- }
239
+ header_params = {}
240
+ if request.parent
241
+ header_params["parent"] = request.parent
242
+ end
243
+
242
244
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
243
245
  metadata[:"x-goog-request-params"] ||= request_params_header
244
246
 
245
247
  options.apply_defaults timeout: @config.rpcs.create_connection.timeout,
246
248
  metadata: metadata,
247
249
  retry_policy: @config.rpcs.create_connection.retry_policy
248
- options.apply_defaults metadata: @config.metadata,
250
+
251
+ options.apply_defaults timeout: @config.timeout,
252
+ metadata: @config.metadata,
249
253
  retry_policy: @config.retry_policy
250
254
 
251
255
  @connection_service_stub.call_rpc :create_connection, request, options: options do |response, operation|
@@ -286,6 +290,21 @@ module Google
286
290
  #
287
291
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
288
292
  #
293
+ # @example Basic example
294
+ # require "google/cloud/bigquery/connection/v1"
295
+ #
296
+ # # Create a client object. The client can be reused for multiple calls.
297
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
298
+ #
299
+ # # Create a request. To set request fields, pass in keyword arguments.
300
+ # request = Google::Cloud::Bigquery::Connection::V1::GetConnectionRequest.new
301
+ #
302
+ # # Call the get_connection method.
303
+ # result = client.get_connection request
304
+ #
305
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
306
+ # p result
307
+ #
289
308
  def get_connection request, options = nil
290
309
  raise ::ArgumentError, "request must be provided" if request.nil?
291
310
 
@@ -303,16 +322,20 @@ module Google
303
322
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
304
323
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
305
324
 
306
- header_params = {
307
- "name" => request.name
308
- }
325
+ header_params = {}
326
+ if request.name
327
+ header_params["name"] = request.name
328
+ end
329
+
309
330
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
310
331
  metadata[:"x-goog-request-params"] ||= request_params_header
311
332
 
312
333
  options.apply_defaults timeout: @config.rpcs.get_connection.timeout,
313
334
  metadata: metadata,
314
335
  retry_policy: @config.rpcs.get_connection.retry_policy
315
- options.apply_defaults metadata: @config.metadata,
336
+
337
+ options.apply_defaults timeout: @config.timeout,
338
+ metadata: @config.metadata,
316
339
  retry_policy: @config.retry_policy
317
340
 
318
341
  @connection_service_stub.call_rpc :get_connection, request, options: options do |response, operation|
@@ -357,6 +380,27 @@ module Google
357
380
  #
358
381
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
359
382
  #
383
+ # @example Basic example
384
+ # require "google/cloud/bigquery/connection/v1"
385
+ #
386
+ # # Create a client object. The client can be reused for multiple calls.
387
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
388
+ #
389
+ # # Create a request. To set request fields, pass in keyword arguments.
390
+ # request = Google::Cloud::Bigquery::Connection::V1::ListConnectionsRequest.new
391
+ #
392
+ # # Call the list_connections method.
393
+ # result = client.list_connections request
394
+ #
395
+ # # The returned object is of type Gapic::PagedEnumerable. You can
396
+ # # iterate over all elements by calling #each, and the enumerable
397
+ # # will lazily make API calls to fetch subsequent pages. Other
398
+ # # methods are also available for managing paging directly.
399
+ # result.each do |response|
400
+ # # Each element is of type ::Google::Cloud::Bigquery::Connection::V1::Connection.
401
+ # p response
402
+ # end
403
+ #
360
404
  def list_connections request, options = nil
361
405
  raise ::ArgumentError, "request must be provided" if request.nil?
362
406
 
@@ -374,16 +418,20 @@ module Google
374
418
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
375
419
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
376
420
 
377
- header_params = {
378
- "parent" => request.parent
379
- }
421
+ header_params = {}
422
+ if request.parent
423
+ header_params["parent"] = request.parent
424
+ end
425
+
380
426
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
381
427
  metadata[:"x-goog-request-params"] ||= request_params_header
382
428
 
383
429
  options.apply_defaults timeout: @config.rpcs.list_connections.timeout,
384
430
  metadata: metadata,
385
431
  retry_policy: @config.rpcs.list_connections.retry_policy
386
- options.apply_defaults metadata: @config.metadata,
432
+
433
+ options.apply_defaults timeout: @config.timeout,
434
+ metadata: @config.metadata,
387
435
  retry_policy: @config.retry_policy
388
436
 
389
437
  @connection_service_stub.call_rpc :list_connections, request, options: options do |response, operation|
@@ -430,6 +478,21 @@ module Google
430
478
  #
431
479
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
432
480
  #
481
+ # @example Basic example
482
+ # require "google/cloud/bigquery/connection/v1"
483
+ #
484
+ # # Create a client object. The client can be reused for multiple calls.
485
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
486
+ #
487
+ # # Create a request. To set request fields, pass in keyword arguments.
488
+ # request = Google::Cloud::Bigquery::Connection::V1::UpdateConnectionRequest.new
489
+ #
490
+ # # Call the update_connection method.
491
+ # result = client.update_connection request
492
+ #
493
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
494
+ # p result
495
+ #
433
496
  def update_connection request, options = nil
434
497
  raise ::ArgumentError, "request must be provided" if request.nil?
435
498
 
@@ -447,16 +510,20 @@ module Google
447
510
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
448
511
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
449
512
 
450
- header_params = {
451
- "name" => request.name
452
- }
513
+ header_params = {}
514
+ if request.name
515
+ header_params["name"] = request.name
516
+ end
517
+
453
518
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
454
519
  metadata[:"x-goog-request-params"] ||= request_params_header
455
520
 
456
521
  options.apply_defaults timeout: @config.rpcs.update_connection.timeout,
457
522
  metadata: metadata,
458
523
  retry_policy: @config.rpcs.update_connection.retry_policy
459
- options.apply_defaults metadata: @config.metadata,
524
+
525
+ options.apply_defaults timeout: @config.timeout,
526
+ metadata: @config.metadata,
460
527
  retry_policy: @config.retry_policy
461
528
 
462
529
  @connection_service_stub.call_rpc :update_connection, request, options: options do |response, operation|
@@ -497,6 +564,21 @@ module Google
497
564
  #
498
565
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
499
566
  #
567
+ # @example Basic example
568
+ # require "google/cloud/bigquery/connection/v1"
569
+ #
570
+ # # Create a client object. The client can be reused for multiple calls.
571
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
572
+ #
573
+ # # Create a request. To set request fields, pass in keyword arguments.
574
+ # request = Google::Cloud::Bigquery::Connection::V1::DeleteConnectionRequest.new
575
+ #
576
+ # # Call the delete_connection method.
577
+ # result = client.delete_connection request
578
+ #
579
+ # # The returned object is of type Google::Protobuf::Empty.
580
+ # p result
581
+ #
500
582
  def delete_connection request, options = nil
501
583
  raise ::ArgumentError, "request must be provided" if request.nil?
502
584
 
@@ -514,16 +596,20 @@ module Google
514
596
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
515
597
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
516
598
 
517
- header_params = {
518
- "name" => request.name
519
- }
599
+ header_params = {}
600
+ if request.name
601
+ header_params["name"] = request.name
602
+ end
603
+
520
604
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
521
605
  metadata[:"x-goog-request-params"] ||= request_params_header
522
606
 
523
607
  options.apply_defaults timeout: @config.rpcs.delete_connection.timeout,
524
608
  metadata: metadata,
525
609
  retry_policy: @config.rpcs.delete_connection.retry_policy
526
- options.apply_defaults metadata: @config.metadata,
610
+
611
+ options.apply_defaults timeout: @config.timeout,
612
+ metadata: @config.metadata,
527
613
  retry_policy: @config.retry_policy
528
614
 
529
615
  @connection_service_stub.call_rpc :delete_connection, request, options: options do |response, operation|
@@ -569,6 +655,21 @@ module Google
569
655
  #
570
656
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
571
657
  #
658
+ # @example Basic example
659
+ # require "google/cloud/bigquery/connection/v1"
660
+ #
661
+ # # Create a client object. The client can be reused for multiple calls.
662
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
663
+ #
664
+ # # Create a request. To set request fields, pass in keyword arguments.
665
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
666
+ #
667
+ # # Call the get_iam_policy method.
668
+ # result = client.get_iam_policy request
669
+ #
670
+ # # The returned object is of type Google::Iam::V1::Policy.
671
+ # p result
672
+ #
572
673
  def get_iam_policy request, options = nil
573
674
  raise ::ArgumentError, "request must be provided" if request.nil?
574
675
 
@@ -586,16 +687,20 @@ module Google
586
687
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
587
688
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
588
689
 
589
- header_params = {
590
- "resource" => request.resource
591
- }
690
+ header_params = {}
691
+ if request.resource
692
+ header_params["resource"] = request.resource
693
+ end
694
+
592
695
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
593
696
  metadata[:"x-goog-request-params"] ||= request_params_header
594
697
 
595
698
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
596
699
  metadata: metadata,
597
700
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
598
- options.apply_defaults metadata: @config.metadata,
701
+
702
+ options.apply_defaults timeout: @config.timeout,
703
+ metadata: @config.metadata,
599
704
  retry_policy: @config.retry_policy
600
705
 
601
706
  @connection_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -644,6 +749,21 @@ module Google
644
749
  #
645
750
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
646
751
  #
752
+ # @example Basic example
753
+ # require "google/cloud/bigquery/connection/v1"
754
+ #
755
+ # # Create a client object. The client can be reused for multiple calls.
756
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
757
+ #
758
+ # # Create a request. To set request fields, pass in keyword arguments.
759
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
760
+ #
761
+ # # Call the set_iam_policy method.
762
+ # result = client.set_iam_policy request
763
+ #
764
+ # # The returned object is of type Google::Iam::V1::Policy.
765
+ # p result
766
+ #
647
767
  def set_iam_policy request, options = nil
648
768
  raise ::ArgumentError, "request must be provided" if request.nil?
649
769
 
@@ -661,16 +781,20 @@ module Google
661
781
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
662
782
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
663
783
 
664
- header_params = {
665
- "resource" => request.resource
666
- }
784
+ header_params = {}
785
+ if request.resource
786
+ header_params["resource"] = request.resource
787
+ end
788
+
667
789
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
668
790
  metadata[:"x-goog-request-params"] ||= request_params_header
669
791
 
670
792
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
671
793
  metadata: metadata,
672
794
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
673
- options.apply_defaults metadata: @config.metadata,
795
+
796
+ options.apply_defaults timeout: @config.timeout,
797
+ metadata: @config.metadata,
674
798
  retry_policy: @config.retry_policy
675
799
 
676
800
  @connection_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -722,6 +846,21 @@ module Google
722
846
  #
723
847
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
724
848
  #
849
+ # @example Basic example
850
+ # require "google/cloud/bigquery/connection/v1"
851
+ #
852
+ # # Create a client object. The client can be reused for multiple calls.
853
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
854
+ #
855
+ # # Create a request. To set request fields, pass in keyword arguments.
856
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
857
+ #
858
+ # # Call the test_iam_permissions method.
859
+ # result = client.test_iam_permissions request
860
+ #
861
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
862
+ # p result
863
+ #
725
864
  def test_iam_permissions request, options = nil
726
865
  raise ::ArgumentError, "request must be provided" if request.nil?
727
866
 
@@ -739,16 +878,20 @@ module Google
739
878
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
740
879
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
741
880
 
742
- header_params = {
743
- "resource" => request.resource
744
- }
881
+ header_params = {}
882
+ if request.resource
883
+ header_params["resource"] = request.resource
884
+ end
885
+
745
886
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
746
887
  metadata[:"x-goog-request-params"] ||= request_params_header
747
888
 
748
889
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
749
890
  metadata: metadata,
750
891
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
751
- options.apply_defaults metadata: @config.metadata,
892
+
893
+ options.apply_defaults timeout: @config.timeout,
894
+ metadata: @config.metadata,
752
895
  retry_policy: @config.retry_policy
753
896
 
754
897
  @connection_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -772,22 +915,21 @@ module Google
772
915
  # Configuration can be applied globally to all clients, or to a single client
773
916
  # on construction.
774
917
  #
775
- # # Examples
776
- #
777
- # To modify the global config, setting the timeout for create_connection
778
- # to 20 seconds, and all remaining timeouts to 10 seconds:
779
- #
780
- # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
781
- # config.timeout = 10.0
782
- # config.rpcs.create_connection.timeout = 20.0
783
- # end
784
- #
785
- # To apply the above configuration only to a new client:
786
- #
787
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
788
- # config.timeout = 10.0
789
- # config.rpcs.create_connection.timeout = 20.0
790
- # end
918
+ # @example
919
+ #
920
+ # # Modify the global config, setting the timeout for
921
+ # # create_connection to 20 seconds,
922
+ # # and all remaining timeouts to 10 seconds.
923
+ # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
924
+ # config.timeout = 10.0
925
+ # config.rpcs.create_connection.timeout = 20.0
926
+ # end
927
+ #
928
+ # # Apply the above configuration only to a new client.
929
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
930
+ # config.timeout = 10.0
931
+ # config.rpcs.create_connection.timeout = 20.0
932
+ # end
791
933
  #
792
934
  # @!attribute [rw] endpoint
793
935
  # The hostname or hostname:port of the service endpoint.
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Connection
24
24
  module V1
25
- VERSION = "0.4.1"
25
+ VERSION = "0.5.2"
26
26
  end
27
27
  end
28
28
  end
@@ -57,9 +57,15 @@ module Google
57
57
 
58
58
  # Denotes that a (repeated) field is an unordered list.
59
59
  # This indicates that the service may provide the elements of the list
60
- # in any arbitrary order, rather than the order the user originally
60
+ # in any arbitrary order, rather than the order the user originally
61
61
  # provided. Additionally, the list's order may or may not be stable.
62
62
  UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
63
69
  end
64
70
  end
65
71
  end
@@ -120,6 +120,9 @@ module Google
120
120
  # @!attribute [rw] aws
121
121
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsProperties]
122
122
  # Amazon Web Services (AWS) properties.
123
+ # @!attribute [rw] cloud_spanner
124
+ # @return [::Google::Cloud::Bigquery::Connection::V1::CloudSpannerProperties]
125
+ # Cloud Spanner properties.
123
126
  # @!attribute [r] creation_time
124
127
  # @return [::Integer]
125
128
  # Output only. The creation timestamp of the connection.
@@ -176,11 +179,27 @@ module Google
176
179
  extend ::Google::Protobuf::MessageExts::ClassMethods
177
180
  end
178
181
 
182
+ # Connection properties specific to Cloud Spanner.
183
+ # @!attribute [rw] database
184
+ # @return [::String]
185
+ # Cloud Spanner database in the form `project/instance/database'
186
+ # @!attribute [rw] use_parallelism
187
+ # @return [::Boolean]
188
+ # If parallelism should be used when reading from Cloud Spanner
189
+ class CloudSpannerProperties
190
+ include ::Google::Protobuf::MessageExts
191
+ extend ::Google::Protobuf::MessageExts::ClassMethods
192
+ end
193
+
179
194
  # Connection properties specific to Amazon Web Services (AWS).
180
195
  # @!attribute [rw] cross_account_role
181
196
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsCrossAccountRole]
182
197
  # Authentication using Google owned AWS IAM user's access key to assume
183
198
  # into customer's AWS IAM Role.
199
+ # @!attribute [rw] access_role
200
+ # @return [::Google::Cloud::Bigquery::Connection::V1::AwsAccessRole]
201
+ # Authentication using Google owned service account to assume into
202
+ # customer's AWS IAM Role.
184
203
  class AwsProperties
185
204
  include ::Google::Protobuf::MessageExts
186
205
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -204,6 +223,21 @@ module Google
204
223
  include ::Google::Protobuf::MessageExts
205
224
  extend ::Google::Protobuf::MessageExts::ClassMethods
206
225
  end
226
+
227
+ # Authentication method for Amazon Web Services (AWS) that uses Google owned
228
+ # Google service account to assume into customer's AWS IAM Role.
229
+ # @!attribute [rw] iam_role_id
230
+ # @return [::String]
231
+ # The user’s AWS IAM Role that trusts the Google-owned AWS IAM user
232
+ # Connection.
233
+ # @!attribute [rw] identity
234
+ # @return [::String]
235
+ # A unique Google-owned and Google-generated identity for the Connection.
236
+ # This identity will be used to access the user's AWS IAM Role.
237
+ class AwsAccessRole
238
+ include ::Google::Protobuf::MessageExts
239
+ extend ::Google::Protobuf::MessageExts::ClassMethods
240
+ end
207
241
  end
208
242
  end
209
243
  end
@@ -19,30 +19,53 @@
19
19
 
20
20
  module Google
21
21
  module Type
22
- # Represents an expression text. Example:
22
+ # Represents a textual expression in the Common Expression Language (CEL)
23
+ # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
24
+ # are documented at https://github.com/google/cel-spec.
23
25
  #
24
- # title: "User account presence"
25
- # description: "Determines whether the request has a user account"
26
- # expression: "size(request.user) > 0"
26
+ # Example (Comparison):
27
+ #
28
+ # title: "Summary size limit"
29
+ # description: "Determines if a summary is less than 100 chars"
30
+ # expression: "document.summary.size() < 100"
31
+ #
32
+ # Example (Equality):
33
+ #
34
+ # title: "Requestor is owner"
35
+ # description: "Determines if requestor is the document owner"
36
+ # expression: "document.owner == request.auth.claims.email"
37
+ #
38
+ # Example (Logic):
39
+ #
40
+ # title: "Public documents"
41
+ # description: "Determine whether the document should be publicly visible"
42
+ # expression: "document.type != 'private' && document.type != 'internal'"
43
+ #
44
+ # Example (Data Manipulation):
45
+ #
46
+ # title: "Notification string"
47
+ # description: "Create a notification string with a timestamp."
48
+ # expression: "'New message received at ' + string(document.create_time)"
49
+ #
50
+ # The exact variables and functions that may be referenced within an expression
51
+ # are determined by the service that evaluates it. See the service
52
+ # documentation for additional information.
27
53
  # @!attribute [rw] expression
28
54
  # @return [::String]
29
- # Textual representation of an expression in
30
- # Common Expression Language syntax.
31
- #
32
- # The application context of the containing message determines which
33
- # well-known feature set of CEL is supported.
55
+ # Textual representation of an expression in Common Expression Language
56
+ # syntax.
34
57
  # @!attribute [rw] title
35
58
  # @return [::String]
36
- # An optional title for the expression, i.e. a short string describing
59
+ # Optional. Title for the expression, i.e. a short string describing
37
60
  # its purpose. This can be used e.g. in UIs which allow to enter the
38
61
  # expression.
39
62
  # @!attribute [rw] description
40
63
  # @return [::String]
41
- # An optional description of the expression. This is a longer text which
64
+ # Optional. Description of the expression. This is a longer text which
42
65
  # describes the expression, e.g. when hovered over it in a UI.
43
66
  # @!attribute [rw] location
44
67
  # @return [::String]
45
- # An optional string indicating the location of the expression for error
68
+ # Optional. String indicating the location of the expression for error
46
69
  # reporting, e.g. a file name and a position in the file.
47
70
  class Expr
48
71
  include ::Google::Protobuf::MessageExts
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-connection-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.1
4
+ version: 0.5.2
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-06-17 00:00:00.000000000 Z
11
+ date: 2021-11-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.5'
19
+ version: '0.7'
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a