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 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