google-cloud-datastore-v1 0.6.0 → 0.8.0

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: 5756bbbfdf9b930addfb17ff508cd1ff58e698c1381a922a2a1d06c442cc3499
4
- data.tar.gz: '0087211fa2c48a1c58801db241b387eb29543cabe28c5eca2b290ab96c0370cd'
3
+ metadata.gz: c45c26b4609092449a125a9c82ea164e7a8cc8ae73dc4b221879fe2aec45d13e
4
+ data.tar.gz: d0949170d61b922ecde9f8ceda24e9d169afc6949b344e91c9d536d04aa50099
5
5
  SHA512:
6
- metadata.gz: df7ce1dd9962a3e286eab555739ccbd3223b937b53d98f0f68ed5a3b2b3d2e163832f7298e8202e08c961b18788a1de3e7ce8ceec3576009e7ec3522576fedf0
7
- data.tar.gz: e37399f05e9dae3dbec09a7c9f3d4d56cc525d76cda7ccf42b9da787246e387348f034bc5496e3c446c14a325eeba256adb01c4734fe6e85cea999d27c057452
6
+ metadata.gz: 7eee514105c9d4a2e2b98d5ff9948059d4c1b52f2770e2ad57843945f7dc89b8d61b383845125d7c1a070ddc2ae51c935db270237a90f7965657da0906698a94
7
+ data.tar.gz: ea3a3d81f08b5b8d7232405bae7e7f9ae53a01842121e6363f80e030749052bc186a3ea15fe07d076272541a392f67c753b7e3ab24fd27055e3fdbeecdcc1d67
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
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/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
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
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
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
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -77,6 +77,11 @@ module Google
77
77
  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
78
78
  }
79
79
 
80
+ default_config.rpcs.run_aggregation_query.timeout = 60.0
81
+ default_config.rpcs.run_aggregation_query.retry_policy = {
82
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
83
+ }
84
+
80
85
  default_config.rpcs.begin_transaction.timeout = 60.0
81
86
 
82
87
  default_config.rpcs.commit.timeout = 60.0
@@ -183,13 +188,18 @@ module Google
183
188
  # @param options [::Gapic::CallOptions, ::Hash]
184
189
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
185
190
  #
186
- # @overload lookup(project_id: nil, read_options: nil, keys: nil)
191
+ # @overload lookup(project_id: nil, database_id: nil, read_options: nil, keys: nil)
187
192
  # Pass arguments to `lookup` via keyword arguments. Note that at
188
193
  # least one keyword argument is required. To specify no parameters, or to keep all
189
194
  # the default parameter values, pass an empty Hash as a request object (see above).
190
195
  #
191
196
  # @param project_id [::String]
192
197
  # Required. The ID of the project against which to make the request.
198
+ # @param database_id [::String]
199
+ # The ID of the database against which to make the request.
200
+ #
201
+ # '(default)' is not allowed; please use empty string '' to refer the default
202
+ # database.
193
203
  # @param read_options [::Google::Cloud::Datastore::V1::ReadOptions, ::Hash]
194
204
  # The options for this lookup request.
195
205
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
@@ -236,11 +246,14 @@ module Google
236
246
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
237
247
 
238
248
  header_params = {}
239
- if request.project_id
249
+ if request.project_id && !request.project_id.empty?
240
250
  header_params["project_id"] = request.project_id
241
251
  end
252
+ if request.database_id && !request.database_id.empty?
253
+ header_params["database_id"] = request.database_id
254
+ end
242
255
 
243
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
256
+ request_params_header = URI.encode_www_form header_params
244
257
  metadata[:"x-goog-request-params"] ||= request_params_header
245
258
 
246
259
  options.apply_defaults timeout: @config.rpcs.lookup.timeout,
@@ -272,13 +285,18 @@ module Google
272
285
  # @param options [::Gapic::CallOptions, ::Hash]
273
286
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
274
287
  #
275
- # @overload run_query(project_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil)
288
+ # @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil)
276
289
  # Pass arguments to `run_query` via keyword arguments. Note that at
277
290
  # least one keyword argument is required. To specify no parameters, or to keep all
278
291
  # the default parameter values, pass an empty Hash as a request object (see above).
279
292
  #
280
293
  # @param project_id [::String]
281
294
  # Required. The ID of the project against which to make the request.
