google-cloud-bigquery-connection-v1 1.0.1 → 1.2.0

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: fd3438d8ed95019fd6cfd5bf1ecdffecadb0b02746b2e6009ffb37c775f59ca6
4
- data.tar.gz: 87cc599aee2951c7787cf52d60677381aa75b3f5cdbc7b81522d474497f0fc6b
3
+ metadata.gz: ed7330063313533ffe0404c3fdceab581c984b1c2bddfdd2542f4b2f3d0fa77a
4
+ data.tar.gz: f25a5822721259f37f89bc2dcff24f194b0982546bd5470cce009b2520f3c901
5
5
  SHA512:
6
- metadata.gz: 94e1fcc135f11d853a1a0dadf037f91d9483c90f9cd315ff298a7299c3422dabc25ded9b61d3d3359dbc7a2c353396380e97f2b1a19a30b23696dda705d1e902
7
- data.tar.gz: e009b5797129c265d89df2c8841eca89ddde3c64976d099f9a7e140b06c05bbe24a50edf97c1a24eb04eacee10374e04b00ecaeb8899a06598b9baf44919ec1a
6
+ metadata.gz: 7bd04d8d5009edc9ea63e259fd7535b6a5d7f42b2f989c40cc6be812d0a34703694d1aa9fb1b2afd14438fdbcfd31492d12fd95f3d4d2c3c1a54e7d0ae446eb5
7
+ data.tar.gz: 401ad4ad15712c25d8ce77a232c63c6b9b706b2713e6e6c298dee4826f85d70d351b6e70651a4a6666057af5213ee2368e9a2a275714cdfe9ac2133e324442f2
data/README.md CHANGED
@@ -43,40 +43,50 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/bigqueryconnection)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/bigquery/connection/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
86
 
77
87
  ## Supported Ruby Versions
78
88
 
79
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
80
90
 
81
91
  Google provides official support for Ruby versions that are actively supported
82
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -183,8 +183,28 @@ module Google
183
183
  universe_domain: @config.universe_domain,
184
184
  channel_args: @config.channel_args,
185
185
  interceptors: @config.interceptors,
186
- channel_pool_config: @config.channel_pool
186
+ channel_pool_config: @config.channel_pool,
187
+ logger: @config.logger
187
188
  )
189
+
190
+ @connection_service_stub.stub_logger&.info do |entry|
191
+ entry.set_system_name
192
+ entry.set_service
193
+ entry.message = "Created client for #{entry.service}"
194
+ entry.set_credentials_fields credentials
195
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
196
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
197
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
198
+ end
199
+ end
200
+
201
+ ##
202
+ # The logger used for request/response debug logging.
203
+ #
204
+ # @return [Logger]
205
+ #
206
+ def logger
207
+ @connection_service_stub.logger
188
208
  end
189
209
 
190
210
  # Service calls
@@ -274,7 +294,6 @@ module Google
274
294
 
275
295
  @connection_service_stub.call_rpc :create_connection, request, options: options do |response, operation|
276
296
  yield response, operation if block_given?
277
- return response
278
297
  end
279
298
  rescue ::GRPC::BadStatus => e
280
299
  raise ::Google::Cloud::Error.from_error(e)
@@ -361,7 +380,6 @@ module Google
361
380
 
362
381
  @connection_service_stub.call_rpc :get_connection, request, options: options do |response, operation|
363
382
  yield response, operation if block_given?
364
- return response
365
383
  end
366
384
  rescue ::GRPC::BadStatus => e
367
385
  raise ::Google::Cloud::Error.from_error(e)
@@ -457,7 +475,7 @@ module Google
457
475
  @connection_service_stub.call_rpc :list_connections, request, options: options do |response, operation|
458
476
  response = ::Gapic::PagedEnumerable.new @connection_service_stub, :list_connections, request, response, operation, options
459
477
  yield response, operation if block_given?
460
- return response
478
+ throw :response, response
461
479
  end
462
480
  rescue ::GRPC::BadStatus => e
463
481
  raise ::Google::Cloud::Error.from_error(e)
@@ -549,7 +567,6 @@ module Google
549
567
 
550
568
  @connection_service_stub.call_rpc :update_connection, request, options: options do |response, operation|
551
569
  yield response, operation if block_given?
552
- return response
553
570
  end
554
571
  rescue ::GRPC::BadStatus => e
555
572
  raise ::Google::Cloud::Error.from_error(e)
