google-cloud-bigtable-v2 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/lib/google/bigtable/v2/bigtable_pb.rb +10 -0
- data/lib/google/bigtable/v2/request_stats_pb.rb +49 -0
- data/lib/google/bigtable/v2/response_params_pb.rb +23 -0
- data/lib/google/cloud/bigtable/v2/bigtable/client.rb +26 -22
- data/lib/google/cloud/bigtable/v2/version.rb +1 -1
- data/proto_docs/google/bigtable/v2/bigtable.rb +69 -25
- data/proto_docs/google/bigtable/v2/request_stats.rb +121 -0
- data/proto_docs/google/bigtable/v2/response_params.rb +42 -0
- data/proto_docs/google/protobuf/duration.rb +98 -0
- metadata +9 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9d95d9ba14cb16bd07793227a4cee13bda16cb26b3e901c89c2c05faa9a3face
|
4
|
+
data.tar.gz: 21d78d9dc582f3beb6555eade471e89e3eb55a7402c185cfd962f7cfb24e7845
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8f7f1346f52674c2229a73b90f44c920351885d117a0ed368856eaf20bf5c33f4c61a001a8622e9f53a04ed0e4ae92f556a9213fa68c373bbe4f4076b6edd43c
|
7
|
+
data.tar.gz: 3c6551336d90500086d5d8d03377a3c7ed9b8f14de8fd230a4ccc52eed036863f7739eaadbeaff246ce93ba5761e909385d81a673eb8c38b4fdad4cfdbd83fec
|
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
|
@@ -9,6 +9,7 @@ require 'google/api/field_behavior_pb'
|
|
9
9
|
require 'google/api/resource_pb'
|
10
10
|
require 'google/api/routing_pb'
|
11
11
|
require 'google/bigtable/v2/data_pb'
|
12
|
+
require 'google/bigtable/v2/request_stats_pb'
|
12
13
|
require 'google/protobuf/wrappers_pb'
|
13
14
|
require 'google/rpc/status_pb'
|
14
15
|
|
@@ -20,10 +21,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
20
21
|
optional :rows, :message, 2, "google.bigtable.v2.RowSet"
|
21
22
|
optional :filter, :message, 3, "google.bigtable.v2.RowFilter"
|
22
23
|
optional :rows_limit, :int64, 4
|
24
|
+
optional :request_stats_view, :enum, 6, "google.bigtable.v2.ReadRowsRequest.RequestStatsView"
|
25
|
+
end
|
26
|
+
add_enum "google.bigtable.v2.ReadRowsRequest.RequestStatsView" do
|
27
|
+
value :REQUEST_STATS_VIEW_UNSPECIFIED, 0
|
28
|
+
value :REQUEST_STATS_NONE, 1
|
29
|
+
value :REQUEST_STATS_EFFICIENCY, 2
|
30
|
+
value :REQUEST_STATS_FULL, 3
|
23
31
|
end
|
24
32
|
add_message "google.bigtable.v2.ReadRowsResponse" do
|
25
33
|
repeated :chunks, :message, 1, "google.bigtable.v2.ReadRowsResponse.CellChunk"
|
26
34
|
optional :last_scanned_row_key, :bytes, 2
|
35
|
+
optional :request_stats, :message, 3, "google.bigtable.v2.RequestStats"
|
27
36
|
end
|
28
37
|
add_message "google.bigtable.v2.ReadRowsResponse.CellChunk" do
|
29
38
|
optional :row_key, :bytes, 1
|
@@ -104,6 +113,7 @@ module Google
|
|
104
113
|
module Bigtable
|
105
114
|
module V2
|
106
115
|
ReadRowsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsRequest").msgclass
|
116
|
+
ReadRowsRequest::RequestStatsView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsRequest.RequestStatsView").enummodule
|
107
117
|
ReadRowsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse").msgclass
|
108
118
|
ReadRowsResponse::CellChunk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse.CellChunk").msgclass
|
109
119
|
SampleRowKeysRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.SampleRowKeysRequest").msgclass
|
@@ -0,0 +1,49 @@
|
|
1
|
+
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
|
+
# source: google/bigtable/v2/request_stats.proto
|
3
|
+
|
4
|
+
require 'google/protobuf'
|
5
|
+
|
6
|
+
require 'google/protobuf/duration_pb'
|
7
|
+
|
8
|
+
Google::Protobuf::DescriptorPool.generated_pool.build do
|
9
|
+
add_file("google/bigtable/v2/request_stats.proto", :syntax => :proto3) do
|
10
|
+
add_message "google.bigtable.v2.ReadIteratorStats" do
|
11
|
+
optional :rows_seen_count, :int64, 1
|
12
|
+
optional :rows_returned_count, :int64, 2
|
13
|
+
optional :cells_seen_count, :int64, 3
|
14
|
+
optional :cells_returned_count, :int64, 4
|
15
|
+
optional :deletes_seen_count, :int64, 5
|
16
|
+
end
|
17
|
+
add_message "google.bigtable.v2.RequestLatencyStats" do
|
18
|
+
optional :frontend_server_latency, :message, 1, "google.protobuf.Duration"
|
19
|
+
end
|
20
|
+
add_message "google.bigtable.v2.ReadEfficiencyStats" do
|
21
|
+
optional :read_iterator_stats, :message, 1, "google.bigtable.v2.ReadIteratorStats"
|
22
|
+
optional :request_latency_stats, :message, 2, "google.bigtable.v2.RequestLatencyStats"
|
23
|
+
end
|
24
|
+
add_message "google.bigtable.v2.AllReadStats" do
|
25
|
+
optional :read_iterator_stats, :message, 1, "google.bigtable.v2.ReadIteratorStats"
|
26
|
+
optional :request_latency_stats, :message, 2, "google.bigtable.v2.RequestLatencyStats"
|
27
|
+
end
|
28
|
+
add_message "google.bigtable.v2.RequestStats" do
|
29
|
+
oneof :stats do
|
30
|
+
optional :read_efficiency_stats, :message, 1, "google.bigtable.v2.ReadEfficiencyStats"
|
31
|
+
optional :all_read_stats, :message, 2, "google.bigtable.v2.AllReadStats"
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|
36
|
+
|
37
|
+
module Google
|
38
|
+
module Cloud
|
39
|
+
module Bigtable
|
40
|
+
module V2
|
41
|
+
ReadIteratorStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadIteratorStats").msgclass
|
42
|
+
RequestLatencyStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.RequestLatencyStats").msgclass
|
43
|
+
ReadEfficiencyStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadEfficiencyStats").msgclass
|
44
|
+
AllReadStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.AllReadStats").msgclass
|
45
|
+
RequestStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.RequestStats").msgclass
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
@@ -0,0 +1,23 @@
|
|
1
|
+
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
|
+
# source: google/bigtable/v2/response_params.proto
|
3
|
+
|
4
|
+
require 'google/protobuf'
|
5
|
+
|
6
|
+
Google::Protobuf::DescriptorPool.generated_pool.build do
|
7
|
+
add_file("google/bigtable/v2/response_params.proto", :syntax => :proto3) do
|
8
|
+
add_message "google.bigtable.v2.ResponseParams" do
|
9
|
+
proto3_optional :zone_id, :string, 1
|
10
|
+
proto3_optional :cluster_id, :string, 2
|
11
|
+
end
|
12
|
+
end
|
13
|
+
end
|
14
|
+
|
15
|
+
module Google
|
16
|
+
module Cloud
|
17
|
+
module Bigtable
|
18
|
+
module V2
|
19
|
+
ResponseParams = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ResponseParams").msgclass
|
20
|
+
end
|
21
|
+
end
|
22
|
+
end
|
23
|
+
end
|
@@ -176,7 +176,7 @@ module Google
|
|
176
176
|
# @param options [::Gapic::CallOptions, ::Hash]
|
177
177
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
178
178
|
#
|
179
|
-
# @overload read_rows(table_name: nil, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil)
|
179
|
+
# @overload read_rows(table_name: nil, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil, request_stats_view: nil)
|
180
180
|
# Pass arguments to `read_rows` via keyword arguments. Note that at
|
181
181
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
182
182
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
@@ -186,8 +186,8 @@ module Google
|
|
186
186
|
# Values are of the form
|
187
187
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
188
188
|
# @param app_profile_id [::String]
|
189
|
-
# This value specifies routing for replication.
|
190
|
-
#
|
189
|
+
# This value specifies routing for replication. This API only accepts the
|
190
|
+
# empty value of app_profile_id.
|
191
191
|
# @param rows [::Google::Cloud::Bigtable::V2::RowSet, ::Hash]
|
192
192
|
# The row keys and/or ranges to read sequentially. If not specified, reads
|
193
193
|
# from all rows.
|
@@ -197,6 +197,8 @@ module Google
|
|
197
197
|
# @param rows_limit [::Integer]
|
198
198
|
# The read will stop after committing to N rows' worth of results. The
|
199
199
|
# default (zero) is to return all results.
|
200
|
+
# @param request_stats_view [::Google::Cloud::Bigtable::V2::ReadRowsRequest::RequestStatsView]
|
201
|
+
# The view into RequestStats, as described above.
|
200
202
|
#
|
201
203
|
# @yield [response, operation] Access the result along with the RPC operation
|
202
204
|
# @yieldparam response [::Enumerable<::Google::Cloud::Bigtable::V2::ReadRowsResponse>]
|
@@ -389,8 +391,8 @@ module Google
|
|
389
391
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
390
392
|
#
|
391
393
|
# @param table_name [::String]
|
392
|
-
# Required. The unique name of the table to which the mutation should be
|
393
|
-
# Values are of the form
|
394
|
+
# Required. The unique name of the table to which the mutation should be
|
395
|
+
# applied. Values are of the form
|
394
396
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
395
397
|
# @param app_profile_id [::String]
|
396
398
|
# This value specifies routing for replication. If not specified, the
|
@@ -398,9 +400,9 @@ module Google
|
|
398
400
|
# @param row_key [::String]
|
399
401
|
# Required. The key of the row to which the mutation should be applied.
|
400
402
|
# @param mutations [::Array<::Google::Cloud::Bigtable::V2::Mutation, ::Hash>]
|
401
|
-
# Required. Changes to be atomically applied to the specified row. Entries
|
402
|
-
# in order, meaning that earlier mutations can be masked by later
|
403
|
-
# Must contain at least one entry and at most 100000.
|
403
|
+
# Required. Changes to be atomically applied to the specified row. Entries
|
404
|
+
# are applied in order, meaning that earlier mutations can be masked by later
|
405
|
+
# ones. Must contain at least one entry and at most 100000.
|
404
406
|
#
|
405
407
|
# @yield [response, operation] Access the result along with the RPC operation
|
406
408
|
# @yieldparam response [::Google::Cloud::Bigtable::V2::MutateRowResponse]
|
@@ -491,7 +493,8 @@ module Google
|
|
491
493
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
492
494
|
#
|
493
495
|
# @param table_name [::String]
|
494
|
-
# Required. The unique name of the table to which the mutations should be
|
496
|
+
# Required. The unique name of the table to which the mutations should be
|
497
|
+
# applied.
|
495
498
|
# @param app_profile_id [::String]
|
496
499
|
# This value specifies routing for replication. If not specified, the
|
497
500
|
# "default" application profile will be used.
|
@@ -592,15 +595,15 @@ module Google
|
|
592
595
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
593
596
|
#
|
594
597
|
# @param table_name [::String]
|
595
|
-
# Required. The unique name of the table to which the conditional mutation
|
596
|
-
# applied.
|
597
|
-
# Values are of the form
|
598
|
+
# Required. The unique name of the table to which the conditional mutation
|
599
|
+
# should be applied. Values are of the form
|
598
600
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
599
601
|
# @param app_profile_id [::String]
|
600
602
|
# This value specifies routing for replication. If not specified, the
|
601
603
|
# "default" application profile will be used.
|
602
604
|
# @param row_key [::String]
|
603
|
-
# Required. The key of the row to which the conditional mutation should be
|
605
|
+
# Required. The key of the row to which the conditional mutation should be
|
606
|
+
# applied.
|
604
607
|
# @param predicate_filter [::Google::Cloud::Bigtable::V2::RowFilter, ::Hash]
|
605
608
|
# The filter to be applied to the contents of the specified row. Depending
|
606
609
|
# on whether or not any results are yielded, either `true_mutations` or
|
@@ -707,8 +710,9 @@ module Google
|
|
707
710
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
708
711
|
#
|
709
712
|
# @param name [::String]
|
710
|
-
# Required. The unique name of the instance to check permissions for as well
|
711
|
-
# respond. Values are of the form
|
713
|
+
# Required. The unique name of the instance to check permissions for as well
|
714
|
+
# as respond. Values are of the form
|
715
|
+
# `projects/<project>/instances/<instance>`.
|
712
716
|
# @param app_profile_id [::String]
|
713
717
|
# This value specifies routing for replication. If not specified, the
|
714
718
|
# "default" application profile will be used.
|
@@ -804,19 +808,19 @@ module Google
|
|
804
808
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
805
809
|
#
|
806
810
|
# @param table_name [::String]
|
807
|
-
# Required. The unique name of the table to which the read/modify/write rules
|
808
|
-
# applied.
|
809
|
-
# Values are of the form
|
811
|
+
# Required. The unique name of the table to which the read/modify/write rules
|
812
|
+
# should be applied. Values are of the form
|
810
813
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
811
814
|
# @param app_profile_id [::String]
|
812
815
|
# This value specifies routing for replication. If not specified, the
|
813
816
|
# "default" application profile will be used.
|
814
817
|
# @param row_key [::String]
|
815
|
-
# Required. The key of the row to which the read/modify/write rules should be
|
818
|
+
# Required. The key of the row to which the read/modify/write rules should be
|
819
|
+
# applied.
|
816
820
|
# @param rules [::Array<::Google::Cloud::Bigtable::V2::ReadModifyWriteRule, ::Hash>]
|
817
|
-
# Required. Rules specifying how the specified row's contents are to be
|
818
|
-
# into writes. Entries are applied in order, meaning that earlier
|
819
|
-
# affect the results of later ones.
|
821
|
+
# Required. Rules specifying how the specified row's contents are to be
|
822
|
+
# transformed into writes. Entries are applied in order, meaning that earlier
|
823
|
+
# rules will affect the results of later ones.
|
820
824
|
#
|
821
825
|
# @yield [response, operation] Access the result along with the RPC operation
|
822
826
|
# @yieldparam response [::Google::Cloud::Bigtable::V2::ReadModifyWriteRowResponse]
|
@@ -29,8 +29,8 @@ module Google
|
|
29
29
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
30
30
|
# @!attribute [rw] app_profile_id
|
31
31
|
# @return [::String]
|
32
|
-
# This value specifies routing for replication.
|
33
|
-
#
|
32
|
+
# This value specifies routing for replication. This API only accepts the
|
33
|
+
# empty value of app_profile_id.
|
34
34
|
# @!attribute [rw] rows
|
35
35
|
# @return [::Google::Cloud::Bigtable::V2::RowSet]
|
36
36
|
# The row keys and/or ranges to read sequentially. If not specified, reads
|
@@ -43,9 +43,31 @@ module Google
|
|
43
43
|
# @return [::Integer]
|
44
44
|
# The read will stop after committing to N rows' worth of results. The
|
45
45
|
# default (zero) is to return all results.
|
46
|
+
# @!attribute [rw] request_stats_view
|
47
|
+
# @return [::Google::Cloud::Bigtable::V2::ReadRowsRequest::RequestStatsView]
|
48
|
+
# The view into RequestStats, as described above.
|
46
49
|
class ReadRowsRequest
|
47
50
|
include ::Google::Protobuf::MessageExts
|
48
51
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
52
|
+
|
53
|
+
# The desired view into RequestStats that should be returned in the response.
|
54
|
+
#
|
55
|
+
# See also: RequestStats message.
|
56
|
+
module RequestStatsView
|
57
|
+
# The default / unset value. The API will default to the NONE option below.
|
58
|
+
REQUEST_STATS_VIEW_UNSPECIFIED = 0
|
59
|
+
|
60
|
+
# Do not include any RequestStats in the response. This will leave the
|
61
|
+
# RequestStats embedded message unset in the response.
|
62
|
+
REQUEST_STATS_NONE = 1
|
63
|
+
|
64
|
+
# Include stats related to the efficiency of the read.
|
65
|
+
REQUEST_STATS_EFFICIENCY = 2
|
66
|
+
|
67
|
+
# Include the full set of available RequestStats in the response,
|
68
|
+
# applicable to this read.
|
69
|
+
REQUEST_STATS_FULL = 3
|
70
|
+
end
|
49
71
|
end
|
50
72
|
|
51
73
|
# Response message for Bigtable.ReadRows.
|
@@ -61,6 +83,27 @@ module Google
|
|
61
83
|
# This is primarily useful for cases where the server has read a
|
62
84
|
# lot of data that was filtered out since the last committed row
|
63
85
|
# key, allowing the client to skip that work on a retry.
|
86
|
+
# @!attribute [rw] request_stats
|
87
|
+
# @return [::Google::Cloud::Bigtable::V2::RequestStats]
|
88
|
+
# If requested, provide enhanced query performance statistics. The semantics
|
89
|
+
# dictate:
|
90
|
+
# * request_stats is empty on every (streamed) response, except
|
91
|
+
# * request_stats has non-empty information after all chunks have been
|
92
|
+
# streamed, where the ReadRowsResponse message only contains
|
93
|
+
# request_stats.
|
94
|
+
# * For example, if a read request would have returned an empty
|
95
|
+
# response instead a single ReadRowsResponse is streamed with empty
|
96
|
+
# chunks and request_stats filled.
|
97
|
+
#
|
98
|
+
# Visually, response messages will stream as follows:
|
99
|
+
# ... -> \\{chunks: [...]} -> \\{chunks: [], request_stats: \\{...}}
|
100
|
+
# \______________________/ \________________________________/
|
101
|
+
# Primary response Trailer of RequestStats info
|
102
|
+
#
|
103
|
+
# Or if the read did not return any values:
|
104
|
+
# \\{chunks: [], request_stats: \\{...}}
|
105
|
+
# \________________________________/
|
106
|
+
# Trailer of RequestStats info
|
64
107
|
class ReadRowsResponse
|
65
108
|
include ::Google::Protobuf::MessageExts
|
66
109
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -169,8 +212,8 @@ module Google
|
|
169
212
|
# Request message for Bigtable.MutateRow.
|
170
213
|
# @!attribute [rw] table_name
|
171
214
|
# @return [::String]
|
172
|
-
# Required. The unique name of the table to which the mutation should be
|
173
|
-
# Values are of the form
|
215
|
+
# Required. The unique name of the table to which the mutation should be
|
216
|
+
# applied. Values are of the form
|
174
217
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
175
218
|
# @!attribute [rw] app_profile_id
|
176
219
|
# @return [::String]
|
@@ -181,9 +224,9 @@ module Google
|
|
181
224
|
# Required. The key of the row to which the mutation should be applied.
|
182
225
|
# @!attribute [rw] mutations
|
183
226
|
# @return [::Array<::Google::Cloud::Bigtable::V2::Mutation>]
|
184
|
-
# Required. Changes to be atomically applied to the specified row. Entries
|
185
|
-
# in order, meaning that earlier mutations can be masked by later
|
186
|
-
# Must contain at least one entry and at most 100000.
|
227
|
+
# Required. Changes to be atomically applied to the specified row. Entries
|
228
|
+
# are applied in order, meaning that earlier mutations can be masked by later
|
229
|
+
# ones. Must contain at least one entry and at most 100000.
|
187
230
|
class MutateRowRequest
|
188
231
|
include ::Google::Protobuf::MessageExts
|
189
232
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -198,7 +241,8 @@ module Google
|
|
198
241
|
# Request message for BigtableService.MutateRows.
|
199
242
|
# @!attribute [rw] table_name
|
200
243
|
# @return [::String]
|
201
|
-
# Required. The unique name of the table to which the mutations should be
|
244
|
+
# Required. The unique name of the table to which the mutations should be
|
245
|
+
# applied.
|
202
246
|
# @!attribute [rw] app_profile_id
|
203
247
|
# @return [::String]
|
204
248
|
# This value specifies routing for replication. If not specified, the
|
@@ -220,10 +264,9 @@ module Google
|
|
220
264
|
# The key of the row to which the `mutations` should be applied.
|
221
265
|
# @!attribute [rw] mutations
|
222
266
|
# @return [::Array<::Google::Cloud::Bigtable::V2::Mutation>]
|
223
|
-
# Required. Changes to be atomically applied to the specified row.
|
224
|
-
# applied in order, meaning that earlier mutations can be
|
225
|
-
# later ones.
|
226
|
-
# You must specify at least one mutation.
|
267
|
+
# Required. Changes to be atomically applied to the specified row.
|
268
|
+
# Mutations are applied in order, meaning that earlier mutations can be
|
269
|
+
# masked by later ones. You must specify at least one mutation.
|
227
270
|
class Entry
|
228
271
|
include ::Google::Protobuf::MessageExts
|
229
272
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -258,9 +301,8 @@ module Google
|
|
258
301
|
# Request message for Bigtable.CheckAndMutateRow.
|
259
302
|
# @!attribute [rw] table_name
|
260
303
|
# @return [::String]
|
261
|
-
# Required. The unique name of the table to which the conditional mutation
|
262
|
-
# applied.
|
263
|
-
# Values are of the form
|
304
|
+
# Required. The unique name of the table to which the conditional mutation
|
305
|
+
# should be applied. Values are of the form
|
264
306
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
265
307
|
# @!attribute [rw] app_profile_id
|
266
308
|
# @return [::String]
|
@@ -268,7 +310,8 @@ module Google
|
|
268
310
|
# "default" application profile will be used.
|
269
311
|
# @!attribute [rw] row_key
|
270
312
|
# @return [::String]
|
271
|
-
# Required. The key of the row to which the conditional mutation should be
|
313
|
+
# Required. The key of the row to which the conditional mutation should be
|
314
|
+
# applied.
|
272
315
|
# @!attribute [rw] predicate_filter
|
273
316
|
# @return [::Google::Cloud::Bigtable::V2::RowFilter]
|
274
317
|
# The filter to be applied to the contents of the specified row. Depending
|
@@ -307,8 +350,9 @@ module Google
|
|
307
350
|
# Request message for client connection keep-alive and warming.
|
308
351
|
# @!attribute [rw] name
|
309
352
|
# @return [::String]
|
310
|
-
# Required. The unique name of the instance to check permissions for as well
|
311
|
-
# respond. Values are of the form
|
353
|
+
# Required. The unique name of the instance to check permissions for as well
|
354
|
+
# as respond. Values are of the form
|
355
|
+
# `projects/<project>/instances/<instance>`.
|
312
356
|
# @!attribute [rw] app_profile_id
|
313
357
|
# @return [::String]
|
314
358
|
# This value specifies routing for replication. If not specified, the
|
@@ -327,9 +371,8 @@ module Google
|
|
327
371
|
# Request message for Bigtable.ReadModifyWriteRow.
|
328
372
|
# @!attribute [rw] table_name
|
329
373
|
# @return [::String]
|
330
|
-
# Required. The unique name of the table to which the read/modify/write rules
|
331
|
-
# applied.
|
332
|
-
# Values are of the form
|
374
|
+
# Required. The unique name of the table to which the read/modify/write rules
|
375
|
+
# should be applied. Values are of the form
|
333
376
|
# `projects/<project>/instances/<instance>/tables/<table>`.
|
334
377
|
# @!attribute [rw] app_profile_id
|
335
378
|
# @return [::String]
|
@@ -337,12 +380,13 @@ module Google
|
|
337
380
|
# "default" application profile will be used.
|
338
381
|
# @!attribute [rw] row_key
|
339
382
|
# @return [::String]
|
340
|
-
# Required. The key of the row to which the read/modify/write rules should be
|
383
|
+
# Required. The key of the row to which the read/modify/write rules should be
|
384
|
+
# applied.
|
341
385
|
# @!attribute [rw] rules
|
342
386
|
# @return [::Array<::Google::Cloud::Bigtable::V2::ReadModifyWriteRule>]
|
343
|
-
# Required. Rules specifying how the specified row's contents are to be
|
344
|
-
# into writes. Entries are applied in order, meaning that earlier
|
345
|
-
# affect the results of later ones.
|
387
|
+
# Required. Rules specifying how the specified row's contents are to be
|
388
|
+
# transformed into writes. Entries are applied in order, meaning that earlier
|
389
|
+
# rules will affect the results of later ones.
|
346
390
|
class ReadModifyWriteRowRequest
|
347
391
|
include ::Google::Protobuf::MessageExts
|
348
392
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -0,0 +1,121 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2022 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 Bigtable
|
23
|
+
module V2
|
24
|
+
# ReadIteratorStats captures information about the iteration of rows or cells
|
25
|
+
# over the course of a read, e.g. how many results were scanned in a read
|
26
|
+
# operation versus the results returned.
|
27
|
+
# @!attribute [rw] rows_seen_count
|
28
|
+
# @return [::Integer]
|
29
|
+
# The rows seen (scanned) as part of the request. This includes the count of
|
30
|
+
# rows returned, as captured below.
|
31
|
+
# @!attribute [rw] rows_returned_count
|
32
|
+
# @return [::Integer]
|
33
|
+
# The rows returned as part of the request.
|
34
|
+
# @!attribute [rw] cells_seen_count
|
35
|
+
# @return [::Integer]
|
36
|
+
# The cells seen (scanned) as part of the request. This includes the count of
|
37
|
+
# cells returned, as captured below.
|
38
|
+
# @!attribute [rw] cells_returned_count
|
39
|
+
# @return [::Integer]
|
40
|
+
# The cells returned as part of the request.
|
41
|
+
# @!attribute [rw] deletes_seen_count
|
42
|
+
# @return [::Integer]
|
43
|
+
# The deletes seen as part of the request.
|
44
|
+
class ReadIteratorStats
|
45
|
+
include ::Google::Protobuf::MessageExts
|
46
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
47
|
+
end
|
48
|
+
|
49
|
+
# RequestLatencyStats provides a measurement of the latency of the request as
|
50
|
+
# it interacts with different systems over its lifetime, e.g. how long the
|
51
|
+
# request took to execute within a frontend server.
|
52
|
+
# @!attribute [rw] frontend_server_latency
|
53
|
+
# @return [::Google::Protobuf::Duration]
|
54
|
+
# The latency measured by the frontend server handling this request, from
|
55
|
+
# when the request was received, to when this value is sent back in the
|
56
|
+
# response. For more context on the component that is measuring this latency,
|
57
|
+
# see: https://cloud.google.com/bigtable/docs/overview
|
58
|
+
#
|
59
|
+
# Note: This value may be slightly shorter than the value reported into
|
60
|
+
# aggregate latency metrics in Monitoring for this request
|
61
|
+
# (https://cloud.google.com/bigtable/docs/monitoring-instance) as this value
|
62
|
+
# needs to be sent in the response before the latency measurement including
|
63
|
+
# that transmission is finalized.
|
64
|
+
class RequestLatencyStats
|
65
|
+
include ::Google::Protobuf::MessageExts
|
66
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
67
|
+
end
|
68
|
+
|
69
|
+
# ReadEfficiencyStats captures information about the efficiency of a read.
|
70
|
+
# @!attribute [rw] read_iterator_stats
|
71
|
+
# @return [::Google::Cloud::Bigtable::V2::ReadIteratorStats]
|
72
|
+
# Iteration stats describe how efficient the read is, e.g. comparing
|
73
|
+
# rows seen vs. rows returned or cells seen vs cells returned can provide an
|
74
|
+
# indication of read efficiency (the higher the ratio of seen to retuned the
|
75
|
+
# better).
|
76
|
+
# @!attribute [rw] request_latency_stats
|
77
|
+
# @return [::Google::Cloud::Bigtable::V2::RequestLatencyStats]
|
78
|
+
# Request latency stats describe the time taken to complete a request, from
|
79
|
+
# the server side.
|
80
|
+
class ReadEfficiencyStats
|
81
|
+
include ::Google::Protobuf::MessageExts
|
82
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
83
|
+
end
|
84
|
+
|
85
|
+
# AllReadStats captures all known information about a read.
|
86
|
+
# @!attribute [rw] read_iterator_stats
|
87
|
+
# @return [::Google::Cloud::Bigtable::V2::ReadIteratorStats]
|
88
|
+
# Iteration stats describe how efficient the read is, e.g. comparing
|
89
|
+
# rows seen vs. rows returned or cells seen vs cells returned can provide an
|
90
|
+
# indication of read efficiency (the higher the ratio of seen to retuned the
|
91
|
+
# better).
|
92
|
+
# @!attribute [rw] request_latency_stats
|
93
|
+
# @return [::Google::Cloud::Bigtable::V2::RequestLatencyStats]
|
94
|
+
# Request latency stats describe the time taken to complete a request, from
|
95
|
+
# the server side.
|
96
|
+
class AllReadStats
|
97
|
+
include ::Google::Protobuf::MessageExts
|
98
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
99
|
+
end
|
100
|
+
|
101
|
+
# RequestStats is the container for additional information pertaining to a
|
102
|
+
# single request, helpful for evaluating the performance of the sent request.
|
103
|
+
# Currently, there are the following supported methods:
|
104
|
+
# * google.bigtable.v2.ReadRows
|
105
|
+
# @!attribute [rw] read_efficiency_stats
|
106
|
+
# @return [::Google::Cloud::Bigtable::V2::ReadEfficiencyStats]
|
107
|
+
# Available with the
|
108
|
+
# ReadRowsRequest.RequestStatsView.REQUEST_STATS_EFFICIENCY view, see
|
109
|
+
# package google.bigtable.v2.
|
110
|
+
# @!attribute [rw] all_read_stats
|
111
|
+
# @return [::Google::Cloud::Bigtable::V2::AllReadStats]
|
112
|
+
# Available with the ReadRowsRequest.RequestStatsView.REQUEST_STATS_FULL
|
113
|
+
# view, see package google.bigtable.v2.
|
114
|
+
class RequestStats
|
115
|
+
include ::Google::Protobuf::MessageExts
|
116
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
117
|
+
end
|
118
|
+
end
|
119
|
+
end
|
120
|
+
end
|
121
|
+
end
|
@@ -0,0 +1,42 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2022 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 Bigtable
|
23
|
+
module V2
|
24
|
+
# Response metadata proto
|
25
|
+
# This is an experimental feature that will be used to get zone_id and
|
26
|
+
# cluster_id from response trailers to tag the metrics. This should not be
|
27
|
+
# used by customers directly
|
28
|
+
# @!attribute [rw] zone_id
|
29
|
+
# @return [::String]
|
30
|
+
# The cloud bigtable zone associated with the cluster.
|
31
|
+
# @!attribute [rw] cluster_id
|
32
|
+
# @return [::String]
|
33
|
+
# Identifier for a cluster that represents set of
|
34
|
+
# bigtable resources.
|
35
|
+
class ResponseParams
|
36
|
+
include ::Google::Protobuf::MessageExts
|
37
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
38
|
+
end
|
39
|
+
end
|
40
|
+
end
|
41
|
+
end
|
42
|
+
end
|
@@ -0,0 +1,98 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2022 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 Protobuf
|
22
|
+
# A Duration represents a signed, fixed-length span of time represented
|
23
|
+
# as a count of seconds and fractions of seconds at nanosecond
|
24
|
+
# resolution. It is independent of any calendar and concepts like "day"
|
25
|
+
# or "month". It is related to Timestamp in that the difference between
|
26
|
+
# two Timestamp values is a Duration and it can be added or subtracted
|
27
|
+
# from a Timestamp. Range is approximately +-10,000 years.
|
28
|
+
#
|
29
|
+
# # Examples
|
30
|
+
#
|
31
|
+
# Example 1: Compute Duration from two Timestamps in pseudo code.
|
32
|
+
#
|
33
|
+
# Timestamp start = ...;
|
34
|
+
# Timestamp end = ...;
|
35
|
+
# Duration duration = ...;
|
36
|
+
#
|
37
|
+
# duration.seconds = end.seconds - start.seconds;
|
38
|
+
# duration.nanos = end.nanos - start.nanos;
|
39
|
+
#
|
40
|
+
# if (duration.seconds < 0 && duration.nanos > 0) {
|
41
|
+
# duration.seconds += 1;
|
42
|
+
# duration.nanos -= 1000000000;
|
43
|
+
# } else if (duration.seconds > 0 && duration.nanos < 0) {
|
44
|
+
# duration.seconds -= 1;
|
45
|
+
# duration.nanos += 1000000000;
|
46
|
+
# }
|
47
|
+
#
|
48
|
+
# Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
|
49
|
+
#
|
50
|
+
# Timestamp start = ...;
|
51
|
+
# Duration duration = ...;
|
52
|
+
# Timestamp end = ...;
|
53
|
+
#
|
54
|
+
# end.seconds = start.seconds + duration.seconds;
|
55
|
+
# end.nanos = start.nanos + duration.nanos;
|
56
|
+
#
|
57
|
+
# if (end.nanos < 0) {
|
58
|
+
# end.seconds -= 1;
|
59
|
+
# end.nanos += 1000000000;
|
60
|
+
# } else if (end.nanos >= 1000000000) {
|
61
|
+
# end.seconds += 1;
|
62
|
+
# end.nanos -= 1000000000;
|
63
|
+
# }
|
64
|
+
#
|
65
|
+
# Example 3: Compute Duration from datetime.timedelta in Python.
|
66
|
+
#
|
67
|
+
# td = datetime.timedelta(days=3, minutes=10)
|
68
|
+
# duration = Duration()
|
69
|
+
# duration.FromTimedelta(td)
|
70
|
+
#
|
71
|
+
# # JSON Mapping
|
72
|
+
#
|
73
|
+
# In JSON format, the Duration type is encoded as a string rather than an
|
74
|
+
# object, where the string ends in the suffix "s" (indicating seconds) and
|
75
|
+
# is preceded by the number of seconds, with nanoseconds expressed as
|
76
|
+
# fractional seconds. For example, 3 seconds with 0 nanoseconds should be
|
77
|
+
# encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
|
78
|
+
# be expressed in JSON format as "3.000000001s", and 3 seconds and 1
|
79
|
+
# microsecond should be expressed in JSON format as "3.000001s".
|
80
|
+
# @!attribute [rw] seconds
|
81
|
+
# @return [::Integer]
|
82
|
+
# Signed seconds of the span of time. Must be from -315,576,000,000
|
83
|
+
# to +315,576,000,000 inclusive. Note: these bounds are computed from:
|
84
|
+
# 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
|
85
|
+
# @!attribute [rw] nanos
|
86
|
+
# @return [::Integer]
|
87
|
+
# Signed fractions of a second at nanosecond resolution of the span
|
88
|
+
# of time. Durations less than one second are represented with a 0
|
89
|
+
# `seconds` field and a positive or negative `nanos` field. For durations
|
90
|
+
# of one second or more, a non-zero value for the `nanos` field must be
|
91
|
+
# of the same sign as the `seconds` field. Must be from -999,999,999
|
92
|
+
# to +999,999,999 inclusive.
|
93
|
+
class Duration
|
94
|
+
include ::Google::Protobuf::MessageExts
|
95
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
96
|
+
end
|
97
|
+
end
|
98
|
+
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-bigtable-v2
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.7.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: 2022-
|
11
|
+
date: 2022-09-28 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -16,7 +16,7 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - ">="
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '0.
|
19
|
+
version: '0.12'
|
20
20
|
- - "<"
|
21
21
|
- !ruby/object:Gem::Version
|
22
22
|
version: 2.a
|
@@ -26,7 +26,7 @@ dependencies:
|
|
26
26
|
requirements:
|
27
27
|
- - ">="
|
28
28
|
- !ruby/object:Gem::Version
|
29
|
-
version: '0.
|
29
|
+
version: '0.12'
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 2.a
|
@@ -173,6 +173,8 @@ files:
|
|
173
173
|
- lib/google/bigtable/v2/bigtable_pb.rb
|
174
174
|
- lib/google/bigtable/v2/bigtable_services_pb.rb
|
175
175
|
- lib/google/bigtable/v2/data_pb.rb
|
176
|
+
- lib/google/bigtable/v2/request_stats_pb.rb
|
177
|
+
- lib/google/bigtable/v2/response_params_pb.rb
|
176
178
|
- lib/google/cloud/bigtable/v2.rb
|
177
179
|
- lib/google/cloud/bigtable/v2/bigtable.rb
|
178
180
|
- lib/google/cloud/bigtable/v2/bigtable/client.rb
|
@@ -186,7 +188,10 @@ files:
|
|
186
188
|
- proto_docs/google/api/routing.rb
|
187
189
|
- proto_docs/google/bigtable/v2/bigtable.rb
|
188
190
|
- proto_docs/google/bigtable/v2/data.rb
|
191
|
+
- proto_docs/google/bigtable/v2/request_stats.rb
|
192
|
+
- proto_docs/google/bigtable/v2/response_params.rb
|
189
193
|
- proto_docs/google/protobuf/any.rb
|
194
|
+
- proto_docs/google/protobuf/duration.rb
|
190
195
|
- proto_docs/google/protobuf/wrappers.rb
|
191
196
|
- proto_docs/google/rpc/status.rb
|
192
197
|
homepage: https://github.com/googleapis/google-cloud-ruby
|