295
+ # @param database_id [::String]
296
+ # The ID of the database against which to make the request.
297
+ #
298
+ # '(default)' is not allowed; please use empty string '' to refer the default
299
+ # database.
282
300
  # @param partition_id [::Google::Cloud::Datastore::V1::PartitionId, ::Hash]
283
301
  # Entities are partitioned into subsets, identified by a partition ID.
284
302
  # Queries are scoped to a single partition.
@@ -289,7 +307,7 @@ module Google
289
307
  # @param query [::Google::Cloud::Datastore::V1::Query, ::Hash]
290
308
  # The query to run.
291
309
  # @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
292
- # The GQL query to run.
310
+ # The GQL query to run. This query must be a non-aggregation query.
293
311
  #
294
312
  # @yield [response, operation] Access the result along with the RPC operation
295
313
  # @yieldparam response [::Google::Cloud::Datastore::V1::RunQueryResponse]
@@ -332,11 +350,14 @@ module Google
332
350
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
333
351
 
334
352
  header_params = {}
335
- if request.project_id
353
+ if request.project_id && !request.project_id.empty?
336
354
  header_params["project_id"] = request.project_id
337
355
  end
356
+ if request.database_id && !request.database_id.empty?
357
+ header_params["database_id"] = request.database_id
358
+ end
338
359
 
339
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
360
+ request_params_header = URI.encode_www_form header_params
340
361
  metadata[:"x-goog-request-params"] ||= request_params_header
341
362
 
342
363
  options.apply_defaults timeout: @config.rpcs.run_query.timeout,
@@ -355,6 +376,110 @@ module Google
355
376
  raise ::Google::Cloud::Error.from_error(e)
356
377
  end
357
378
 
379
+ ##
380
+ # Runs an aggregation query.
381
+ #
382
+ # @overload run_aggregation_query(request, options = nil)
383
+ # Pass arguments to `run_aggregation_query` via a request object, either of type
384
+ # {::Google::Cloud::Datastore::V1::RunAggregationQueryRequest} or an equivalent Hash.
385
+ #
386
+ # @param request [::Google::Cloud::Datastore::V1::RunAggregationQueryRequest, ::Hash]
387
+ # A request object representing the call parameters. Required. To specify no
388
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
389
+ # @param options [::Gapic::CallOptions, ::Hash]
390
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
391
+ #
392
+ # @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil)
393
+ # Pass arguments to `run_aggregation_query` via keyword arguments. Note that at
394
+ # least one keyword argument is required. To specify no parameters, or to keep all
395
+ # the default parameter values, pass an empty Hash as a request object (see above).
396
+ #
397
+ # @param project_id [::String]
398
+ # Required. The ID of the project against which to make the request.
399
+ # @param database_id [::String]
400
+ # The ID of the database against which to make the request.
401
+ #
402
+ # '(default)' is not allowed; please use empty string '' to refer the default
403
+ # database.
404
+ # @param partition_id [::Google::Cloud::Datastore::V1::PartitionId, ::Hash]
405
+ # Entities are partitioned into subsets, identified by a partition ID.
406
+ # Queries are scoped to a single partition.
407
+ # This partition ID is normalized with the standard default context
408
+ # partition ID.
409
+ # @param read_options [::Google::Cloud::Datastore::V1::ReadOptions, ::Hash]
410
+ # The options for this query.
411
+ # @param aggregation_query [::Google::Cloud::Datastore::V1::AggregationQuery, ::Hash]
412
+ # The query to run.
413
+ # @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
414
+ # The GQL query to run. This query must be an aggregation query.
415
+ #
416
+ # @yield [response, operation] Access the result along with the RPC operation
417
+ # @yieldparam response [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
418
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
419
+ #
420
+ # @return [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
421
+ #
422
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
423
+ #
424
+ # @example Basic example
425
+ # require "google/cloud/datastore/v1"
426
+ #
427
+ # # Create a client object. The client can be reused for multiple calls.
428
+ # client = Google::Cloud::Datastore::V1::Datastore::Client.new
429
+ #
430
+ # # Create a request. To set request fields, pass in keyword arguments.
431
+ # request = Google::Cloud::Datastore::V1::RunAggregationQueryRequest.new
432
+ #
433
+ # # Call the run_aggregation_query method.
434
+ # result = client.run_aggregation_query request
435
+ #
436
+ # # The returned object is of type Google::Cloud::Datastore::V1::RunAggregationQueryResponse.
437
+ # p result
438
+ #
439
+ def run_aggregation_query request, options = nil
440
+ raise ::ArgumentError, "request must be provided" if request.nil?
441
+
442
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Datastore::V1::RunAggregationQueryRequest
443
+
444
+ # Converts hash and nil to an options object
445
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
446
+
447
+ # Customize the options with defaults
448
+ metadata = @config.rpcs.run_aggregation_query.metadata.to_h
449
+
450
+ # Set x-goog-api-client and x-goog-user-project headers
451
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
452
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
453
+ gapic_version: ::Google::Cloud::Datastore::V1::VERSION
454
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
455
+
456
+ header_params = {}
457
+ if request.project_id && !request.project_id.empty?
458
+ header_params["project_id"] = request.project_id
459
+ end
460
+ if request.database_id && !request.database_id.empty?
461
+ header_params["database_id"] = request.database_id
462
+ end
463
+
464
+ request_params_header = URI.encode_www_form header_params
465
+ metadata[:"x-goog-request-params"] ||= request_params_header
466
+
467
+ options.apply_defaults timeout: @config.rpcs.run_aggregation_query.timeout,
468
+ metadata: metadata,
469
+ retry_policy: @config.rpcs.run_aggregation_query.retry_policy
470
+
471
+ options.apply_defaults timeout: @config.timeout,
472
+ metadata: @config.metadata,
473
+ retry_policy: @config.retry_policy
474
+
475
+ @datastore_stub.call_rpc :run_aggregation_query, request, options: options do |response, operation|
476
+ yield response, operation if block_given?
477
+ return response
478
+ end
479
+ rescue ::GRPC::BadStatus => e
480
+ raise ::Google::Cloud::Error.from_error(e)
481
+ end
482
+
358
483
  ##