@@ -636,7 +653,6 @@ module Google
636
653
 
637
654
  @connection_service_stub.call_rpc :delete_connection, request, options: options do |response, operation|
638
655
  yield response, operation if block_given?
639
- return response
640
656
  end
641
657
  rescue ::GRPC::BadStatus => e
642
658
  raise ::Google::Cloud::Error.from_error(e)
@@ -728,7 +744,6 @@ module Google
728
744
 
729
745
  @connection_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
730
746
  yield response, operation if block_given?
731
- return response
732
747
  end
733
748
  rescue ::GRPC::BadStatus => e
734
749
  raise ::Google::Cloud::Error.from_error(e)
@@ -829,7 +844,6 @@ module Google
829
844
 
830
845
  @connection_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
831
846
  yield response, operation if block_given?
832
- return response
833
847
  end
834
848
  rescue ::GRPC::BadStatus => e
835
849
  raise ::Google::Cloud::Error.from_error(e)
@@ -927,7 +941,6 @@ module Google
927
941
 
928
942
  @connection_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
929
943
  yield response, operation if block_given?
930
- return response
931
944
  end
932
945
  rescue ::GRPC::BadStatus => e
933
946
  raise ::Google::Cloud::Error.from_error(e)
@@ -977,6 +990,13 @@ module Google
977
990
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
978
991
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
979
992
  # * (`nil`) indicating no credentials
993
+ #
994
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
995
+ # external source for authentication to Google Cloud, you must validate it before
996
+ # providing it to a Google API client library. Providing an unvalidated credential
997
+ # configuration to Google APIs can compromise the security of your systems and data.
998
+ # For more information, refer to [Validate credential configurations from external
999
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
980
1000
  # @return [::Object]
981
1001
  # @!attribute [rw] scope
982
1002
  # The OAuth scopes
@@ -1016,6 +1036,11 @@ module Google
1016
1036
  # default endpoint URL. The default value of nil uses the environment
1017
1037
  # universe (usually the default "googleapis.com" universe).
1018
1038
  # @return [::String,nil]
1039
+ # @!attribute [rw] logger
1040
+ # A custom logger to use for request/response debug logging, or the value
1041
+ # `:default` (the default) to construct a default logger, or `nil` to
1042
+ # explicitly disable logging.
1043
+ # @return [::Logger,:default,nil]
1019
1044
  #
1020
1045
  class Configuration
1021
1046
  extend ::Gapic::Config
@@ -1040,6 +1065,7 @@ module Google
1040
1065
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1041
1066
  config_attr :quota_project, nil, ::String, nil
1042
1067
  config_attr :universe_domain, nil, ::String, nil
1068
+ config_attr :logger, :default, ::Logger, nil, :default
1043
1069
 
1044
1070
  # @private
1045
1071
  def initialize parent_config = nil
@@ -176,8 +176,28 @@ module Google
176
176
  endpoint: @config.endpoint,
177
177
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
178
178
  universe_domain: @config.universe_domain,
179
- credentials: credentials
179
+ credentials: credentials,
180
+ logger: @config.logger
180
181
  )
182
+
183
+ @connection_service_stub.logger(stub: true)&.info do |entry|
184
+ entry.set_system_name
185
+ entry.set_service
186
+ entry.message = "Created client for #{entry.service}"
187
+ entry.set_credentials_fields credentials
188
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
189
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
190
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
191
+ end
192
+ end
193
+
194
+ ##
195
+ # The logger used for request/response debug logging.
196
+ #
197
+ # @return [Logger]
198
+ #
199
+ def logger
200
+ @connection_service_stub.logger
181
201
  end
182
202
 
183
203
  # Service calls
@@ -260,7 +280,6 @@ module Google
260
280
 
261
281
  @connection_service_stub.create_connection request, options do |result, operation|
262
282
  yield result, operation if block_given?
263
- return result
264
283
  end
265
284
  rescue ::Gapic::Rest::Error => e
266
285
  raise ::Google::Cloud::Error.from_error(e)
@@ -340,7 +359,6 @@ module Google
340
359
 
341
360
  @connection_service_stub.get_connection request, options do |result, operation|
342
361
  yield result, operation if block_given?
343
- return result
344
362
  end
345
363
  rescue ::Gapic::Rest::Error => e
346
364
  raise ::Google::Cloud::Error.from_error(e)
