google-cloud-bigtable-v2 0.6.0 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e3d0a762196c965a95b62e358f682a2c49486cee28f3d857e449d229c530a4c9
4
- data.tar.gz: 124d897a14d9176041a7d8932fc91c18236f883ed330f3c9513a80f4f178d196
3
+ metadata.gz: 9d95d9ba14cb16bd07793227a4cee13bda16cb26b3e901c89c2c05faa9a3face
4
+ data.tar.gz: 21d78d9dc582f3beb6555eade471e89e3eb55a7402c185cfd962f7cfb24e7845
5
5
  SHA512:
6
- metadata.gz: 73c368aa55886ecbb17eee966d89a7bff00928050231a2d78f6e9fdd306883f49919084eeedbf8c359f553516b40b7b7e3faa9c6f623f45ea6f1ee7e81a48c3d
7
- data.tar.gz: 14c33cbb66b68371afdb2099398234408782d5ac8c3916e4767776db3ebf5a268edb4d5279ee77610dad1072f320848c6b9aacabe33ff898c48945fa3cac0bb8
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. If not specified, the
190
- # "default" application profile will be used.
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 applied.
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 are applied
402
- # in order, meaning that earlier mutations can be masked by later ones.
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 applied.
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 should be
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 applied.
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 as
711
- # respond. Values are of the form `projects/<project>/instances/<instance>`.
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 should be
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 applied.
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 transformed
818
- # into writes. Entries are applied in order, meaning that earlier rules will
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]
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Bigtable
23
23
  module V2
24
- VERSION = "0.6.0"
24
+ VERSION = "0.7.0"
25
25
  end
26
26
  end
27
27
  end
@@ -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. If not specified, the
33
- # "default" application profile will be used.
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 applied.
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 are applied
185
- # in order, meaning that earlier mutations can be masked by later ones.
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 applied.
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. Mutations are
224
- # applied in order, meaning that earlier mutations can be masked by
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 should be
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 applied.
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 as
311
- # respond. Values are of the form `projects/<project>/instances/<instance>`.
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 should be
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 applied.
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 transformed
344
- # into writes. Entries are applied in order, meaning that earlier rules will
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.6.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-07-01 00:00:00.000000000 Z
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.10'
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.10'
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