359
484
  # Begins a new transaction.
360
485
  #
@@ -368,13 +493,18 @@ module Google
368
493
  # @param options [::Gapic::CallOptions, ::Hash]
369
494
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
370
495
  #
371
- # @overload begin_transaction(project_id: nil, transaction_options: nil)
496
+ # @overload begin_transaction(project_id: nil, database_id: nil, transaction_options: nil)
372
497
  # Pass arguments to `begin_transaction` via keyword arguments. Note that at
373
498
  # least one keyword argument is required. To specify no parameters, or to keep all
374
499
  # the default parameter values, pass an empty Hash as a request object (see above).
375
500
  #
376
501
  # @param project_id [::String]
377
502
  # Required. The ID of the project against which to make the request.
503
+ # @param database_id [::String]
504
+ # The ID of the database against which to make the request.
505
+ #
506
+ # '(default)' is not allowed; please use empty string '' to refer the default
507
+ # database.
378
508
  # @param transaction_options [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
379
509
  # Options for a new transaction.
380
510
  #
@@ -419,11 +549,14 @@ module Google
419
549
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
420
550
 
421
551
  header_params = {}
422
- if request.project_id
552
+ if request.project_id && !request.project_id.empty?
423
553
  header_params["project_id"] = request.project_id
424
554
  end
555
+ if request.database_id && !request.database_id.empty?
556
+ header_params["database_id"] = request.database_id
557
+ end
425
558
 
426
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
559
+ request_params_header = URI.encode_www_form header_params
427
560
  metadata[:"x-goog-request-params"] ||= request_params_header
428
561
 
429
562
  options.apply_defaults timeout: @config.rpcs.begin_transaction.timeout,
@@ -456,13 +589,18 @@ module Google
456
589
  # @param options [::Gapic::CallOptions, ::Hash]
457
590
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
458
591
  #
459
- # @overload commit(project_id: nil, mode: nil, transaction: nil, mutations: nil)
592
+ # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, mutations: nil)
460
593
  # Pass arguments to `commit` via keyword arguments. Note that at
461
594
  # least one keyword argument is required. To specify no parameters, or to keep all
462
595
  # the default parameter values, pass an empty Hash as a request object (see above).
463
596
  #
464
597
  # @param project_id [::String]
465
598
  # Required. The ID of the project against which to make the request.
599
+ # @param database_id [::String]
600
+ # The ID of the database against which to make the request.
601
+ #
602
+ # '(default)' is not allowed; please use empty string '' to refer the default
603
+ # database.
466
604
  # @param mode [::Google::Cloud::Datastore::V1::CommitRequest::Mode]
467
605
  # The type of commit to perform. Defaults to `TRANSACTIONAL`.