@@ -429,7 +447,7 @@ module Google
429
447
  @connection_service_stub.list_connections request, options do |result, operation|
430
448
  result = ::Gapic::Rest::PagedEnumerable.new @connection_service_stub, :list_connections, "connections", request, result, options
431
449
  yield result, operation if block_given?
432
- return result
450
+ throw :response, result
433
451
  end
434
452
  rescue ::Gapic::Rest::Error => e
435
453
  raise ::Google::Cloud::Error.from_error(e)
@@ -514,7 +532,6 @@ module Google
514
532
 
515
533
  @connection_service_stub.update_connection request, options do |result, operation|
516
534
  yield result, operation if block_given?
517
- return result
518
535
  end
519
536
  rescue ::Gapic::Rest::Error => e
520
537
  raise ::Google::Cloud::Error.from_error(e)
@@ -594,7 +611,6 @@ module Google
594
611
 
595
612
  @connection_service_stub.delete_connection request, options do |result, operation|
596
613
  yield result, operation if block_given?
597
- return result
598
614
  end
599
615
  rescue ::Gapic::Rest::Error => e
600
616
  raise ::Google::Cloud::Error.from_error(e)
@@ -679,7 +695,6 @@ module Google
679
695
 
680
696
  @connection_service_stub.get_iam_policy request, options do |result, operation|
681
697
  yield result, operation if block_given?
682
- return result
683
698
  end
684
699
  rescue ::Gapic::Rest::Error => e
685
700
  raise ::Google::Cloud::Error.from_error(e)
@@ -773,7 +788,6 @@ module Google
773
788
 
774
789
  @connection_service_stub.set_iam_policy request, options do |result, operation|
775
790
  yield result, operation if block_given?
776
- return result
777
791
  end
778
792
  rescue ::Gapic::Rest::Error => e
779
793
  raise ::Google::Cloud::Error.from_error(e)
@@ -864,7 +878,6 @@ module Google
864
878
 
865
879
  @connection_service_stub.test_iam_permissions request, options do |result, operation|
866
880
  yield result, operation if block_given?
867
- return result
868
881
  end
869
882
  rescue ::Gapic::Rest::Error => e
870
883
  raise ::Google::Cloud::Error.from_error(e)
@@ -912,6 +925,13 @@ module Google
912
925
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
913
926
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
914
927
  # * (`nil`) indicating no credentials
928
+ #
929
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
930
+ # external source for authentication to Google Cloud, you must validate it before
931
+ # providing it to a Google API client library. Providing an unvalidated credential
932
+ # configuration to Google APIs can compromise the security of your systems and data.
933
+ # For more information, refer to [Validate credential configurations from external
934
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
915
935
  # @return [::Object]
916
936
  # @!attribute [rw] scope
917
937
  # The OAuth scopes
@@ -944,6 +964,11 @@ module Google
944
964
  # default endpoint URL. The default value of nil uses the environment
945
965
  # universe (usually the default "googleapis.com" universe).
946
966
  # @return [::String,nil]
967
+ # @!attribute [rw] logger
968
+ # A custom logger to use for request/response debug logging, or the value
969
+ # `:default` (the default) to construct a default logger, or `nil` to
970
+ # explicitly disable logging.
971
+ # @return [::Logger,:default,nil]
947
972
  #
948
973
  class Configuration
949
974
  extend ::Gapic::Config
@@ -965,6 +990,7 @@ module Google
965
990
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
966
991
  config_attr :quota_project, nil, ::String, nil
967
992
  config_attr :universe_domain, nil, ::String, nil
993
+ config_attr :logger, :default, ::Logger, nil, :default
968
994
 
969
995
  # @private
970
996
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the create_connection REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "create_connection",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Cloud::Bigquery::Connection::V1::Connection.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "get_connection",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Cloud::Bigquery::Connection::V1::Connection.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "list_connections",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Cloud::Bigquery::Connection::V1::ListConnectionsResponse.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -202,16 +220,18 @@ module Google
202
220
 
203
221
  response = @client_stub.make_http_request(
204
222
  verb,
205
- uri: uri,
206
- body: body || "",
207
- params: query_string_params,
223
+ uri: uri,
224
+ body: body || "",
225
+ params: query_string_params,
226
+ method_name: "update_connection",
208
227
  options: options
209
228
  )
210
229
  operation = ::Gapic::Rest::TransportOperation.new response
