google-cloud-bigquery-storage-v1 0.8.0 → 0.8.1

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.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/bigquery/storage/v1/big_query_read/client.rb +63 -9
  3. data/lib/google/cloud/bigquery/storage/v1/big_query_write/client.rb +124 -15
  4. data/lib/google/cloud/bigquery/storage/v1/version.rb +1 -1
  5. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6693e2ad11b7bf193b9fc692f91d7ffb59251df9fa28ba3ea24f6e77e385bba1
4
- data.tar.gz: d52647196c983df0ae4cba7fe40267b3ef1d394693257a35a6eefa1b5f75502c
3
+ metadata.gz: ff39be0c1b0dfb6fbab5badfa076d2d9ee567a741fc30c48aa293cbc7ff07f5d
4
+ data.tar.gz: 66f5972871629dbce68c38fe523fcd28bf8e202f03b6342309fe19921149067d
5
5
  SHA512:
6
- metadata.gz: 1a384535064401bb446fc3464358e076be4f6c99dd3d16e15e43e1d73c5d165dbc3cd2e3176dd9ccba0ca7eb728dca959bc26103e88ac433bd3fd3ce14edb4d1
7
- data.tar.gz: 338a6b1f618ec95fcd662d0b033b0543324e0de62660e51972a52d3872f7c7071387e055474abd2877c2cd75768407f35d3535e6064cafcd284673d815d4f20d
6
+ metadata.gz: 3606ce4b938d2b6d6e6881cfe3af07c0198eb64d2588561332413f998eef33cb7041d6c95eb1902c703852639a9b1836131c896eae4144cec3cadd37d55a404a
7
+ data.tar.gz: eda0cb59794e4ef3738688149ac1a8c143f4fac3866ed4f6bb500de8d7636f3ac3bfbdebde96e48df21de4a69b728235f8c64dd23ac88672e44cc441a102cc6f
data/lib/google/cloud/bigquery/storage/v1/big_query_read/client.rb CHANGED
@@ -221,6 +221,21 @@ module Google
221
221
  #
222
222
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
223
223
  #
224
+ # @example Basic example
225
+ # require "google/cloud/bigquery/storage/v1"
226
+ #
227
+ # # Create a client object. The client can be reused for multiple calls.
228
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryRead::Client.new
229
+ #
230
+ # # Create a request. To set request fields, pass in keyword arguments.
231
+ # request = Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest.new
232
+ #
233
+ # # Call the create_read_session method.
234
+ # result = client.create_read_session request
235
+ #
236
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::ReadSession.
237
+ # p result
238
+ #
224
239
  def create_read_session request, options = nil
225
240
  raise ::ArgumentError, "request must be provided" if request.nil?
226
241
 
@@ -238,9 +253,11 @@ module Google
238
253
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
239
254
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
240
255
 
241
- header_params = {
242
- "read_session.table" => request.read_session.table
243
- }
256
+ header_params = {}
257
+ if request.read_session&.table
258
+ header_params["read_session.table"] = request.read_session.table
259
+ end
260
+
244
261
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
245
262
  metadata[:"x-goog-request-params"] ||= request_params_header
246
263
 
@@ -299,6 +316,24 @@ module Google
299
316
  #
300
317
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
301
318
  #
319
+ # @example Basic example
320
+ # require "google/cloud/bigquery/storage/v1"
321
+ #
322
+ # # Create a client object. The client can be reused for multiple calls.
323
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryRead::Client.new
324
+ #
325
+ # # Create a request. To set request fields, pass in keyword arguments.
326
+ # request = Google::Cloud::Bigquery::Storage::V1::ReadRowsRequest.new
327
+ #
328
+ # # Call the read_rows method.
329
+ # result = client.read_rows request
330
+ #
331
+ # # The returned object is a streamed enumerable yielding elements of
332
+ # # type ::Google::Cloud::Bigquery::Storage::V1::ReadRowsResponse.
333
+ # result.each do |response|
334
+ # p response
335
+ # end
336
+ #
302
337
  def read_rows request, options = nil
303
338
  raise ::ArgumentError, "request must be provided" if request.nil?
304
339
 
@@ -316,9 +351,11 @@ module Google
316
351
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
317
352
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
318
353
 
319
- header_params = {
320
- "read_stream" => request.read_stream
321
- }
354
+ header_params = {}
355
+ if request.read_stream
356
+ header_params["read_stream"] = request.read_stream
357
+ end
358
+
322
359
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
323
360
  metadata[:"x-goog-request-params"] ||= request_params_header
324
361
 
@@ -386,6 +423,21 @@ module Google
386
423
  #