468
606
  # @param transaction [::String]
@@ -525,11 +663,14 @@ module Google
525
663
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
526
664
 
527
665
  header_params = {}
528
- if request.project_id
666
+ if request.project_id && !request.project_id.empty?
529
667
  header_params["project_id"] = request.project_id
530
668
  end
669
+ if request.database_id && !request.database_id.empty?
670
+ header_params["database_id"] = request.database_id
671
+ end
531
672
 
532
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
673
+ request_params_header = URI.encode_www_form header_params
533
674
  metadata[:"x-goog-request-params"] ||= request_params_header
534
675
 
535
676
  options.apply_defaults timeout: @config.rpcs.commit.timeout,
@@ -561,13 +702,18 @@ module Google
561
702
  # @param options [::Gapic::CallOptions, ::Hash]
562
703
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
563
704
  #
564
- # @overload rollback(project_id: nil, transaction: nil)
705
+ # @overload rollback(project_id: nil, database_id: nil, transaction: nil)
565
706
  # Pass arguments to `rollback` via keyword arguments. Note that at
566
707
  # least one keyword argument is required. To specify no parameters, or to keep all
567
708
  # the default parameter values, pass an empty Hash as a request object (see above).
568
709
  #
569
710
  # @param project_id [::String]
570
711
  # Required. The ID of the project against which to make the request.
712
+ # @param database_id [::String]
713
+ # The ID of the database against which to make the request.
714
+ #
715
+ # '(default)' is not allowed; please use empty string '' to refer the default
716
+ # database.
571
717
  # @param transaction [::String]
572
718
  # Required. The transaction identifier, returned by a call to
573
719
  # {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
@@ -613,11 +759,14 @@ module Google
613
759
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
614
760
 
615
761
  header_params = {}
616
- if request.project_id
762
+ if request.project_id && !request.project_id.empty?
617
763
  header_params["project_id"] = request.project_id
618
764
  end
765
+ if request.database_id && !request.database_id.empty?
766
+ header_params["database_id"] = request.database_id
767
+ end
619
768
 
620
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
769
+ request_params_header = URI.encode_www_form header_params
621
770
  metadata[:"x-goog-request-params"] ||= request_params_header
622
771
 
623
772
  options.apply_defaults timeout: @config.rpcs.rollback.timeout,
@@ -650,16 +799,21 @@ module Google
650
799
  # @param options [::Gapic::CallOptions, ::Hash]
651
800
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
652
801
  #
653
- # @overload allocate_ids(project_id: nil, keys: nil)
802
+ # @overload allocate_ids(project_id: nil, database_id: nil, keys: nil)
654
803
  # Pass arguments to `allocate_ids` via keyword arguments. Note that at
655
804
  # least one keyword argument is required. To specify no parameters, or to keep all
656
805
  # the default parameter values, pass an empty Hash as a request object (see above).
657
806
  #
658
807
  # @param project_id [::String]
659
808
  # Required. The ID of the project against which to make the request.
809
+ # @param database_id [::String]
810
+ # The ID of the database against which to make the request.
811
+ #
812
+ # '(default)' is not allowed; please use empty string '' to refer the default
813
+ # database.
660
814
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
661
- # Required. A list of keys with incomplete key paths for which to allocate IDs.
662
- # No key may be reserved/read-only.
815
+ # Required. A list of keys with incomplete key paths for which to allocate
816
+ # IDs. No key may be reserved/read-only.
663
817
  #
664
818
  # @yield [response, operation] Access the result along with the RPC operation
665
819
  # @yieldparam response [::Google::Cloud::Datastore::V1::AllocateIdsResponse]
@@ -702,11 +856,14 @@ module Google
702
856
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
703
857
 
704
858
  header_params = {}
705
- if request.project_id
859
+ if request.project_id && !request.project_id.empty?
706
860
  header_params["project_id"] = request.project_id
707
861
  end
862
+ if request.database_id && !request.database_id.empty?
863
+ header_params["database_id"] = request.database_id
864
+ end
708
865
 
709
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
866
+ request_params_header = URI.encode_www_form header_params
710
867
  metadata[:"x-goog-request-params"] ||= request_params_header
711
868
 
712
869
  options.apply_defaults timeout: @config.rpcs.allocate_ids.timeout,
@@ -747,10 +904,13 @@ module Google
747
904
  # @param project_id [::String]
748
905
  # Required. The ID of the project against which to make the request.