211
230
  result = ::Google::Cloud::Bigquery::Connection::V1::Connection.decode_json response.body, ignore_unknown_fields: true
212
-
213
- yield result, operation if block_given?
214
- result
231
+ catch :response do
232
+ yield result, operation if block_given?
233
+ result
234
+ end
215
235
  end
216
236
 
217
237
  ##
@@ -240,16 +260,18 @@ module Google
240
260
 
241
261
  response = @client_stub.make_http_request(
242
262
  verb,
243
- uri: uri,
244
- body: body || "",
245
- params: query_string_params,
263
+ uri: uri,
264
+ body: body || "",
265
+ params: query_string_params,
266
+ method_name: "delete_connection",
246
267
  options: options
247
268
  )
248
269
  operation = ::Gapic::Rest::TransportOperation.new response
249
270
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
250
-
251
- yield result, operation if block_given?
252
- result
271
+ catch :response do
272
+ yield result, operation if block_given?
273
+ result
274
+ end
253
275
  end
254
276
 
255
277
  ##
@@ -278,16 +300,18 @@ module Google
278
300
 
279
301
  response = @client_stub.make_http_request(
280
302
  verb,
281
- uri: uri,
282
- body: body || "",
283
- params: query_string_params,
303
+ uri: uri,
304
+ body: body || "",
305
+ params: query_string_params,
306
+ method_name: "get_iam_policy",
284
307
  options: options
285
308
  )
286
309
  operation = ::Gapic::Rest::TransportOperation.new response
287
310
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
288
-
289
- yield result, operation if block_given?
290
- result
311
+ catch :response do
312
+ yield result, operation if block_given?
313
+ result
314
+ end
291
315
  end
292
316
 
293
317
  ##
@@ -316,16 +340,18 @@ module Google
316
340
 
317
341
  response = @client_stub.make_http_request(
318
342
  verb,
319
- uri: uri,
320
- body: body || "",
321
- params: query_string_params,
343
+ uri: uri,
344
+ body: body || "",
345
+ params: query_string_params,
346
+ method_name: "set_iam_policy",
322
347
  options: options
323
348
  )
324
349
  operation = ::Gapic::Rest::TransportOperation.new response
325
350
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
326
-
327
- yield result, operation if block_given?
328
- result
351
+ catch :response do
352
+ yield result, operation if block_given?
353
+ result
354
+ end
329
355
  end
330
356
 
331
357
  ##
@@ -354,16 +380,18 @@ module Google
354
380
 
355
381
  response = @client_stub.make_http_request(
356
382
  verb,
357
- uri: uri,
358
- body: body || "",
359
- params: query_string_params,
383
+ uri: uri,
384
+ body: body || "",
385
+ params: query_string_params,
386
+ method_name: "test_iam_permissions",
360
387
  options: options
361
388
  )
362
389
  operation = ::Gapic::Rest::TransportOperation.new response
363
390
  result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
364
-
365
- yield result, operation if block_given?
366
- result
391
+ catch :response do
392
+ yield result, operation if block_given?
393
+ result
394
+ end
367
395
  end
368
396
 
369
397
  ##
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Connection
24
24
  module V1
25
- VERSION = "1.0.1"
25
+ VERSION = "1.2.0"
26
26
  end
27
27
  end
28
28
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -122,26 +122,40 @@ module Google
122
122
  # @!attribute [rw] cloud_sql
123
123
  # @return [::Google::Cloud::Bigquery::Connection::V1::CloudSqlProperties]
124
124
  # Cloud SQL properties.
125
+ #
126
+ # Note: The following fields are mutually exclusive: `cloud_sql`, `aws`, `azure`, `cloud_spanner`, `cloud_resource`, `spark`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
125
127
  # @!attribute [rw] aws
126
128
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsProperties]
127
129
  # Amazon Web Services (AWS) properties.
130
+ #
131
+ # Note: The following fields are mutually exclusive: `aws`, `cloud_sql`, `azure`, `cloud_spanner`, `cloud_resource`, `spark`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
128
132
  # @!attribute [rw] azure
129
133
  # @return [::Google::Cloud::Bigquery::Connection::V1::AzureProperties]
130
134
  # Azure properties.
135
+ #
136
+ # Note: The following fields are mutually exclusive: `azure`, `cloud_sql`, `aws`, `cloud_spanner`, `cloud_resource`, `spark`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
131
137
  # @!attribute [rw] cloud_spanner
