google-cloud-datastore-v1 0.17.0 → 0.18.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/google/cloud/datastore/v1/datastore/client.rb +8 -2
- data/lib/google/cloud/datastore/v1/datastore/rest/client.rb +8 -2
- data/lib/google/cloud/datastore/v1/version.rb +1 -1
- data/lib/google/datastore/v1/datastore_pb.rb +3 -1
- data/lib/google/datastore/v1/query_profile_pb.rb +51 -0
- data/proto_docs/google/api/client.rb +4 -0
- data/proto_docs/google/datastore/v1/datastore.rb +18 -0
- data/proto_docs/google/datastore/v1/query_profile.rb +98 -0
- metadata +4 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 44007e25783b192f7921848ad1c44de61a240582f61107ead054b9e139942874
|
|
4
|
+
data.tar.gz: '0619912f9cbcdde1286c52702968d1c746cb51c7dd4f394471424ca042215f27'
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: d1e3ddc4901856b34ce35974a66479e35a1f97cbcf0ca804c7e9a2510651feb089e8245208e232b32e236114511a4eb1b265a4437aee1aadac158b4860ff519b
|
|
7
|
+
data.tar.gz: 771cc35194a02fbb97e9d307d2d1a04742d310926d1a644c0f4f5f570a7f6648fc63fe1ebbb8e21a92c21019511c1a49ecb1bb12b138f65abd322ac372724b17
|
|
@@ -301,7 +301,7 @@ module Google
|
|
|
301
301
|
# @param options [::Gapic::CallOptions, ::Hash]
|
|
302
302
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
|
303
303
|
#
|
|
304
|
-
# @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil)
|
|
304
|
+
# @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, explain_options: nil)
|
|
305
305
|
# Pass arguments to `run_query` via keyword arguments. Note that at
|
|
306
306
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
307
307
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
@@ -324,6 +324,9 @@ module Google
|
|
|
324
324
|
# The query to run.
|
|
325
325
|
# @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
|
|
326
326
|
# The GQL query to run. This query must be a non-aggregation query.
|
|
327
|
+
# @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
|
|
328
|
+
# Optional. Explain options for the query. If set, additional query
|
|
329
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
327
330
|
#
|
|
328
331
|
# @yield [response, operation] Access the result along with the RPC operation
|
|
329
332
|
# @yieldparam response [::Google::Cloud::Datastore::V1::RunQueryResponse]
|
|
@@ -405,7 +408,7 @@ module Google
|
|
|
405
408
|
# @param options [::Gapic::CallOptions, ::Hash]
|
|
406
409
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
|
407
410
|
#
|
|
408
|
-
# @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil)
|
|
411
|
+
# @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil)
|
|
409
412
|
# Pass arguments to `run_aggregation_query` via keyword arguments. Note that at
|
|
410
413
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
411
414
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
@@ -428,6 +431,9 @@ module Google
|
|
|
428
431
|
# The query to run.
|
|
429
432
|
# @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
|
|
430
433
|
# The GQL query to run. This query must be an aggregation query.
|
|
434
|
+
# @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
|
|
435
|
+
# Optional. Explain options for the query. If set, additional query
|
|
436
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
431
437
|
#
|
|
432
438
|
# @yield [response, operation] Access the result along with the RPC operation
|
|
433
439
|
# @yieldparam response [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
|
|
@@ -284,7 +284,7 @@ module Google
|
|
|
284
284
|
# @param options [::Gapic::CallOptions, ::Hash]
|
|
285
285
|
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
286
286
|
#
|
|
287
|
-
# @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil)
|
|
287
|
+
# @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, explain_options: nil)
|
|
288
288
|
# Pass arguments to `run_query` via keyword arguments. Note that at
|
|
289
289
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
290
290
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
@@ -307,6 +307,9 @@ module Google
|
|
|
307
307
|
# The query to run.
|
|
308
308
|
# @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
|
|
309
309
|
# The GQL query to run. This query must be a non-aggregation query.
|
|
310
|
+
# @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
|
|
311
|
+
# Optional. Explain options for the query. If set, additional query
|
|
312
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
310
313
|
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
311
314
|
# @yieldparam result [::Google::Cloud::Datastore::V1::RunQueryResponse]
|
|
312
315
|
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
@@ -378,7 +381,7 @@ module Google
|
|
|
378
381
|
# @param options [::Gapic::CallOptions, ::Hash]
|
|
379
382
|
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
380
383
|
#
|
|
381
|
-
# @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil)
|
|
384
|
+
# @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil)
|
|
382
385
|
# Pass arguments to `run_aggregation_query` via keyword arguments. Note that at
|
|
383
386
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
384
387
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
@@ -401,6 +404,9 @@ module Google
|
|
|
401
404
|
# The query to run.
|
|
402
405
|
# @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
|
|
403
406
|
# The GQL query to run. This query must be an aggregation query.
|
|
407
|
+
# @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
|
|
408
|
+
# Optional. Explain options for the query. If set, additional query
|
|
409
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
404
410
|
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
405
411
|
# @yieldparam result [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
|
|
406
412
|
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
@@ -11,10 +11,11 @@ require 'google/api/routing_pb'
|
|
|
11
11
|
require 'google/datastore/v1/aggregation_result_pb'
|
|
12
12
|
require 'google/datastore/v1/entity_pb'
|
|
13
13
|
require 'google/datastore/v1/query_pb'
|
|
14
|
+
require 'google/datastore/v1/query_profile_pb'
|
|
14
15
|
require 'google/protobuf/timestamp_pb'
|
|
15
16
|
|
|
16
17
|
|
|
17
|
-
descriptor_data = "\n#google/datastore/v1/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x18google/api/routing.proto\x1a,google/datastore/v1/aggregation_result.proto\x1a google/datastore/v1/entity.proto\x1a\x1fgoogle/datastore/v1/query.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xa2\x01\n\rLookupRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"\xe6\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12-\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\
|
|
18
|
+
descriptor_data = "\n#google/datastore/v1/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x18google/api/routing.proto\x1a,google/datastore/v1/aggregation_result.proto\x1a google/datastore/v1/entity.proto\x1a\x1fgoogle/datastore/v1/query.proto\x1a\'google/datastore/v1/query_profile.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xa2\x01\n\rLookupRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"\xe6\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12-\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xe1\x02\n\x0fRunQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x05query\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.QueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x41\n\x0f\x65xplain_options\x18\x0c \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xc6\x01\n\x10RunQueryResponse\x12\x34\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32%.google.datastore.v1.QueryResultBatch\x12)\n\x05query\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Query\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\x83\x03\n\x1aRunAggregationQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12\x42\n\x11\x61ggregation_query\x18\x03 \x01(\x0b\x32%.google.datastore.v1.AggregationQueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x41\n\x0f\x65xplain_options\x18\x0b \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xe2\x01\n\x1bRunAggregationQueryResponse\x12:\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32+.google.datastore.v1.AggregationResultBatch\x12\x34\n\x05query\x18\x02 \x01(\x0b\x32%.google.datastore.v1.AggregationQuery\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\x8d\x01\n\x17\x42\x65ginTransactionRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x44\n\x13transaction_options\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptions\"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c\"Y\n\x0fRollbackRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x18\n\x0btransaction\x18\x01 \x01(\x0c\x42\x03\xe0\x41\x02\"\x12\n\x10RollbackResponse\"\xe8\x02\n\rCommitRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x35\n\x04mode\x18\x05 \x01(\x0e\x32\'.google.datastore.v1.CommitRequest.Mode\x12\x15\n\x0btransaction\x18\x01 \x01(\x0cH\x00\x12I\n\x16single_use_transaction\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12\x30\n\tmutations\x18\x06 \x03(\x0b\x32\x1d.google.datastore.v1.Mutation\"F\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rTRANSACTIONAL\x10\x01\x12\x15\n\x11NON_TRANSACTIONAL\x10\x02\x42\x16\n\x14transaction_selector\"\x97\x01\n\x0e\x43ommitResponse\x12=\n\x10mutation_results\x18\x03 \x03(\x0b\x32#.google.datastore.v1.MutationResult\x12\x15\n\rindex_updates\x18\x04 \x01(\x05\x12/\n\x0b\x63ommit_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"o\n\x12\x41llocateIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"=\n\x13\x41llocateIdsResponse\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key\"n\n\x11ReserveIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"\x14\n\x12ReserveIdsResponse\"\xba\x02\n\x08Mutation\x12-\n\x06insert\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06update\x18\x05 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06upsert\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12*\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0c\x62\x61se_version\x18\x08 \x01(\x03H\x01\x12\x31\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x42\x0b\n\toperationB\x1d\n\x1b\x63onflict_detection_strategy\"\xc5\x01\n\x0eMutationResult\x12%\n\x03key\x18\x03 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63onflict_detected\x18\x05 \x01(\x08\"\xca\x02\n\x0bReadOptions\x12L\n\x10read_consistency\x18\x01 \x01(\x0e\x32\x30.google.datastore.v1.ReadOptions.ReadConsistencyH\x00\x12\x15\n\x0btransaction\x18\x02 \x01(\x0cH\x00\x12\x42\n\x0fnew_transaction\x18\x03 \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12/\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\"M\n\x0fReadConsistency\x12 \n\x1cREAD_CONSISTENCY_UNSPECIFIED\x10\x00\x12\n\n\x06STRONG\x10\x01\x12\x0c\n\x08\x45VENTUAL\x10\x02\x42\x12\n\x10\x63onsistency_type\"\x92\x02\n\x12TransactionOptions\x12G\n\nread_write\x18\x01 \x01(\x0b\x32\x31.google.datastore.v1.TransactionOptions.ReadWriteH\x00\x12\x45\n\tread_only\x18\x02 \x01(\x0b\x32\x30.google.datastore.v1.TransactionOptions.ReadOnlyH\x00\x1a)\n\tReadWrite\x12\x1c\n\x14previous_transaction\x18\x01 \x01(\x0c\x1a\x39\n\x08ReadOnly\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\n\x04mode2\xe1\r\n\tDatastore\x12\xc0\x01\n\x06Lookup\x12\".google.datastore.v1.LookupRequest\x1a#.google.datastore.v1.LookupResponse\"m\xda\x41\x1cproject_id,read_options,keys\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:lookup:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xa9\x01\n\x08RunQuery\x12$.google.datastore.v1.RunQueryRequest\x1a%.google.datastore.v1.RunQueryResponse\"P\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:runQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd5\x01\n\x13RunAggregationQuery\x12/.google.datastore.v1.RunAggregationQueryRequest\x1a\x30.google.datastore.v1.RunAggregationQueryResponse\"[\x82\xd3\xe4\x93\x02\x32\"-/v1/projects/{project_id}:runAggregationQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd6\x01\n\x10\x42\x65ginTransaction\x12,.google.datastore.v1.BeginTransactionRequest\x1a-.google.datastore.v1.BeginTransactionResponse\"e\xda\x41\nproject_id\x82\xd3\xe4\x93\x02/\"*/v1/projects/{project_id}:beginTransaction:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xe6\x01\n\x06\x43ommit\x12\".google.datastore.v1.CommitRequest\x1a#.google.datastore.v1.CommitResponse\"\x92\x01\xda\x41%project_id,mode,transaction,mutations\xda\x41\x19project_id,mode,mutations\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:commit:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc2\x01\n\x08Rollback\x12$.google.datastore.v1.RollbackRequest\x1a%.google.datastore.v1.RollbackResponse\"i\xda\x41\x16project_id,transaction\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:rollback:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc7\x01\n\x0b\x41llocateIds\x12\'.google.datastore.v1.AllocateIdsRequest\x1a(.google.datastore.v1.AllocateIdsResponse\"e\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02*\"%/v1/projects/{project_id}:allocateIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc3\x01\n\nReserveIds\x12&.google.datastore.v1.ReserveIdsRequest\x1a\'.google.datastore.v1.ReserveIdsResponse\"d\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02)\"$/v1/projects/{project_id}:reserveIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x1av\xca\x41\x18\x64\x61tastore.googleapis.com\xd2\x41Xhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/datastoreB\xc0\x01\n\x17\x63om.google.datastore.v1B\x0e\x44\x61tastoreProtoP\x01Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1\xea\x02\x1cGoogle::Cloud::Datastore::V1b\x06proto3"
|
|
18
19
|
|
|
19
20
|
pool = Google::Protobuf::DescriptorPool.generated_pool
|
|
20
21
|
|
|
@@ -32,6 +33,7 @@ rescue TypeError
|
|
|
32
33
|
["google.datastore.v1.Key", "google/datastore/v1/entity.proto"],
|
|
33
34
|
["google.datastore.v1.EntityResult", "google/datastore/v1/query.proto"],
|
|
34
35
|
["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
|
|
36
|
+
["google.datastore.v1.ExplainOptions", "google/datastore/v1/query_profile.proto"],
|
|
35
37
|
["google.datastore.v1.AggregationResultBatch", "google/datastore/v1/aggregation_result.proto"],
|
|
36
38
|
]
|
|
37
39
|
imports.each do |type_name, expected_filename|
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
|
3
|
+
# source: google/datastore/v1/query_profile.proto
|
|
4
|
+
|
|
5
|
+
require 'google/protobuf'
|
|
6
|
+
|
|
7
|
+
require 'google/api/field_behavior_pb'
|
|
8
|
+
require 'google/protobuf/duration_pb'
|
|
9
|
+
require 'google/protobuf/struct_pb'
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
descriptor_data = "\n\'google/datastore/v1/query_profile.proto\x12\x13google.datastore.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/protobuf/struct.proto\"&\n\x0e\x45xplainOptions\x12\x14\n\x07\x61nalyze\x18\x01 \x01(\x08\x42\x03\xe0\x41\x01\"\x86\x01\n\x0e\x45xplainMetrics\x12\x36\n\x0cplan_summary\x18\x01 \x01(\x0b\x32 .google.datastore.v1.PlanSummary\x12<\n\x0f\x65xecution_stats\x18\x02 \x01(\x0b\x32#.google.datastore.v1.ExecutionStats\"<\n\x0bPlanSummary\x12-\n\x0cindexes_used\x18\x01 \x03(\x0b\x32\x17.google.protobuf.Struct\"\xa8\x01\n\x0e\x45xecutionStats\x12\x18\n\x10results_returned\x18\x01 \x01(\x03\x12\x35\n\x12\x65xecution_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x17\n\x0fread_operations\x18\x04 \x01(\x03\x12,\n\x0b\x64\x65\x62ug_stats\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\xc3\x01\n\x17\x63om.google.datastore.v1B\x11QueryProfileProtoP\x01Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1\xea\x02\x1cGoogle::Cloud::Datastore::V1b\x06proto3"
|
|
13
|
+
|
|
14
|
+
pool = Google::Protobuf::DescriptorPool.generated_pool
|
|
15
|
+
|
|
16
|
+
begin
|
|
17
|
+
pool.add_serialized_file(descriptor_data)
|
|
18
|
+
rescue TypeError
|
|
19
|
+
# Compatibility code: will be removed in the next major version.
|
|
20
|
+
require 'google/protobuf/descriptor_pb'
|
|
21
|
+
parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
|
|
22
|
+
parsed.clear_dependency
|
|
23
|
+
serialized = parsed.class.encode(parsed)
|
|
24
|
+
file = pool.add_serialized_file(serialized)
|
|
25
|
+
warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
|
|
26
|
+
imports = [
|
|
27
|
+
["google.protobuf.Struct", "google/protobuf/struct.proto"],
|
|
28
|
+
["google.protobuf.Duration", "google/protobuf/duration.proto"],
|
|
29
|
+
]
|
|
30
|
+
imports.each do |type_name, expected_filename|
|
|
31
|
+
import_file = pool.lookup(type_name).file_descriptor
|
|
32
|
+
if import_file.name != expected_filename
|
|
33
|
+
warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
|
|
34
|
+
end
|
|
35
|
+
end
|
|
36
|
+
warn "Each proto file must use a consistent fully-qualified name."
|
|
37
|
+
warn "This will become an error in the next major version."
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
module Google
|
|
41
|
+
module Cloud
|
|
42
|
+
module Datastore
|
|
43
|
+
module V1
|
|
44
|
+
ExplainOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.ExplainOptions").msgclass
|
|
45
|
+
ExplainMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.ExplainMetrics").msgclass
|
|
46
|
+
PlanSummary = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.PlanSummary").msgclass
|
|
47
|
+
ExecutionStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.ExecutionStats").msgclass
|
|
48
|
+
end
|
|
49
|
+
end
|
|
50
|
+
end
|
|
51
|
+
end
|
|
@@ -118,6 +118,10 @@ module Google
|
|
|
118
118
|
# @return [::String]
|
|
119
119
|
# Optional link to proto reference documentation. Example:
|
|
120
120
|
# https://cloud.google.com/pubsub/lite/docs/reference/rpc
|
|
121
|
+
# @!attribute [rw] rest_reference_documentation_uri
|
|
122
|
+
# @return [::String]
|
|
123
|
+
# Optional link to REST reference documentation. Example:
|
|
124
|
+
# https://cloud.google.com/pubsub/lite/docs/reference/rest
|
|
121
125
|
class Publishing
|
|
122
126
|
include ::Google::Protobuf::MessageExts
|
|
123
127
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -100,6 +100,10 @@ module Google
|
|
|
100
100
|
# @!attribute [rw] gql_query
|
|
101
101
|
# @return [::Google::Cloud::Datastore::V1::GqlQuery]
|
|
102
102
|
# The GQL query to run. This query must be a non-aggregation query.
|
|
103
|
+
# @!attribute [rw] explain_options
|
|
104
|
+
# @return [::Google::Cloud::Datastore::V1::ExplainOptions]
|
|
105
|
+
# Optional. Explain options for the query. If set, additional query
|
|
106
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
103
107
|
class RunQueryRequest
|
|
104
108
|
include ::Google::Protobuf::MessageExts
|
|
105
109
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -122,6 +126,11 @@ module Google
|
|
|
122
126
|
# {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
|
|
123
127
|
# was set in
|
|
124
128
|
# {::Google::Cloud::Datastore::V1::RunQueryRequest#read_options RunQueryRequest.read_options}.
|
|
129
|
+
# @!attribute [rw] explain_metrics
|
|
130
|
+
# @return [::Google::Cloud::Datastore::V1::ExplainMetrics]
|
|
131
|
+
# Query explain metrics. This is only present when the
|
|
132
|
+
# {::Google::Cloud::Datastore::V1::RunQueryRequest#explain_options RunQueryRequest.explain_options}
|
|
133
|
+
# is provided, and it is sent only once with the last response in the stream.
|
|
125
134
|
class RunQueryResponse
|
|
126
135
|
include ::Google::Protobuf::MessageExts
|
|
127
136
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -153,6 +162,10 @@ module Google
|
|
|
153
162
|
# @!attribute [rw] gql_query
|
|
154
163
|
# @return [::Google::Cloud::Datastore::V1::GqlQuery]
|
|
155
164
|
# The GQL query to run. This query must be an aggregation query.
|
|
165
|
+
# @!attribute [rw] explain_options
|
|
166
|
+
# @return [::Google::Cloud::Datastore::V1::ExplainOptions]
|
|
167
|
+
# Optional. Explain options for the query. If set, additional query
|
|
168
|
+
# statistics will be returned. If not, only query results will be returned.
|
|
156
169
|
class RunAggregationQueryRequest
|
|
157
170
|
include ::Google::Protobuf::MessageExts
|
|
158
171
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -175,6 +188,11 @@ module Google
|
|
|
175
188
|
# {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
|
|
176
189
|
# was set in
|
|
177
190
|
# {::Google::Cloud::Datastore::V1::RunAggregationQueryRequest#read_options RunAggregationQueryRequest.read_options}.
|
|
191
|
+
# @!attribute [rw] explain_metrics
|
|
192
|
+
# @return [::Google::Cloud::Datastore::V1::ExplainMetrics]
|
|
193
|
+
# Query explain metrics. This is only present when the
|
|
194
|
+
# {::Google::Cloud::Datastore::V1::RunAggregationQueryRequest#explain_options RunAggregationQueryRequest.explain_options}
|
|
195
|
+
# is provided, and it is sent only once with the last response in the stream.
|
|
178
196
|
class RunAggregationQueryResponse
|
|
179
197
|
include ::Google::Protobuf::MessageExts
|
|
180
198
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
# Copyright 2024 Google LLC
|
|
4
|
+
#
|
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
# you may not use this file except in compliance with the License.
|
|
7
|
+
# You may obtain a copy of the License at
|
|
8
|
+
#
|
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
#
|
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
# See the License for the specific language governing permissions and
|
|
15
|
+
# limitations under the License.
|
|
16
|
+
|
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
module Google
|
|
21
|
+
module Cloud
|
|
22
|
+
module Datastore
|
|
23
|
+
module V1
|
|
24
|
+
# Explain options for the query.
|
|
25
|
+
# @!attribute [rw] analyze
|
|
26
|
+
# @return [::Boolean]
|
|
27
|
+
# Optional. Whether to execute this query.
|
|
28
|
+
#
|
|
29
|
+
# When false (the default), the query will be planned, returning only
|
|
30
|
+
# metrics from the planning stages.
|
|
31
|
+
#
|
|
32
|
+
# When true, the query will be planned and executed, returning the full
|
|
33
|
+
# query results along with both planning and execution stage metrics.
|
|
34
|
+
class ExplainOptions
|
|
35
|
+
include ::Google::Protobuf::MessageExts
|
|
36
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
# Explain metrics for the query.
|
|
40
|
+
# @!attribute [rw] plan_summary
|
|
41
|
+
# @return [::Google::Cloud::Datastore::V1::PlanSummary]
|
|
42
|
+
# Planning phase information for the query.
|
|
43
|
+
# @!attribute [rw] execution_stats
|
|
44
|
+
# @return [::Google::Cloud::Datastore::V1::ExecutionStats]
|
|
45
|
+
# Aggregated stats from the execution of the query. Only present when
|
|
46
|
+
# {::Google::Cloud::Datastore::V1::ExplainOptions#analyze ExplainOptions.analyze} is set
|
|
47
|
+
# to true.
|
|
48
|
+
class ExplainMetrics
|
|
49
|
+
include ::Google::Protobuf::MessageExts
|
|
50
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
51
|
+
end
|
|
52
|
+
|
|
53
|
+
# Planning phase information for the query.
|
|
54
|
+
# @!attribute [rw] indexes_used
|
|
55
|
+
# @return [::Array<::Google::Protobuf::Struct>]
|
|
56
|
+
# The indexes selected for the query. For example:
|
|
57
|
+
# [
|
|
58
|
+
# \\{"query_scope": "Collection", "properties": "(foo ASC, __name__ ASC)"},
|
|
59
|
+
# \\{"query_scope": "Collection", "properties": "(bar ASC, __name__ ASC)"}
|
|
60
|
+
# ]
|
|
61
|
+
class PlanSummary
|
|
62
|
+
include ::Google::Protobuf::MessageExts
|
|
63
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
64
|
+
end
|
|
65
|
+
|
|
66
|
+
# Execution statistics for the query.
|
|
67
|
+
# @!attribute [rw] results_returned
|
|
68
|
+
# @return [::Integer]
|
|
69
|
+
# Total number of results returned, including documents, projections,
|
|
70
|
+
# aggregation results, keys.
|
|
71
|
+
# @!attribute [rw] execution_duration
|
|
72
|
+
# @return [::Google::Protobuf::Duration]
|
|
73
|
+
# Total time to execute the query in the backend.
|
|
74
|
+
# @!attribute [rw] read_operations
|
|
75
|
+
# @return [::Integer]
|
|
76
|
+
# Total billable read operations.
|
|
77
|
+
# @!attribute [rw] debug_stats
|
|
78
|
+
# @return [::Google::Protobuf::Struct]
|
|
79
|
+
# Debugging statistics from the execution of the query. Note that the
|
|
80
|
+
# debugging stats are subject to change as Firestore evolves. It could
|
|
81
|
+
# include:
|
|
82
|
+
# {
|
|
83
|
+
# "indexes_entries_scanned": "1000",
|
|
84
|
+
# "documents_scanned": "20",
|
|
85
|
+
# "billing_details" : {
|
|
86
|
+
# "documents_billable": "20",
|
|
87
|
+
# "index_entries_billable": "1000",
|
|
88
|
+
# "min_query_cost": "0"
|
|
89
|
+
# }
|
|
90
|
+
# }
|
|
91
|
+
class ExecutionStats
|
|
92
|
+
include ::Google::Protobuf::MessageExts
|
|
93
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
94
|
+
end
|
|
95
|
+
end
|
|
96
|
+
end
|
|
97
|
+
end
|
|
98
|
+
end
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: google-cloud-datastore-v1
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.18.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: 2024-
|
|
11
|
+
date: 2024-03-22 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: gapic-common
|
|
@@ -72,6 +72,7 @@ files:
|
|
|
72
72
|
- lib/google/datastore/v1/datastore_services_pb.rb
|
|
73
73
|
- lib/google/datastore/v1/entity_pb.rb
|
|
74
74
|
- lib/google/datastore/v1/query_pb.rb
|
|
75
|
+
- lib/google/datastore/v1/query_profile_pb.rb
|
|
75
76
|
- proto_docs/README.md
|
|
76
77
|
- proto_docs/google/api/client.rb
|
|
77
78
|
- proto_docs/google/api/field_behavior.rb
|
|
@@ -82,6 +83,7 @@ files:
|
|
|
82
83
|
- proto_docs/google/datastore/v1/datastore.rb
|
|
83
84
|
- proto_docs/google/datastore/v1/entity.rb
|
|
84
85
|
- proto_docs/google/datastore/v1/query.rb
|
|
86
|
+
- proto_docs/google/datastore/v1/query_profile.rb
|
|
85
87
|
- proto_docs/google/protobuf/duration.rb
|
|
86
88
|
- proto_docs/google/protobuf/struct.rb
|
|
87
89
|
- proto_docs/google/protobuf/timestamp.rb
|