749
906
  # @param database_id [::String]
750
- # If not empty, the ID of the database against which to make the request.
907
+ # The ID of the database against which to make the request.
908
+ #
909
+ # '(default)' is not allowed; please use empty string '' to refer the default
910
+ # database.
751
911
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
752
- # Required. A list of keys with complete key paths whose numeric IDs should not be
753
- # auto-allocated.
912
+ # Required. A list of keys with complete key paths whose numeric IDs should
913
+ # not be auto-allocated.
754
914
  #
755
915
  # @yield [response, operation] Access the result along with the RPC operation
756
916
  # @yieldparam response [::Google::Cloud::Datastore::V1::ReserveIdsResponse]
@@ -793,11 +953,14 @@ module Google
793
953
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
794
954
 
795
955
  header_params = {}
796
- if request.project_id
956
+ if request.project_id && !request.project_id.empty?
797
957
  header_params["project_id"] = request.project_id
798
958
  end
959
+ if request.database_id && !request.database_id.empty?
960
+ header_params["database_id"] = request.database_id
961
+ end
799
962
 
800
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
963
+ request_params_header = URI.encode_www_form header_params
801
964
  metadata[:"x-goog-request-params"] ||= request_params_header
802
965
 
803
966
  options.apply_defaults timeout: @config.rpcs.reserve_ids.timeout,
@@ -962,6 +1125,11 @@ module Google
962
1125
  #
963
1126
  attr_reader :run_query
964
1127
  ##
1128
+ # RPC-specific configuration for `run_aggregation_query`
1129
+ # @return [::Gapic::Config::Method]
1130
+ #
1131
+ attr_reader :run_aggregation_query
1132
+ ##
965
1133
  # RPC-specific configuration for `begin_transaction`
966
1134
  # @return [::Gapic::Config::Method]
967
1135
  #
@@ -993,6 +1161,8 @@ module Google
993
1161
  @lookup = ::Gapic::Config::Method.new lookup_config
994
1162
  run_query_config = parent_rpcs.run_query if parent_rpcs.respond_to? :run_query
995
1163
  @run_query = ::Gapic::Config::Method.new run_query_config
1164
+ run_aggregation_query_config = parent_rpcs.run_aggregation_query if parent_rpcs.respond_to? :run_aggregation_query
1165
+ @run_aggregation_query = ::Gapic::Config::Method.new run_aggregation_query_config
996
1166
  begin_transaction_config = parent_rpcs.begin_transaction if parent_rpcs.respond_to? :begin_transaction
997
1167
  @begin_transaction = ::Gapic::Config::Method.new begin_transaction_config
998
1168
  commit_config = parent_rpcs.commit if parent_rpcs.respond_to? :commit
@@ -37,7 +37,7 @@ module Google
37
37
  # input keys sets the project ID (if not already set) to the project ID from
38
38
  # the request.
39
39
  #
40
- # To load this service and instantiate a client:
40
+ # @example Load this service and instantiate a gRPC client
41
41
  #
42
42
  # require "google/cloud/datastore/v1/datastore"
43
43
  # client = ::Google::Cloud::Datastore::V1::Datastore::Client.new
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Datastore
23
23
  module V1
24
- VERSION = "0.6.0"
24
+ VERSION = "0.8.0"
25
25
  end
26
26
  end
27
27
  end
@@ -23,9 +23,9 @@ module Google
23
23
  module Cloud
24
24
  module Datastore
25
25
  ##
26
- # To load this package, including all its services, and instantiate a client:
26
+ # API client module.
27
27
  #
28
- # @example
28
+ # @example Load this package, including all its services, and instantiate a gRPC client
29
29
  #
30
30
  # require "google/cloud/datastore/v1"
31
31
  # client = ::Google::Cloud::Datastore::V1::Datastore::Client.new