132
138
  # @return [::Google::Cloud::Bigquery::Connection::V1::CloudSpannerProperties]
133
139
  # Cloud Spanner properties.
140
+ #
141
+ # Note: The following fields are mutually exclusive: `cloud_spanner`, `cloud_sql`, `aws`, `azure`, `cloud_resource`, `spark`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
134
142
  # @!attribute [rw] cloud_resource
135
143
  # @return [::Google::Cloud::Bigquery::Connection::V1::CloudResourceProperties]
136
144
  # Cloud Resource properties.
145
+ #
146
+ # Note: The following fields are mutually exclusive: `cloud_resource`, `cloud_sql`, `aws`, `azure`, `cloud_spanner`, `spark`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
137
147
  # @!attribute [rw] spark
138
148
  # @return [::Google::Cloud::Bigquery::Connection::V1::SparkProperties]
139
149
  # Spark properties.
150
+ #
151
+ # Note: The following fields are mutually exclusive: `spark`, `cloud_sql`, `aws`, `azure`, `cloud_spanner`, `cloud_resource`, `salesforce_data_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
140
152
  # @!attribute [rw] salesforce_data_cloud
141
153
  # @return [::Google::Cloud::Bigquery::Connection::V1::SalesforceDataCloudProperties]
142
154
  # Optional. Salesforce DataCloud properties. This field is intended for
143
155
  # use only by Salesforce partner projects. This field contains properties
144
156
  # for your Salesforce DataCloud connection.
157
+ #
158
+ # Note: The following fields are mutually exclusive: `salesforce_data_cloud`, `cloud_sql`, `aws`, `azure`, `cloud_spanner`, `cloud_resource`, `spark`. If a field in that set is populated, all other fields in the set will automatically be cleared.
145
159
  # @!attribute [r] creation_time
146
160
  # @return [::Integer]
147
161
  # Output only. The creation timestamp of the connection.
@@ -260,10 +274,14 @@ module Google
260
274
  # Authentication using Google owned AWS IAM user's access key to assume
261
275
  # into customer's AWS IAM Role.
262
276
  # Deprecated, do not use.
277
+ #
278
+ # Note: The following fields are mutually exclusive: `cross_account_role`, `access_role`. If a field in that set is populated, all other fields in the set will automatically be cleared.
263
279
  # @!attribute [rw] access_role
264
280
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsAccessRole]
265
281
  # Authentication using Google owned service account to assume into
266
282
  # customer's AWS IAM Role.
283
+ #
284
+ # Note: The following fields are mutually exclusive: `access_role`, `cross_account_role`. If a field in that set is populated, all other fields in the set will automatically be cleared.
267
285
  class AwsProperties
268
286
  include ::Google::Protobuf::MessageExts
269
287
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-connection-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
10
+ date: 2025-01-29 00:00:00.000000000 Z
12
11
  dependencies:
13
12
  - !ruby/object:Gem::Dependency
14
13
  name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
16
15
  requirements:
17
16
  - - ">="
18
17
  - !ruby/object:Gem::Version
19
- version: 0.21.1
18
+ version: 0.25.0
20
19
  - - "<"
21
20
  - !ruby/object:Gem::Version
22
21
  version: 2.a
@@ -26,7 +25,7 @@ dependencies:
26
25
  requirements:
27
26
  - - ">="
28
27
  - !ruby/object:Gem::Version
29
- version: 0.21.1
28
+ version: 0.25.0
30
29
  - - "<"
31
30
  - !ruby/object:Gem::Version
32
31
  version: 2.a
@@ -101,7 +100,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
101
100
  licenses:
102
101
  - Apache-2.0
103
102
  metadata: {}
104
- post_install_message:
105
103
  rdoc_options: []
106
104
  require_paths:
107
105
  - lib
@@ -109,15 +107,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
109
107
  requirements:
110
108
  - - ">="
111
109
  - !ruby/object:Gem::Version
112
- version: '2.7'
110
+ version: '3.0'
113
111
  required_rubygems_version: !ruby/object:Gem::Requirement
114
112
  requirements:
115
113
  - - ">="
116
114
  - !ruby/object:Gem::Version
117
115
  version: '0'
118
116
  requirements: []
119
- rubygems_version: 3.5.6
120
- signing_key:
117
+ rubygems_version: 3.6.2
121
118
  specification_version: 4
122
119
  summary: Allows users to manage BigQuery connections to external data sources.
123
120
  test_files: []