387
424
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
388
425
  #
426
+ # @example Basic example
427
+ # require "google/cloud/bigquery/storage/v1"
428
+ #
429
+ # # Create a client object. The client can be reused for multiple calls.
430
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryRead::Client.new
431
+ #
432
+ # # Create a request. To set request fields, pass in keyword arguments.
433
+ # request = Google::Cloud::Bigquery::Storage::V1::SplitReadStreamRequest.new
434
+ #
435
+ # # Call the split_read_stream method.
436
+ # result = client.split_read_stream request
437
+ #
438
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::SplitReadStreamResponse.
439
+ # p result
440
+ #
389
441
  def split_read_stream request, options = nil
390
442
  raise ::ArgumentError, "request must be provided" if request.nil?
391
443
 
@@ -403,9 +455,11 @@ module Google
403
455
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
404
456
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
405
457
 
406
- header_params = {
407
- "name" => request.name
408
- }
458
+ header_params = {}
459
+ if request.name
460
+ header_params["name"] = request.name
461
+ end
462
+
409
463
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
410
464
  metadata[:"x-goog-request-params"] ||= request_params_header
411
465
 
data/lib/google/cloud/bigquery/storage/v1/big_query_write/client.rb CHANGED
@@ -217,6 +217,21 @@ module Google
217
217
  #
218
218
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
219
219
  #
220
+ # @example Basic example
221
+ # require "google/cloud/bigquery/storage/v1"
222
+ #
223
+ # # Create a client object. The client can be reused for multiple calls.
224
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
225
+ #
226
+ # # Create a request. To set request fields, pass in keyword arguments.
227
+ # request = Google::Cloud::Bigquery::Storage::V1::CreateWriteStreamRequest.new
228
+ #
229
+ # # Call the create_write_stream method.
230
+ # result = client.create_write_stream request
231
+ #
232
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::WriteStream.
233
+ # p result
234
+ #
220
235
  def create_write_stream request, options = nil
221
236
  raise ::ArgumentError, "request must be provided" if request.nil?
222
237
 
@@ -234,9 +249,11 @@ module Google
234
249
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
235
250
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
236
251
 
237
- header_params = {
238
- "parent" => request.parent
239
- }
252
+ header_params = {}
253
+ if request.parent
254
+ header_params["parent"] = request.parent
255
+ end
256
+
240
257
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
241
258
  metadata[:"x-goog-request-params"] ||= request_params_header
242
259
 
@@ -302,6 +319,30 @@ module Google
302
319
  #
303
320
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
304
321
  #
322
+ # @example Basic example
323
+ # require "google/cloud/bigquery/storage/v1"
324
+ #
325
+ # # Create a client object. The client can be reused for multiple calls.
326
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
327
+ #
328
+ # # Create an input stream
329
+ # input = Gapic::StreamInput.new
330
+ #
331
+ # # Call the append_rows method to start streaming.
332
+ # output = client.append_rows input
333
+ #
334
+ # # Send requests on the stream. For each request, pass in keyword
335
+ # # arguments to set fields. Be sure to close the stream when done.
336
+ # input << Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest.new
337
+ # input << Google::Cloud::Bigquery::Storage::V1::AppendRowsRequest.new
338
+ # input.close
339
+ #
340
+ # # Handle streamed responses. These may be interleaved with inputs.
341
+ # # Each response is of type ::Google::Cloud::Bigquery::Storage::V1::AppendRowsResponse.
342
+ # output.each do |response|
343
+ # p response
344
+ # end
345
+ #
305
346
  def append_rows request, options = nil
306
347
  unless request.is_a? ::Enumerable
307
348
  raise ::ArgumentError, "request must be an Enumerable" unless request.respond_to? :to_enum
@@ -370,6 +411,21 @@ module Google
370
411
  #
371
412
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
372
413
  #
414
+ # @example Basic example
415
+ # require "google/cloud/bigquery/storage/v1"
416
+ #
417
+ # # Create a client object. The client can be reused for multiple calls.
418
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
419
+ #
420
+ # # Create a request. To set request fields, pass in keyword arguments.
421
+ # request = Google::Cloud::Bigquery::Storage::V1::GetWriteStreamRequest.new
422
+ #
423
+ # # Call the get_write_stream method.
424
+ # result = client.get_write_stream request
425
+ #
426
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::WriteStream.
427
+ # p result
428
+ #
373
429
  def get_write_stream request, options = nil
374
430
  raise ::ArgumentError, "request must be provided" if request.nil?
375
431
 
@@ -387,9 +443,11 @@ module Google
387
443
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
388
444
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
389
445
 