@@ -0,0 +1,32 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/datastore/v1/aggregation_result.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/datastore/v1/entity_pb'
7
+ require 'google/datastore/v1/query_pb'
8
+ require 'google/protobuf/timestamp_pb'
9
+
10
+ Google::Protobuf::DescriptorPool.generated_pool.build do
11
+ add_file("google/datastore/v1/aggregation_result.proto", :syntax => :proto3) do
12
+ add_message "google.datastore.v1.AggregationResult" do
13
+ map :aggregate_properties, :string, :message, 2, "google.datastore.v1.Value"
14
+ end
15
+ add_message "google.datastore.v1.AggregationResultBatch" do
16
+ repeated :aggregation_results, :message, 1, "google.datastore.v1.AggregationResult"
17
+ optional :more_results, :enum, 2, "google.datastore.v1.QueryResultBatch.MoreResultsType"
18
+ optional :read_time, :message, 3, "google.protobuf.Timestamp"
19
+ end
20
+ end
21
+ end
22
+
23
+ module Google
24
+ module Cloud
25
+ module Datastore
26
+ module V1
27
+ AggregationResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.AggregationResult").msgclass
28
+ AggregationResultBatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.AggregationResultBatch").msgclass
29
+ end
30
+ end
31
+ end
32
+ end
@@ -6,6 +6,8 @@ require 'google/protobuf'
6
6
  require 'google/api/annotations_pb'
7
7
  require 'google/api/client_pb'
8
8
  require 'google/api/field_behavior_pb'
9
+ require 'google/api/routing_pb'
10
+ require 'google/datastore/v1/aggregation_result_pb'
9
11
  require 'google/datastore/v1/entity_pb'
10
12
  require 'google/datastore/v1/query_pb'
11
13
  require 'google/protobuf/timestamp_pb'
@@ -14,6 +16,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
14
16
  add_file("google/datastore/v1/datastore.proto", :syntax => :proto3) do
15
17
  add_message "google.datastore.v1.LookupRequest" do
16
18
  optional :project_id, :string, 8
19
+ optional :database_id, :string, 9
17
20
  optional :read_options, :message, 1, "google.datastore.v1.ReadOptions"
18
21
  repeated :keys, :message, 3, "google.datastore.v1.Key"
19
22
  end
@@ -25,6 +28,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
25
28
  end
26
29
  add_message "google.datastore.v1.RunQueryRequest" do
27
30
  optional :project_id, :string, 8
31
+ optional :database_id, :string, 9
28
32
  optional :partition_id, :message, 2, "google.datastore.v1.PartitionId"
29
33
  optional :read_options, :message, 1, "google.datastore.v1.ReadOptions"
30
34
  oneof :query_type do
@@ -36,8 +40,23 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
36
40
  optional :batch, :message, 1, "google.datastore.v1.QueryResultBatch"
37
41
  optional :query, :message, 2, "google.datastore.v1.Query"
38
42
  end
43
+ add_message "google.datastore.v1.RunAggregationQueryRequest" do
44
+ optional :project_id, :string, 8
45
+ optional :database_id, :string, 9
46
+ optional :partition_id, :message, 2, "google.datastore.v1.PartitionId"
47
+ optional :read_options, :message, 1, "google.datastore.v1.ReadOptions"
48
+ oneof :query_type do
49
+ optional :aggregation_query, :message, 3, "google.datastore.v1.AggregationQuery"
50
+ optional :gql_query, :message, 7, "google.datastore.v1.GqlQuery"
51
+ end
52
+ end
53
+ add_message "google.datastore.v1.RunAggregationQueryResponse" do
54
+ optional :batch, :message, 1, "google.datastore.v1.AggregationResultBatch"
55
+ optional :query, :message, 2, "google.datastore.v1.AggregationQuery"
56
+ end
39
57
  add_message "google.datastore.v1.BeginTransactionRequest" do
40
58
  optional :project_id, :string, 8
59
+ optional :database_id, :string, 9
41
60
  optional :transaction_options, :message, 10, "google.datastore.v1.TransactionOptions"
42
61
  end
43
62
  add_message "google.datastore.v1.BeginTransactionResponse" do
@@ -45,12 +64,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
45
64
  end
46
65
  add_message "google.datastore.v1.RollbackRequest" do
47
66
  optional :project_id, :string, 8
67
+ optional :database_id, :string, 9
48
68
  optional :transaction, :bytes, 1
49
69
  end
50
70
  add_message "google.datastore.v1.RollbackResponse" do
51
71
  end
52
72
  add_message "google.datastore.v1.CommitRequest" do
53
73
  optional :project_id, :string, 8
74
+ optional :database_id, :string, 9
54
75
  optional :mode, :enum, 5, "google.datastore.v1.CommitRequest.Mode"
55
76
  repeated :mutations, :message, 6, "google.datastore.v1.Mutation"
56
77
  oneof :transaction_selector do
@@ -69,6 +90,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
69
90
  end
70
91
  add_message "google.datastore.v1.AllocateIdsRequest" do
