google-cloud-spanner-v1 0.7.2 → 0.8.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.yardopts +1 -1
- data/AUTHENTICATION.md +7 -25
- data/README.md +1 -1
- data/lib/google/cloud/spanner/v1/spanner/client.rb +312 -45
- data/lib/google/cloud/spanner/v1/version.rb +1 -1
- data/lib/google/spanner/v1/commit_response_pb.rb +3 -3
- data/lib/google/spanner/v1/keys_pb.rb +2 -2
- data/lib/google/spanner/v1/mutation_pb.rb +3 -3
- data/lib/google/spanner/v1/query_plan_pb.rb +2 -2
- data/lib/google/spanner/v1/result_set_pb.rb +4 -3
- data/lib/google/spanner/v1/spanner_pb.rb +3 -3
- data/lib/google/spanner/v1/spanner_services_pb.rb +1 -1
- data/lib/google/spanner/v1/transaction_pb.rb +3 -3
- data/lib/google/spanner/v1/type_pb.rb +8 -2
- data/proto_docs/google/api/resource.rb +10 -71
- data/proto_docs/google/spanner/v1/commit_response.rb +2 -2
- data/proto_docs/google/spanner/v1/spanner.rb +3 -1
- data/proto_docs/google/spanner/v1/transaction.rb +19 -31
- data/proto_docs/google/spanner/v1/type.rb +33 -6
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: bb64f1bfd5d93cb49f610834908694139c4540d7aa6b012f06b609524aec2a90
|
4
|
+
data.tar.gz: '029130cb8fb140fee2322db3e98ac213c60d675910911f076d83dfb5fbc45b7e'
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 5a2326c249ef795ee99a06efe95142203c3cbadd446828b0242f803cd4760f9d347c17059e416a5547e04b441da70d7260e455231ecd1950a81ad4bb479a2166
|
7
|
+
data.tar.gz: bc1af7e8c96a743d38ce177adc96cffc1940d55bd90b3a4ef632388285425ba23d39a7f4d5cc2d8c5e78626f3cb8c5c3cbd48911019960ec8a9bc736822150ad
|
data/.yardopts
CHANGED
data/AUTHENTICATION.md
CHANGED
@@ -120,15 +120,6 @@ To configure your system for this, simply:
|
|
120
120
|
**NOTE:** This is _not_ recommended for running in production. The Cloud SDK
|
121
121
|
*should* only be used during development.
|
122
122
|
|
123
|
-
[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
|
124
|
-
[dev-console]: https://console.cloud.google.com/project
|
125
|
-
|
126
|
-
[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
|
127
|
-
|
128
|
-
[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
|
129
|
-
[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
|
130
|
-
[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
|
131
|
-
|
132
123
|
## Creating a Service Account
|
133
124
|
|
134
125
|
Google Cloud requires **Service Account Credentials** to
|
@@ -139,31 +130,22 @@ If you are not running this client within
|
|
139
130
|
[Google Cloud Platform environments](#google-cloud-platform-environments), you
|
140
131
|
need a Google Developers service account.
|
141
132
|
|
142
|
-
1. Visit the [Google
|
133
|
+
1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
|
143
134
|
2. Create a new project or click on an existing project.
|
144
|
-
3. Activate the
|
135
|
+
3. Activate the menu in the upper left and select **APIs & Services**. From
|
145
136
|
here, you will enable the APIs that your application requires.
|
146
137
|
|
147
|
-
![Enable the APIs that your application requires][enable-apis]
|
148
|
-
|
149
138
|
*Note: You may need to enable billing in order to use these services.*
|
150
139
|
|
151
140
|
4. Select **Credentials** from the side navigation.
|
152
141
|
|
153
|
-
|
154
|
-
|
155
|
-
![Create a new service account][create-new-service-account]
|
156
|
-
|
157
|
-
![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
|
158
|
-
|
159
|
-
Find the "Add credentials" drop down and select "Service account" to be
|
160
|
-
guided through downloading a new JSON key file.
|
142
|
+
Find the "Create credentials" drop down near the top of the page, and select
|
143
|
+
"Service account" to be guided through downloading a new JSON key file.
|
161
144
|
|
162
145
|
If you want to re-use an existing service account, you can easily generate a
|
163
|
-
new key file. Just select the account you wish to re-use,
|
164
|
-
|
165
|
-
|
166
|
-
![Re-use an existing service account][reuse-service-account]
|
146
|
+
new key file. Just select the account you wish to re-use, click the pencil
|
147
|
+
tool on the right side to edit the service account, select the **Keys** tab,
|
148
|
+
and then select **Add Key**.
|
167
149
|
|
168
150
|
The key file you download will be used by this library to authenticate API
|
169
151
|
requests and should be stored in a secure location.
|
data/README.md
CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Cloud::Spanner::V1::CreateSessionRequest.new # (request fiel
|
|
37
37
|
response = client.create_session request
|
38
38
|
```
|
39
39
|
|
40
|
-
View the [Client Library Documentation](https://
|
40
|
+
View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-spanner-v1/latest)
|
41
41
|
for class and method documentation.
|
42
42
|
|
43
43
|
See also the [Product Documentation](https://cloud.google.com/spanner)
|
@@ -265,6 +265,21 @@ module Google
|
|
265
265
|
#
|
266
266
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
267
267
|
#
|
268
|
+
# @example Basic example
|
269
|
+
# require "google/cloud/spanner/v1"
|
270
|
+
#
|
271
|
+
# # Create a client object. The client can be reused for multiple calls.
|
272
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
273
|
+
#
|
274
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
275
|
+
# request = Google::Cloud::Spanner::V1::CreateSessionRequest.new
|
276
|
+
#
|
277
|
+
# # Call the create_session method.
|
278
|
+
# result = client.create_session request
|
279
|
+
#
|
280
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::Session.
|
281
|
+
# p result
|
282
|
+
#
|
268
283
|
def create_session request, options = nil
|
269
284
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
270
285
|
|
@@ -282,9 +297,11 @@ module Google
|
|
282
297
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
283
298
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
284
299
|
|
285
|
-
header_params = {
|
286
|
-
|
287
|
-
|
300
|
+
header_params = {}
|
301
|
+
if request.database
|
302
|
+
header_params["database"] = request.database
|
303
|
+
end
|
304
|
+
|
288
305
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
289
306
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
290
307
|
|
@@ -344,6 +361,21 @@ module Google
|
|
344
361
|
#
|
345
362
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
346
363
|
#
|
364
|
+
# @example Basic example
|
365
|
+
# require "google/cloud/spanner/v1"
|
366
|
+
#
|
367
|
+
# # Create a client object. The client can be reused for multiple calls.
|
368
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
369
|
+
#
|
370
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
371
|
+
# request = Google::Cloud::Spanner::V1::BatchCreateSessionsRequest.new
|
372
|
+
#
|
373
|
+
# # Call the batch_create_sessions method.
|
374
|
+
# result = client.batch_create_sessions request
|
375
|
+
#
|
376
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::BatchCreateSessionsResponse.
|
377
|
+
# p result
|
378
|
+
#
|
347
379
|
def batch_create_sessions request, options = nil
|
348
380
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
349
381
|
|
@@ -361,9 +393,11 @@ module Google
|
|
361
393
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
362
394
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
363
395
|
|
364
|
-
header_params = {
|
365
|
-
|
366
|
-
|
396
|
+
header_params = {}
|
397
|
+
if request.database
|
398
|
+
header_params["database"] = request.database
|
399
|
+
end
|
400
|
+
|
367
401
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
368
402
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
369
403
|
|
@@ -414,6 +448,21 @@ module Google
|
|
414
448
|
#
|
415
449
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
416
450
|
#
|
451
|
+
# @example Basic example
|
452
|
+
# require "google/cloud/spanner/v1"
|
453
|
+
#
|
454
|
+
# # Create a client object. The client can be reused for multiple calls.
|
455
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
456
|
+
#
|
457
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
458
|
+
# request = Google::Cloud::Spanner::V1::GetSessionRequest.new
|
459
|
+
#
|
460
|
+
# # Call the get_session method.
|
461
|
+
# result = client.get_session request
|
462
|
+
#
|
463
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::Session.
|
464
|
+
# p result
|
465
|
+
#
|
417
466
|
def get_session request, options = nil
|
418
467
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
419
468
|
|
@@ -431,9 +480,11 @@ module Google
|
|
431
480
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
432
481
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
433
482
|
|
434
|
-
header_params = {
|
435
|
-
|
436
|
-
|
483
|
+
header_params = {}
|
484
|
+
if request.name
|
485
|
+
header_params["name"] = request.name
|
486
|
+
end
|
487
|
+
|
437
488
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
438
489
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
439
490
|
|
@@ -500,6 +551,27 @@ module Google
|
|
500
551
|
#
|
501
552
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
502
553
|
#
|
554
|
+
# @example Basic example
|
555
|
+
# require "google/cloud/spanner/v1"
|
556
|
+
#
|
557
|
+
# # Create a client object. The client can be reused for multiple calls.
|
558
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
559
|
+
#
|
560
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
561
|
+
# request = Google::Cloud::Spanner::V1::ListSessionsRequest.new
|
562
|
+
#
|
563
|
+
# # Call the list_sessions method.
|
564
|
+
# result = client.list_sessions request
|
565
|
+
#
|
566
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can
|
567
|
+
# # iterate over all elements by calling #each, and the enumerable
|
568
|
+
# # will lazily make API calls to fetch subsequent pages. Other
|
569
|
+
# # methods are also available for managing paging directly.
|
570
|
+
# result.each do |response|
|
571
|
+
# # Each element is of type ::Google::Cloud::Spanner::V1::Session.
|
572
|
+
# p response
|
573
|
+
# end
|
574
|
+
#
|
503
575
|
def list_sessions request, options = nil
|
504
576
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
505
577
|
|
@@ -517,9 +589,11 @@ module Google
|
|
517
589
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
518
590
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
519
591
|
|
520
|
-
header_params = {
|
521
|
-
|
522
|
-
|
592
|
+
header_params = {}
|
593
|
+
if request.database
|
594
|
+
header_params["database"] = request.database
|
595
|
+
end
|
596
|
+
|
523
597
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
524
598
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
525
599
|
|
@@ -571,6 +645,21 @@ module Google
|
|
571
645
|
#
|
572
646
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
573
647
|
#
|
648
|
+
# @example Basic example
|
649
|
+
# require "google/cloud/spanner/v1"
|
650
|
+
#
|
651
|
+
# # Create a client object. The client can be reused for multiple calls.
|
652
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
653
|
+
#
|
654
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
655
|
+
# request = Google::Cloud::Spanner::V1::DeleteSessionRequest.new
|
656
|
+
#
|
657
|
+
# # Call the delete_session method.
|
658
|
+
# result = client.delete_session request
|
659
|
+
#
|
660
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
661
|
+
# p result
|
662
|
+
#
|
574
663
|
def delete_session request, options = nil
|
575
664
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
576
665
|
|
@@ -588,9 +677,11 @@ module Google
|
|
588
677
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
589
678
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
590
679
|
|
591
|
-
header_params = {
|
592
|
-
|
593
|
-
|
680
|
+
header_params = {}
|
681
|
+
if request.name
|
682
|
+
header_params["name"] = request.name
|
683
|
+
end
|
684
|
+
|
594
685
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
595
686
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
596
687
|
|
@@ -716,6 +807,21 @@ module Google
|
|
716
807
|
#
|
717
808
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
718
809
|
#
|
810
|
+
# @example Basic example
|
811
|
+
# require "google/cloud/spanner/v1"
|
812
|
+
#
|
813
|
+
# # Create a client object. The client can be reused for multiple calls.
|
814
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
815
|
+
#
|
816
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
817
|
+
# request = Google::Cloud::Spanner::V1::ExecuteSqlRequest.new
|
818
|
+
#
|
819
|
+
# # Call the execute_sql method.
|
820
|
+
# result = client.execute_sql request
|
821
|
+
#
|
822
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::ResultSet.
|
823
|
+
# p result
|
824
|
+
#
|
719
825
|
def execute_sql request, options = nil
|
720
826
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
721
827
|
|
@@ -733,9 +839,11 @@ module Google
|
|
733
839
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
734
840
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
735
841
|
|
736
|
-
header_params = {
|
737
|
-
|
738
|
-
|
842
|
+
header_params = {}
|
843
|
+
if request.session
|
844
|
+
header_params["session"] = request.session
|
845
|
+
end
|
846
|
+
|
739
847
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
740
848
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
741
849
|
|
@@ -855,6 +963,24 @@ module Google
|
|
855
963
|
#
|
856
964
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
857
965
|
#
|
966
|
+
# @example Basic example
|
967
|
+
# require "google/cloud/spanner/v1"
|
968
|
+
#
|
969
|
+
# # Create a client object. The client can be reused for multiple calls.
|
970
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
971
|
+
#
|
972
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
973
|
+
# request = Google::Cloud::Spanner::V1::ExecuteSqlRequest.new
|
974
|
+
#
|
975
|
+
# # Call the execute_streaming_sql method.
|
976
|
+
# result = client.execute_streaming_sql request
|
977
|
+
#
|
978
|
+
# # The returned object is a streamed enumerable yielding elements of
|
979
|
+
# # type ::Google::Cloud::Spanner::V1::PartialResultSet.
|
980
|
+
# result.each do |response|
|
981
|
+
# p response
|
982
|
+
# end
|
983
|
+
#
|
858
984
|
def execute_streaming_sql request, options = nil
|
859
985
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
860
986
|
|
@@ -872,9 +998,11 @@ module Google
|
|
872
998
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
873
999
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
874
1000
|
|
875
|
-
header_params = {
|
876
|
-
|
877
|
-
|
1001
|
+
header_params = {}
|
1002
|
+
if request.session
|
1003
|
+
header_params["session"] = request.session
|
1004
|
+
end
|
1005
|
+
|
878
1006
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
879
1007
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
880
1008
|
|
@@ -957,6 +1085,21 @@ module Google
|
|
957
1085
|
#
|
958
1086
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
959
1087
|
#
|
1088
|
+
# @example Basic example
|
1089
|
+
# require "google/cloud/spanner/v1"
|
1090
|
+
#
|
1091
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1092
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1093
|
+
#
|
1094
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1095
|
+
# request = Google::Cloud::Spanner::V1::ExecuteBatchDmlRequest.new
|
1096
|
+
#
|
1097
|
+
# # Call the execute_batch_dml method.
|
1098
|
+
# result = client.execute_batch_dml request
|
1099
|
+
#
|
1100
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::ExecuteBatchDmlResponse.
|
1101
|
+
# p result
|
1102
|
+
#
|
960
1103
|
def execute_batch_dml request, options = nil
|
961
1104
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
962
1105
|
|
@@ -974,9 +1117,11 @@ module Google
|
|
974
1117
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
975
1118
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
976
1119
|
|
977
|
-
header_params = {
|
978
|
-
|
979
|
-
|
1120
|
+
header_params = {}
|
1121
|
+
if request.session
|
1122
|
+
header_params["session"] = request.session
|
1123
|
+
end
|
1124
|
+
|
980
1125
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
981
1126
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
982
1127
|
|
@@ -1080,6 +1225,21 @@ module Google
|
|
1080
1225
|
#
|
1081
1226
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1082
1227
|
#
|
1228
|
+
# @example Basic example
|
1229
|
+
# require "google/cloud/spanner/v1"
|
1230
|
+
#
|
1231
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1232
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1233
|
+
#
|
1234
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1235
|
+
# request = Google::Cloud::Spanner::V1::ReadRequest.new
|
1236
|
+
#
|
1237
|
+
# # Call the read method.
|
1238
|
+
# result = client.read request
|
1239
|
+
#
|
1240
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::ResultSet.
|
1241
|
+
# p result
|
1242
|
+
#
|
1083
1243
|
def read request, options = nil
|
1084
1244
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1085
1245
|
|
@@ -1097,9 +1257,11 @@ module Google
|
|
1097
1257
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1098
1258
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1099
1259
|
|
1100
|
-
header_params = {
|
1101
|
-
|
1102
|
-
|
1260
|
+
header_params = {}
|
1261
|
+
if request.session
|
1262
|
+
header_params["session"] = request.session
|
1263
|
+
end
|
1264
|
+
|
1103
1265
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1104
1266
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1105
1267
|
|
@@ -1195,6 +1357,24 @@ module Google
|
|
1195
1357
|
#
|
1196
1358
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1197
1359
|
#
|
1360
|
+
# @example Basic example
|
1361
|
+
# require "google/cloud/spanner/v1"
|
1362
|
+
#
|
1363
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1364
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1365
|
+
#
|
1366
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1367
|
+
# request = Google::Cloud::Spanner::V1::ReadRequest.new
|
1368
|
+
#
|
1369
|
+
# # Call the streaming_read method.
|
1370
|
+
# result = client.streaming_read request
|
1371
|
+
#
|
1372
|
+
# # The returned object is a streamed enumerable yielding elements of
|
1373
|
+
# # type ::Google::Cloud::Spanner::V1::PartialResultSet.
|
1374
|
+
# result.each do |response|
|
1375
|
+
# p response
|
1376
|
+
# end
|
1377
|
+
#
|
1198
1378
|
def streaming_read request, options = nil
|
1199
1379
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1200
1380
|
|
@@ -1212,9 +1392,11 @@ module Google
|
|
1212
1392
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1213
1393
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1214
1394
|
|
1215
|
-
header_params = {
|
1216
|
-
|
1217
|
-
|
1395
|
+
header_params = {}
|
1396
|
+
if request.session
|
1397
|
+
header_params["session"] = request.session
|
1398
|
+
end
|
1399
|
+
|
1218
1400
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1219
1401
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1220
1402
|
|
@@ -1274,6 +1456,21 @@ module Google
|
|
1274
1456
|
#
|
1275
1457
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1276
1458
|
#
|
1459
|
+
# @example Basic example
|
1460
|
+
# require "google/cloud/spanner/v1"
|
1461
|
+
#
|
1462
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1463
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1464
|
+
#
|
1465
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1466
|
+
# request = Google::Cloud::Spanner::V1::BeginTransactionRequest.new
|
1467
|
+
#
|
1468
|
+
# # Call the begin_transaction method.
|
1469
|
+
# result = client.begin_transaction request
|
1470
|
+
#
|
1471
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::Transaction.
|
1472
|
+
# p result
|
1473
|
+
#
|
1277
1474
|
def begin_transaction request, options = nil
|
1278
1475
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1279
1476
|
|
@@ -1291,9 +1488,11 @@ module Google
|
|
1291
1488
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1292
1489
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1293
1490
|
|
1294
|
-
header_params = {
|
1295
|
-
|
1296
|
-
|
1491
|
+
header_params = {}
|
1492
|
+
if request.session
|
1493
|
+
header_params["session"] = request.session
|
1494
|
+
end
|
1495
|
+
|
1297
1496
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1298
1497
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1299
1498
|
|
@@ -1377,6 +1576,21 @@ module Google
|
|
1377
1576
|
#
|
1378
1577
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1379
1578
|
#
|
1579
|
+
# @example Basic example
|
1580
|
+
# require "google/cloud/spanner/v1"
|
1581
|
+
#
|
1582
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1583
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1584
|
+
#
|
1585
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1586
|
+
# request = Google::Cloud::Spanner::V1::CommitRequest.new
|
1587
|
+
#
|
1588
|
+
# # Call the commit method.
|
1589
|
+
# result = client.commit request
|
1590
|
+
#
|
1591
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::CommitResponse.
|
1592
|
+
# p result
|
1593
|
+
#
|
1380
1594
|
def commit request, options = nil
|
1381
1595
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1382
1596
|
|
@@ -1394,9 +1608,11 @@ module Google
|
|
1394
1608
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1395
1609
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1396
1610
|
|
1397
|
-
header_params = {
|
1398
|
-
|
1399
|
-
|
1611
|
+
header_params = {}
|
1612
|
+
if request.session
|
1613
|
+
header_params["session"] = request.session
|
1614
|
+
end
|
1615
|
+
|
1400
1616
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1401
1617
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1402
1618
|
|
@@ -1454,6 +1670,21 @@ module Google
|
|
1454
1670
|
#
|
1455
1671
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1456
1672
|
#
|
1673
|
+
# @example Basic example
|
1674
|
+
# require "google/cloud/spanner/v1"
|
1675
|
+
#
|
1676
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1677
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1678
|
+
#
|
1679
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1680
|
+
# request = Google::Cloud::Spanner::V1::RollbackRequest.new
|
1681
|
+
#
|
1682
|
+
# # Call the rollback method.
|
1683
|
+
# result = client.rollback request
|
1684
|
+
#
|
1685
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
1686
|
+
# p result
|
1687
|
+
#
|
1457
1688
|
def rollback request, options = nil
|
1458
1689
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1459
1690
|
|
@@ -1471,9 +1702,11 @@ module Google
|
|
1471
1702
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1472
1703
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1473
1704
|
|
1474
|
-
header_params = {
|
1475
|
-
|
1476
|
-
|
1705
|
+
header_params = {}
|
1706
|
+
if request.session
|
1707
|
+
header_params["session"] = request.session
|
1708
|
+
end
|
1709
|
+
|
1477
1710
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1478
1711
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1479
1712
|
|
@@ -1570,6 +1803,21 @@ module Google
|
|
1570
1803
|
#
|
1571
1804
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1572
1805
|
#
|
1806
|
+
# @example Basic example
|
1807
|
+
# require "google/cloud/spanner/v1"
|
1808
|
+
#
|
1809
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1810
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1811
|
+
#
|
1812
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1813
|
+
# request = Google::Cloud::Spanner::V1::PartitionQueryRequest.new
|
1814
|
+
#
|
1815
|
+
# # Call the partition_query method.
|
1816
|
+
# result = client.partition_query request
|
1817
|
+
#
|
1818
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::PartitionResponse.
|
1819
|
+
# p result
|
1820
|
+
#
|
1573
1821
|
def partition_query request, options = nil
|
1574
1822
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1575
1823
|
|
@@ -1587,9 +1835,11 @@ module Google
|
|
1587
1835
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1588
1836
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1589
1837
|
|
1590
|
-
header_params = {
|
1591
|
-
|
1592
|
-
|
1838
|
+
header_params = {}
|
1839
|
+
if request.session
|
1840
|
+
header_params["session"] = request.session
|
1841
|
+
end
|
1842
|
+
|
1593
1843
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1594
1844
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1595
1845
|
|
@@ -1672,6 +1922,21 @@ module Google
|
|
1672
1922
|
#
|
1673
1923
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1674
1924
|
#
|
1925
|
+
# @example Basic example
|
1926
|
+
# require "google/cloud/spanner/v1"
|
1927
|
+
#
|
1928
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1929
|
+
# client = Google::Cloud::Spanner::V1::Spanner::Client.new
|
1930
|
+
#
|
1931
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1932
|
+
# request = Google::Cloud::Spanner::V1::PartitionReadRequest.new
|
1933
|
+
#
|
1934
|
+
# # Call the partition_read method.
|
1935
|
+
# result = client.partition_read request
|
1936
|
+
#
|
1937
|
+
# # The returned object is of type Google::Cloud::Spanner::V1::PartitionResponse.
|
1938
|
+
# p result
|
1939
|
+
#
|
1675
1940
|
def partition_read request, options = nil
|
1676
1941
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
1677
1942
|
|
@@ -1689,9 +1954,11 @@ module Google
|
|
1689
1954
|
gapic_version: ::Google::Cloud::Spanner::V1::VERSION
|
1690
1955
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1691
1956
|
|
1692
|
-
header_params = {
|
1693
|
-
|
1694
|
-
|
1957
|
+
header_params = {}
|
1958
|
+
if request.session
|
1959
|
+
header_params["session"] = request.session
|
1960
|
+
end
|
1961
|
+
|
1695
1962
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1696
1963
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
1697
1964
|
|
@@ -1,11 +1,11 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/commit_response.proto
|
3
3
|
|
4
|
-
require 'google/
|
5
|
-
|
4
|
+
require 'google/api/annotations_pb'
|
6
5
|
require 'google/protobuf/duration_pb'
|
7
6
|
require 'google/protobuf/timestamp_pb'
|
8
|
-
require 'google/
|
7
|
+
require 'google/protobuf'
|
8
|
+
|
9
9
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
10
10
|
add_file("google/spanner/v1/commit_response.proto", :syntax => :proto3) do
|
11
11
|
add_message "google.spanner.v1.CommitResponse" do
|
@@ -1,10 +1,10 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/keys.proto
|
3
3
|
|
4
|
+
require 'google/api/annotations_pb'
|
5
|
+
require 'google/protobuf/struct_pb'
|
4
6
|
require 'google/protobuf'
|
5
7
|
|
6
|
-
require 'google/protobuf/struct_pb'
|
7
|
-
require 'google/api/annotations_pb'
|
8
8
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
9
9
|
add_file("google/spanner/v1/keys.proto", :syntax => :proto3) do
|
10
10
|
add_message "google.spanner.v1.KeyRange" do
|
@@ -1,11 +1,11 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/mutation.proto
|
3
3
|
|
4
|
-
require 'google/
|
5
|
-
|
4
|
+
require 'google/api/annotations_pb'
|
6
5
|
require 'google/protobuf/struct_pb'
|
7
6
|
require 'google/spanner/v1/keys_pb'
|
8
|
-
require 'google/
|
7
|
+
require 'google/protobuf'
|
8
|
+
|
9
9
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
10
10
|
add_file("google/spanner/v1/mutation.proto", :syntax => :proto3) do
|
11
11
|
add_message "google.spanner.v1.Mutation" do
|
@@ -1,10 +1,10 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/query_plan.proto
|
3
3
|
|
4
|
+
require 'google/api/annotations_pb'
|
5
|
+
require 'google/protobuf/struct_pb'
|
4
6
|
require 'google/protobuf'
|
5
7
|
|
6
|
-
require 'google/protobuf/struct_pb'
|
7
|
-
require 'google/api/annotations_pb'
|
8
8
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
9
9
|
add_file("google/spanner/v1/query_plan.proto", :syntax => :proto3) do
|
10
10
|
add_message "google.spanner.v1.PlanNode" do
|
@@ -1,13 +1,14 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/result_set.proto
|
3
3
|
|
4
|
-
require 'google/
|
5
|
-
|
4
|
+
require 'google/api/annotations_pb'
|
6
5
|
require 'google/protobuf/struct_pb'
|
6
|
+
require 'google/spanner/v1/commit_response_pb'
|
7
7
|
require 'google/spanner/v1/query_plan_pb'
|
8
8
|
require 'google/spanner/v1/transaction_pb'
|
9
9
|
require 'google/spanner/v1/type_pb'
|
10
|
-
require 'google/
|
10
|
+
require 'google/protobuf'
|
11
|
+
|
11
12
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
12
13
|
add_file("google/spanner/v1/result_set.proto", :syntax => :proto3) do
|
13
14
|
add_message "google.spanner.v1.ResultSet" do
|
@@ -1,9 +1,6 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/spanner.proto
|
3
3
|
|
4
|
-
require 'google/protobuf'
|
5
|
-
|
6
|
-
require 'google/spanner/v1/commit_response_pb'
|
7
4
|
require 'google/api/annotations_pb'
|
8
5
|
require 'google/api/client_pb'
|
9
6
|
require 'google/api/field_behavior_pb'
|
@@ -12,11 +9,14 @@ require 'google/protobuf/empty_pb'
|
|
12
9
|
require 'google/protobuf/struct_pb'
|
13
10
|
require 'google/protobuf/timestamp_pb'
|
14
11
|
require 'google/rpc/status_pb'
|
12
|
+
require 'google/spanner/v1/commit_response_pb'
|
15
13
|
require 'google/spanner/v1/keys_pb'
|
16
14
|
require 'google/spanner/v1/mutation_pb'
|
17
15
|
require 'google/spanner/v1/result_set_pb'
|
18
16
|
require 'google/spanner/v1/transaction_pb'
|
19
17
|
require 'google/spanner/v1/type_pb'
|
18
|
+
require 'google/protobuf'
|
19
|
+
|
20
20
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
21
21
|
add_file("google/spanner/v1/spanner.proto", :syntax => :proto3) do
|
22
22
|
add_message "google.spanner.v1.CreateSessionRequest" do
|
@@ -1,11 +1,11 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/transaction.proto
|
3
3
|
|
4
|
-
require 'google/
|
5
|
-
|
4
|
+
require 'google/api/annotations_pb'
|
6
5
|
require 'google/protobuf/duration_pb'
|
7
6
|
require 'google/protobuf/timestamp_pb'
|
8
|
-
require 'google/
|
7
|
+
require 'google/protobuf'
|
8
|
+
|
9
9
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
10
10
|
add_file("google/spanner/v1/transaction.proto", :syntax => :proto3) do
|
11
11
|
add_message "google.spanner.v1.TransactionOptions" do
|
@@ -1,16 +1,17 @@
|
|
1
1
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
2
|
# source: google/spanner/v1/type.proto
|
3
3
|
|
4
|
+
require 'google/api/annotations_pb'
|
5
|
+
require 'google/api/field_behavior_pb'
|
4
6
|
require 'google/protobuf'
|
5
7
|
|
6
|
-
require 'google/api/field_behavior_pb'
|
7
|
-
require 'google/api/annotations_pb'
|
8
8
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
9
9
|
add_file("google/spanner/v1/type.proto", :syntax => :proto3) do
|
10
10
|
add_message "google.spanner.v1.Type" do
|
11
11
|
optional :code, :enum, 1, "google.spanner.v1.TypeCode"
|
12
12
|
optional :array_element_type, :message, 2, "google.spanner.v1.Type"
|
13
13
|
optional :struct_type, :message, 3, "google.spanner.v1.StructType"
|
14
|
+
optional :type_annotation, :enum, 4, "google.spanner.v1.TypeAnnotationCode"
|
14
15
|
end
|
15
16
|
add_message "google.spanner.v1.StructType" do
|
16
17
|
repeated :fields, :message, 1, "google.spanner.v1.StructType.Field"
|
@@ -33,6 +34,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
33
34
|
value :NUMERIC, 10
|
34
35
|
value :JSON, 11
|
35
36
|
end
|
37
|
+
add_enum "google.spanner.v1.TypeAnnotationCode" do
|
38
|
+
value :TYPE_ANNOTATION_CODE_UNSPECIFIED, 0
|
39
|
+
value :PG_NUMERIC, 2
|
40
|
+
end
|
36
41
|
end
|
37
42
|
end
|
38
43
|
|
@@ -44,6 +49,7 @@ module Google
|
|
44
49
|
StructType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType").msgclass
|
45
50
|
StructType::Field = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType.Field").msgclass
|
46
51
|
TypeCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TypeCode").enummodule
|
52
|
+
TypeAnnotationCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TypeAnnotationCode").enummodule
|
47
53
|
end
|
48
54
|
end
|
49
55
|
end
|
@@ -33,11 +33,7 @@ module Google
|
|
33
33
|
# // For Kubernetes resources, the format is {api group}/{kind}.
|
34
34
|
# option (google.api.resource) = {
|
35
35
|
# type: "pubsub.googleapis.com/Topic"
|
36
|
-
#
|
37
|
-
# pattern: "projects/{project}/topics/{topic}"
|
38
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
39
|
-
# parent_name_extractor: "projects/{project}"
|
40
|
-
# }
|
36
|
+
# pattern: "projects/{project}/topics/{topic}"
|
41
37
|
# };
|
42
38
|
# }
|
43
39
|
#
|
@@ -45,10 +41,7 @@ module Google
|
|
45
41
|
#
|
46
42
|
# resources:
|
47
43
|
# - type: "pubsub.googleapis.com/Topic"
|
48
|
-
#
|
49
|
-
# - pattern: "projects/{project}/topics/{topic}"
|
50
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
51
|
-
# parent_name_extractor: "projects/{project}"
|
44
|
+
# pattern: "projects/{project}/topics/{topic}"
|
52
45
|
#
|
53
46
|
# Sometimes, resources have multiple patterns, typically because they can
|
54
47
|
# live under multiple parents.
|
@@ -58,26 +51,10 @@ module Google
|
|
58
51
|
# message LogEntry {
|
59
52
|
# option (google.api.resource) = {
|
60
53
|
# type: "logging.googleapis.com/LogEntry"
|
61
|
-
#
|
62
|
-
#
|
63
|
-
#
|
64
|
-
#
|
65
|
-
# }
|
66
|
-
# name_descriptor: {
|
67
|
-
# pattern: "folders/{folder}/logs/{log}"
|
68
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
69
|
-
# parent_name_extractor: "folders/{folder}"
|
70
|
-
# }
|
71
|
-
# name_descriptor: {
|
72
|
-
# pattern: "organizations/{organization}/logs/{log}"
|
73
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Organization"
|
74
|
-
# parent_name_extractor: "organizations/{organization}"
|
75
|
-
# }
|
76
|
-
# name_descriptor: {
|
77
|
-
# pattern: "billingAccounts/{billing_account}/logs/{log}"
|
78
|
-
# parent_type: "billing.googleapis.com/BillingAccount"
|
79
|
-
# parent_name_extractor: "billingAccounts/{billing_account}"
|
80
|
-
# }
|
54
|
+
# pattern: "projects/{project}/logs/{log}"
|
55
|
+
# pattern: "folders/{folder}/logs/{log}"
|
56
|
+
# pattern: "organizations/{organization}/logs/{log}"
|
57
|
+
# pattern: "billingAccounts/{billing_account}/logs/{log}"
|
81
58
|
# };
|
82
59
|
# }
|
83
60
|
#
|
@@ -85,48 +62,10 @@ module Google
|
|
85
62
|
#
|
86
63
|
# resources:
|
87
64
|
# - type: 'logging.googleapis.com/LogEntry'
|
88
|
-
#
|
89
|
-
#
|
90
|
-
#
|
91
|
-
#
|
92
|
-
# - pattern: "folders/{folder}/logs/{log}"
|
93
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
94
|
-
# parent_name_extractor: "folders/{folder}"
|
95
|
-
# - pattern: "organizations/{organization}/logs/{log}"
|
96
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Organization"
|
97
|
-
# parent_name_extractor: "organizations/{organization}"
|
98
|
-
# - pattern: "billingAccounts/{billing_account}/logs/{log}"
|
99
|
-
# parent_type: "billing.googleapis.com/BillingAccount"
|
100
|
-
# parent_name_extractor: "billingAccounts/{billing_account}"
|
101
|
-
#
|
102
|
-
# For flexible resources, the resource name doesn't contain parent names, but
|
103
|
-
# the resource itself has parents for policy evaluation.
|
104
|
-
#
|
105
|
-
# Example:
|
106
|
-
#
|
107
|
-
# message Shelf {
|
108
|
-
# option (google.api.resource) = {
|
109
|
-
# type: "library.googleapis.com/Shelf"
|
110
|
-
# name_descriptor: {
|
111
|
-
# pattern: "shelves/{shelf}"
|
112
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
113
|
-
# }
|
114
|
-
# name_descriptor: {
|
115
|
-
# pattern: "shelves/{shelf}"
|
116
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
117
|
-
# }
|
118
|
-
# };
|
119
|
-
# }
|
120
|
-
#
|
121
|
-
# The ResourceDescriptor Yaml config will look like:
|
122
|
-
#
|
123
|
-
# resources:
|
124
|
-
# - type: 'library.googleapis.com/Shelf'
|
125
|
-
# name_descriptor:
|
126
|
-
# - pattern: "shelves/{shelf}"
|
127
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
128
|
-
# - pattern: "shelves/{shelf}"
|
129
|
-
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
65
|
+
# pattern: "projects/{project}/logs/{log}"
|
66
|
+
# pattern: "folders/{folder}/logs/{log}"
|
67
|
+
# pattern: "organizations/{organization}/logs/{log}"
|
68
|
+
# pattern: "billingAccounts/{billing_account}/logs/{log}"
|
130
69
|
# @!attribute [rw] type
|
131
70
|
# @return [::String]
|
132
71
|
# The resource type. It must be in the format of
|
@@ -41,9 +41,9 @@ module Google
|
|
41
41
|
# `mutation_count` value can help you maximize the number of mutations
|
42
42
|
# in a transaction and minimize the number of API round trips. You can
|
43
43
|
# also monitor this value to prevent transactions from exceeding the system
|
44
|
-
# [limit](
|
44
|
+
# [limit](https://cloud.google.com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data).
|
45
45
|
# If the number of mutations exceeds the limit, the server returns
|
46
|
-
# [INVALID_ARGUMENT](
|
46
|
+
# [INVALID_ARGUMENT](https://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT).
|
47
47
|
class CommitStats
|
48
48
|
include ::Google::Protobuf::MessageExts
|
49
49
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -174,6 +174,7 @@ module Google
|
|
174
174
|
# Legal characters for `request_tag` values are all printable characters
|
175
175
|
# (ASCII 32 - 126) and the length of a request_tag is limited to 50
|
176
176
|
# characters. Values that exceed this limit are truncated.
|
177
|
+
# Any leading underscore (_) characters will be removed from the string.
|
177
178
|
# @!attribute [rw] transaction_tag
|
178
179
|
# @return [::String]
|
179
180
|
# A tag used for statistics collection about this transaction.
|
@@ -181,11 +182,12 @@ module Google
|
|
181
182
|
# that belongs to a transaction.
|
182
183
|
# The value of transaction_tag should be the same for all requests belonging
|
183
184
|
# to the same transaction.
|
184
|
-
# If this request doesn
|
185
|
+
# If this request doesn't belong to any transaction, transaction_tag will be
|
185
186
|
# ignored.
|
186
187
|
# Legal characters for `transaction_tag` values are all printable characters
|
187
188
|
# (ASCII 32 - 126) and the length of a transaction_tag is limited to 50
|
188
189
|
# characters. Values that exceed this limit are truncated.
|
190
|
+
# Any leading underscore (_) characters will be removed from the string.
|
189
191
|
class RequestOptions
|
190
192
|
include ::Google::Protobuf::MessageExts
|
191
193
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -21,8 +21,7 @@ module Google
|
|
21
21
|
module Cloud
|
22
22
|
module Spanner
|
23
23
|
module V1
|
24
|
-
#
|
25
|
-
#
|
24
|
+
# Transactions:
|
26
25
|
#
|
27
26
|
# Each session can have at most one active transaction at a time (note that
|
28
27
|
# standalone reads and queries use a transaction internally and do count
|
@@ -30,8 +29,7 @@ module Google
|
|
30
29
|
# completed, the session can immediately be re-used for the next transaction.
|
31
30
|
# It is not necessary to create a new session for each transaction.
|
32
31
|
#
|
33
|
-
#
|
34
|
-
#
|
32
|
+
# Transaction Modes:
|
35
33
|
# Cloud Spanner supports three transaction modes:
|
36
34
|
#
|
37
35
|
# 1. Locking read-write. This type of transaction is the only way
|
@@ -63,8 +61,7 @@ module Google
|
|
63
61
|
# may, however, read/write data in different tables within that
|
64
62
|
# database.
|
65
63
|
#
|
66
|
-
#
|
67
|
-
#
|
64
|
+
# Locking Read-Write Transactions:
|
68
65
|
# Locking transactions may be used to atomically read-modify-write
|
69
66
|
# data anywhere in a database. This type of transaction is externally
|
70
67
|
# consistent.
|
@@ -86,8 +83,7 @@ module Google
|
|
86
83
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#rollback Rollback} request to abort the
|
87
84
|
# transaction.
|
88
85
|
#
|
89
|
-
#
|
90
|
-
#
|
86
|
+
# Semantics:
|
91
87
|
# Cloud Spanner can commit the transaction if all read locks it acquired
|
92
88
|
# are still valid at commit time, and it is able to acquire write
|
93
89
|
# locks for all writes. Cloud Spanner can abort the transaction for any
|
@@ -99,8 +95,7 @@ module Google
|
|
99
95
|
# use Cloud Spanner locks for any sort of mutual exclusion other than
|
100
96
|
# between Cloud Spanner transactions themselves.
|
101
97
|
#
|
102
|
-
#
|
103
|
-
#
|
98
|
+
# Retrying Aborted Transactions:
|
104
99
|
# When a transaction aborts, the application can choose to retry the
|
105
100
|
# whole transaction again. To maximize the chances of successfully
|
106
101
|
# committing the retry, the client should execute the retry in the
|
@@ -108,27 +103,25 @@ module Google
|
|
108
103
|
# priority increases with each consecutive abort, meaning that each
|
109
104
|
# attempt has a slightly better chance of success than the previous.
|
110
105
|
#
|
111
|
-
# Under some circumstances (
|
106
|
+
# Under some circumstances (for example, many transactions attempting to
|
112
107
|
# modify the same row(s)), a transaction can abort many times in a
|
113
108
|
# short period before successfully committing. Thus, it is not a good
|
114
109
|
# idea to cap the number of retries a transaction can attempt;
|
115
|
-
# instead, it is better to limit the total amount of
|
110
|
+
# instead, it is better to limit the total amount of time spent
|
116
111
|
# retrying.
|
117
112
|
#
|
118
|
-
#
|
119
|
-
#
|
113
|
+
# Idle Transactions:
|
120
114
|
# A transaction is considered idle if it has no outstanding reads or
|
121
115
|
# SQL queries and has not started a read or SQL query within the last 10
|
122
116
|
# seconds. Idle transactions can be aborted by Cloud Spanner so that they
|
123
|
-
# don't hold on to locks indefinitely.
|
124
|
-
# fail with error `ABORTED`.
|
117
|
+
# don't hold on to locks indefinitely. If an idle transaction is aborted, the
|
118
|
+
# commit will fail with error `ABORTED`.
|
125
119
|
#
|
126
120
|
# If this behavior is undesirable, periodically executing a simple
|
127
|
-
# SQL query in the transaction (
|
121
|
+
# SQL query in the transaction (for example, `SELECT 1`) prevents the
|
128
122
|
# transaction from becoming idle.
|
129
123
|
#
|
130
|
-
#
|
131
|
-
#
|
124
|
+
# Snapshot Read-Only Transactions:
|
132
125
|
# Snapshot read-only transactions provides a simpler method than
|
133
126
|
# locking read-write transactions for doing several consistent
|
134
127
|
# reads. However, this type of transaction does not support writes.
|
@@ -165,8 +158,7 @@ module Google
|
|
165
158
|
#
|
166
159
|
# Each type of timestamp bound is discussed in detail below.
|
167
160
|
#
|
168
|
-
#
|
169
|
-
#
|
161
|
+
# Strong:
|
170
162
|
# Strong reads are guaranteed to see the effects of all transactions
|
171
163
|
# that have committed before the start of the read. Furthermore, all
|
172
164
|
# rows yielded by a single read are consistent with each other -- if
|
@@ -181,13 +173,12 @@ module Google
|
|
181
173
|
#
|
182
174
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong}.
|
183
175
|
#
|
184
|
-
#
|
185
|
-
#
|
176
|
+
# Exact Staleness:
|
186
177
|
# These timestamp bounds execute reads at a user-specified
|
187
178
|
# timestamp. Reads at a timestamp are guaranteed to see a consistent
|
188
179
|
# prefix of the global transaction history: they observe
|
189
|
-
# modifications done by all transactions with a commit timestamp
|
190
|
-
# the read timestamp, and observe none of the modifications done by
|
180
|
+
# modifications done by all transactions with a commit timestamp less than or
|
181
|
+
# equal to the read timestamp, and observe none of the modifications done by
|
191
182
|
# transactions with a larger commit timestamp. They will block until
|
192
183
|
# all conflicting transactions that may be assigned commit timestamps
|
193
184
|
# <= the read timestamp have finished.
|
@@ -203,8 +194,7 @@ module Google
|
|
203
194
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions.ReadOnly.read_timestamp} and
|
204
195
|
# {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#exact_staleness TransactionOptions.ReadOnly.exact_staleness}.
|
205
196
|
#
|
206
|
-
#
|
207
|
-
#
|
197
|
+
# Bounded Staleness:
|
208
198
|
# Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
|
209
199
|
# subject to a user-provided staleness bound. Cloud Spanner chooses the
|
210
200
|
# newest timestamp within the staleness bound that allows execution
|
@@ -233,8 +223,7 @@ module Google
|
|
233
223
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions.ReadOnly.max_staleness} and
|
234
224
|
# {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#min_read_timestamp TransactionOptions.ReadOnly.min_read_timestamp}.
|
235
225
|
#
|
236
|
-
#
|
237
|
-
#
|
226
|
+
# Old Read Timestamps and Garbage Collection:
|
238
227
|
# Cloud Spanner continuously garbage collects deleted and overwritten data
|
239
228
|
# in the background to reclaim storage space. This process is known
|
240
229
|
# as "version GC". By default, version GC reclaims versions after they
|
@@ -244,8 +233,7 @@ module Google
|
|
244
233
|
# timestamp become too old while executing. Reads and SQL queries with
|
245
234
|
# too-old read timestamps fail with the error `FAILED_PRECONDITION`.
|
246
235
|
#
|
247
|
-
#
|
248
|
-
#
|
236
|
+
# Partitioned DML Transactions:
|
249
237
|
# Partitioned DML transactions are used to execute DML statements with a
|
250
238
|
# different execution strategy that provides different, and often better,
|
251
239
|
# scalability properties for large, table-wide operations than DML in a
|
@@ -34,6 +34,14 @@ module Google
|
|
34
34
|
# @return [::Google::Cloud::Spanner::V1::StructType]
|
35
35
|
# If {::Google::Cloud::Spanner::V1::Type#code code} == {::Google::Cloud::Spanner::V1::TypeCode::STRUCT STRUCT}, then `struct_type`
|
36
36
|
# provides type information for the struct's fields.
|
37
|
+
# @!attribute [rw] type_annotation
|
38
|
+
# @return [::Google::Cloud::Spanner::V1::TypeAnnotationCode]
|
39
|
+
# The {::Google::Cloud::Spanner::V1::TypeAnnotationCode TypeAnnotationCode} that disambiguates SQL type that Spanner will
|
40
|
+
# use to represent values of this type during query processing. This is
|
41
|
+
# necessary for some type codes because a single {::Google::Cloud::Spanner::V1::TypeCode TypeCode} can be mapped
|
42
|
+
# to different SQL types depending on the SQL dialect. {::Google::Cloud::Spanner::V1::Type#type_annotation type_annotation}
|
43
|
+
# typically is not needed to process the content of a value (it doesn't
|
44
|
+
# affect serialization) and clients can ignore it on the read path.
|
37
45
|
class Type
|
38
46
|
include ::Google::Protobuf::MessageExts
|
39
47
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -132,15 +140,34 @@ module Google
|
|
132
140
|
# <br>(ExponentIndicator is `"e"` or `"E"`)
|
133
141
|
NUMERIC = 10
|
134
142
|
|
135
|
-
# Encoded as a JSON-formatted
|
136
|
-
# following rules
|
137
|
-
#
|
138
|
-
# -
|
139
|
-
#
|
143
|
+
# Encoded as a JSON-formatted `string` as described in RFC 7159. The
|
144
|
+
# following rules are applied when parsing JSON input:
|
145
|
+
#
|
146
|
+
# - Whitespace characters are not preserved.
|
147
|
+
# - If a JSON object has duplicate keys, only the first key is preserved.
|
140
148
|
# - Members of a JSON object are not guaranteed to have their order
|
141
|
-
# preserved.
|
149
|
+
# preserved.
|
150
|
+
# - JSON array elements will have their order preserved.
|
142
151
|
JSON = 11
|
143
152
|
end
|
153
|
+
|
154
|
+
# `TypeAnnotationCode` is used as a part of {::Google::Cloud::Spanner::V1::Type Type} to
|
155
|
+
# disambiguate SQL types that should be used for a given Cloud Spanner value.
|
156
|
+
# Disambiguation is needed because the same Cloud Spanner type can be mapped to
|
157
|
+
# different SQL types depending on SQL dialect. TypeAnnotationCode doesn't
|
158
|
+
# affect the way value is serialized.
|
159
|
+
module TypeAnnotationCode
|
160
|
+
# Not specified.
|
161
|
+
TYPE_ANNOTATION_CODE_UNSPECIFIED = 0
|
162
|
+
|
163
|
+
# PostgreSQL compatible NUMERIC type. This annotation needs to be applied to
|
164
|
+
# {::Google::Cloud::Spanner::V1::Type Type} instances having {::Google::Cloud::Spanner::V1::TypeCode::NUMERIC NUMERIC}
|
165
|
+
# type code to specify that values of this type should be treated as
|
166
|
+
# PostgreSQL NUMERIC values. Currently this annotation is always needed for
|
167
|
+
# {::Google::Cloud::Spanner::V1::TypeCode::NUMERIC NUMERIC} when a client interacts with PostgreSQL-enabled
|
168
|
+
# Spanner databases.
|
169
|
+
PG_NUMERIC = 2
|
170
|
+
end
|
144
171
|
end
|
145
172
|
end
|
146
173
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-spanner-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.8.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2022-03-15 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -221,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
221
221
|
- !ruby/object:Gem::Version
|
222
222
|
version: '0'
|
223
223
|
requirements: []
|
224
|
-
rubygems_version: 3.
|
224
|
+
rubygems_version: 3.3.5
|
225
225
|
signing_key:
|
226
226
|
specification_version: 4
|
227
227
|
summary: API Client library for the Cloud Spanner V1 API
|