390
- header_params = {
391
- "name" => request.name
392
- }
446
+ header_params = {}
447
+ if request.name
448
+ header_params["name"] = request.name
449
+ end
450
+
393
451
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
394
452
  metadata[:"x-goog-request-params"] ||= request_params_header
395
453
 
@@ -440,6 +498,21 @@ module Google
440
498
  #
441
499
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
442
500
  #
501
+ # @example Basic example
502
+ # require "google/cloud/bigquery/storage/v1"
503
+ #
504
+ # # Create a client object. The client can be reused for multiple calls.
505
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
506
+ #
507
+ # # Create a request. To set request fields, pass in keyword arguments.
508
+ # request = Google::Cloud::Bigquery::Storage::V1::FinalizeWriteStreamRequest.new
509
+ #
510
+ # # Call the finalize_write_stream method.
511
+ # result = client.finalize_write_stream request
512
+ #
513
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::FinalizeWriteStreamResponse.
514
+ # p result
515
+ #
443
516
  def finalize_write_stream request, options = nil
444
517
  raise ::ArgumentError, "request must be provided" if request.nil?
445
518
 
@@ -457,9 +530,11 @@ module Google
457
530
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
458
531
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
459
532
 
460
- header_params = {
461
- "name" => request.name
462
- }
533
+ header_params = {}
534
+ if request.name
535
+ header_params["name"] = request.name
536
+ end
537
+
463
538
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
464
539
  metadata[:"x-goog-request-params"] ||= request_params_header
465
540
 
@@ -516,6 +591,21 @@ module Google
516
591
  #
517
592
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
518
593
  #
594
+ # @example Basic example
595
+ # require "google/cloud/bigquery/storage/v1"
596
+ #
597
+ # # Create a client object. The client can be reused for multiple calls.
598
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
599
+ #
600
+ # # Create a request. To set request fields, pass in keyword arguments.
601
+ # request = Google::Cloud::Bigquery::Storage::V1::BatchCommitWriteStreamsRequest.new
602
+ #
603
+ # # Call the batch_commit_write_streams method.
604
+ # result = client.batch_commit_write_streams request
605
+ #
606
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::BatchCommitWriteStreamsResponse.
607
+ # p result
608
+ #
519
609
  def batch_commit_write_streams request, options = nil
520
610
  raise ::ArgumentError, "request must be provided" if request.nil?
521
611
 
@@ -533,9 +623,11 @@ module Google
533
623
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
534
624
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
535
625
 
536
- header_params = {
537
- "parent" => request.parent
538
- }
626
+ header_params = {}
627
+ if request.parent
628
+ header_params["parent"] = request.parent
629
+ end
630
+
539
631
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
540
632
  metadata[:"x-goog-request-params"] ||= request_params_header
541
633
 
@@ -594,6 +686,21 @@ module Google
594
686
  #
595
687
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
596
688
  #
689
+ # @example Basic example
690
+ # require "google/cloud/bigquery/storage/v1"
691
+ #
692
+ # # Create a client object. The client can be reused for multiple calls.
693
+ # client = Google::Cloud::Bigquery::Storage::V1::BigQueryWrite::Client.new
694
+ #
695
+ # # Create a request. To set request fields, pass in keyword arguments.
696
+ # request = Google::Cloud::Bigquery::Storage::V1::FlushRowsRequest.new
697
+ #
698
+ # # Call the flush_rows method.
699
+ # result = client.flush_rows request
700
+ #
701
+ # # The returned object is of type Google::Cloud::Bigquery::Storage::V1::FlushRowsResponse.
702
+ # p result
703
+ #
597
704
  def flush_rows request, options = nil
598
705
  raise ::ArgumentError, "request must be provided" if request.nil?
599
706
 
@@ -611,9 +718,11 @@ module Google
611
718
  gapic_version: ::Google::Cloud::Bigquery::Storage::V1::VERSION
612
719
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
613
720
 
614
- header_params = {
615
- "write_stream" => request.write_stream
616
- }
721
+ header_params = {}
722
+ if request.write_stream
723
+ header_params["write_stream"] = request.write_stream
724
+ end
725
+
617
726
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
618
727
  metadata[:"x-goog-request-params"] ||= request_params_header
619
728
 
data/lib/google/cloud/bigquery/storage/v1/version.rb CHANGED
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Storage
24
24
  module V1
25
- VERSION = "0.8.0"
25
+ VERSION = "0.8.1"
26
26
  end
27
27
  end
28
28
  end
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.8.0
4
+ version: 0.8.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-10-18 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