71
92
  optional :project_id, :string, 8
93
+ optional :database_id, :string, 9
72
94
  repeated :keys, :message, 1, "google.datastore.v1.Key"
73
95
  end
74
96
  add_message "google.datastore.v1.AllocateIdsResponse" do
@@ -134,6 +156,8 @@ module Google
134
156
  LookupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.LookupResponse").msgclass
135
157
  RunQueryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RunQueryRequest").msgclass
136
158
  RunQueryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RunQueryResponse").msgclass
159
+ RunAggregationQueryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RunAggregationQueryRequest").msgclass
160
+ RunAggregationQueryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RunAggregationQueryResponse").msgclass
137
161
  BeginTransactionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.BeginTransactionRequest").msgclass
138
162
  BeginTransactionResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.BeginTransactionResponse").msgclass
139
163
  RollbackRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RollbackRequest").msgclass
@@ -43,6 +43,8 @@ module Google
43
43
  rpc :Lookup, ::Google::Cloud::Datastore::V1::LookupRequest, ::Google::Cloud::Datastore::V1::LookupResponse
44
44
  # Queries for entities.
45
45
  rpc :RunQuery, ::Google::Cloud::Datastore::V1::RunQueryRequest, ::Google::Cloud::Datastore::V1::RunQueryResponse
46
+ # Runs an aggregation query.
47
+ rpc :RunAggregationQuery, ::Google::Cloud::Datastore::V1::RunAggregationQueryRequest, ::Google::Cloud::Datastore::V1::RunAggregationQueryResponse
46
48
  # Begins a new transaction.
47
49
  rpc :BeginTransaction, ::Google::Cloud::Datastore::V1::BeginTransactionRequest, ::Google::Cloud::Datastore::V1::BeginTransactionResponse
48
50
  # Commits a transaction, optionally creating, deleting or modifying some
@@ -11,6 +11,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
11
11
  add_file("google/datastore/v1/entity.proto", :syntax => :proto3) do
12
12
  add_message "google.datastore.v1.PartitionId" do
13
13
  optional :project_id, :string, 2
14
+ optional :database_id, :string, 3
14
15
  optional :namespace_id, :string, 4
15
16
  end
16
17
  add_message "google.datastore.v1.Key" do
@@ -3,6 +3,7 @@
3
3
 
4
4
  require 'google/protobuf'
5
5
 
6
+ require 'google/api/field_behavior_pb'
6
7
  require 'google/datastore/v1/entity_pb'
7
8
  require 'google/protobuf/timestamp_pb'
8
9
  require 'google/protobuf/wrappers_pb'
@@ -32,6 +33,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
32
33
  optional :offset, :int32, 10
33
34
  optional :limit, :message, 12, "google.protobuf.Int32Value"
34
35
  end
36
+ add_message "google.datastore.v1.AggregationQuery" do
37
+ repeated :aggregations, :message, 3, "google.datastore.v1.AggregationQuery.Aggregation"
38
+ oneof :query_type do
39
+ optional :nested_query, :message, 1, "google.datastore.v1.Query"
40
+ end
41
+ end
42
+ add_message "google.datastore.v1.AggregationQuery.Aggregation" do
43
+ optional :alias, :string, 7
44
+ oneof :operator do
45
+ optional :count, :message, 1, "google.datastore.v1.AggregationQuery.Aggregation.Count"
46
+ end
47
+ end
48
+ add_message "google.datastore.v1.AggregationQuery.Aggregation.Count" do
49
+ optional :up_to, :message, 1, "google.protobuf.Int64Value"
50
+ end
35
51
  add_message "google.datastore.v1.KindExpression" do
36
52
  optional :name, :string, 1
37
53
  end
@@ -120,6 +136,9 @@ module Google
120
136
  EntityResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.EntityResult").msgclass
121
137
  EntityResult::ResultType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.EntityResult.ResultType").enummodule
122
138
  Query = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.Query").msgclass
139
+ AggregationQuery = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.AggregationQuery").msgclass
140
+ AggregationQuery::Aggregation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.AggregationQuery.Aggregation").msgclass
141
+ AggregationQuery::Aggregation::Count = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.AggregationQuery.Aggregation.Count").msgclass
123
142
  KindExpression = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.KindExpression").msgclass
124
143
  PropertyReference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.PropertyReference").msgclass
125
144
  Projection = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.Projection").msgclass