google-cloud-bigtable-v2 0.5.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: f9fa234bc4b468a542653487a866f84e3783cbc4f779b295aca972fcc1e78506
4
- data.tar.gz: db085ca8f0130e79c75021b9474d12dcedf0e1f9e72bb199ce54f3828f1fd334
3
+ metadata.gz: 9d95d9ba14cb16bd07793227a4cee13bda16cb26b3e901c89c2c05faa9a3face
4
+ data.tar.gz: 21d78d9dc582f3beb6555eade471e89e3eb55a7402c185cfd962f7cfb24e7845
5
5
  SHA512:
6
- metadata.gz: 3d5443bce3015996a3dc2a2aafdbefe524b0870806cb3da9b35ce3fa1c3c28bf42c35448f980fca94f0914e2c1f502af9c16babcf60a708714d8ec9223298b5a
7
- data.tar.gz: f346ca810c1d682b34ca9ea4540a3973e3c45f0a836a6e81ab5e7d0ad828ad77f19d6c03acec78d364b02f9023d1145dd2479cf76cbeddf05f50f26dafe0255a
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
data/README.md CHANGED
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -1,15 +1,17 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/v2/bigtable.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/annotations_pb'
5
7
  require 'google/api/client_pb'
6
8
  require 'google/api/field_behavior_pb'
7
9
  require 'google/api/resource_pb'
8
10
  require 'google/api/routing_pb'
9
11
  require 'google/bigtable/v2/data_pb'
12
+ require 'google/bigtable/v2/request_stats_pb'
10
13
  require 'google/protobuf/wrappers_pb'
11
14
  require 'google/rpc/status_pb'
12
- require 'google/protobuf'
13
15
 
14
16
  Google::Protobuf::DescriptorPool.generated_pool.build do
15
17
  add_file("google/bigtable/v2/bigtable.proto", :syntax => :proto3) do
@@ -19,10 +21,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
19
21
  optional :rows, :message, 2, "google.bigtable.v2.RowSet"
20
22
  optional :filter, :message, 3, "google.bigtable.v2.RowFilter"
21
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
22
31
  end
23
32
  add_message "google.bigtable.v2.ReadRowsResponse" do
24
33
  repeated :chunks, :message, 1, "google.bigtable.v2.ReadRowsResponse.CellChunk"
25
34
  optional :last_scanned_row_key, :bytes, 2
35
+ optional :request_stats, :message, 3, "google.bigtable.v2.RequestStats"
26
36
  end
27
37
  add_message "google.bigtable.v2.ReadRowsResponse.CellChunk" do
28
38
  optional :row_key, :bytes, 1
@@ -103,6 +113,7 @@ module Google
103
113
  module Bigtable
104
114
  module V2
105
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
106
117
  ReadRowsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse").msgclass
107
118
  ReadRowsResponse::CellChunk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse.CellChunk").msgclass
108
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.5.0"
24
+ VERSION = "0.7.0"
25
25
  end
26
26
  end
27
27
  end
@@ -25,6 +25,8 @@ module Google
25
25
  ##
26
26
  # To load this package, including all its services, and instantiate a client:
27
27
  #
28
+ # @example
29
+ #
28
30
  # require "google/cloud/bigtable/v2"
29
31
  # client = ::Google::Cloud::Bigtable::V2::Bigtable::Client.new
30
32
  #
@@ -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
@@ -44,7 +44,7 @@ module Google
44
44
  # foo = any.unpack(Foo.class);
45
45
  # }
46
46
  #
47
- # Example 3: Pack and unpack a message in Python.
47
+ # Example 3: Pack and unpack a message in Python.
48
48
  #
49
49
  # foo = Foo(...)
50
50
  # any = Any()
@@ -54,7 +54,7 @@ module Google
54
54
  # any.Unpack(foo)
55
55
  # ...
56
56
  #
57
- # Example 4: Pack and unpack a message in Go
57
+ # Example 4: Pack and unpack a message in Go
58
58
  #
59
59
  # foo := &pb.Foo{...}
60
60
  # any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
75
75
  #
76
76
  #
77
77
  # JSON
78
- # ====
78
+ #
79
79
  # The JSON representation of an `Any` value uses the regular
80
80
  # representation of the deserialized, embedded message, with an
81
81
  # additional field `@type` which contains the type URL. Example:
@@ -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.5.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-02-16 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.7'
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.7'
29
+ version: '0.12'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -50,28 +50,28 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.25.1
53
+ version: 1.26.1
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.25.1
60
+ version: 1.26.1
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '5.14'
67
+ version: '5.16'
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '5.14'
74
+ version: '5.16'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest-focus
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
106
106
  requirements:
107
107
  - - ">="
108
108
  - !ruby/object:Gem::Version
109
- version: '12.0'
109
+ version: '13.0'
110
110
  type: :development
111
111
  prerelease: false
112
112
  version_requirements: !ruby/object:Gem::Requirement
113
113
  requirements:
114
114
  - - ">="
115
115
  - !ruby/object:Gem::Version
116
- version: '12.0'
116
+ version: '13.0'
117
117
  - !ruby/object:Gem::Dependency
118
118
  name: redcarpet
119
119
  requirement: !ruby/object:Gem::Requirement
@@ -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
@@ -201,14 +206,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
201
206
  requirements:
202
207
  - - ">="
203
208
  - !ruby/object:Gem::Version
204
- version: '2.5'
209
+ version: '2.6'
205
210
  required_rubygems_version: !ruby/object:Gem::Requirement
206
211
  requirements:
207
212
  - - ">="
208
213
  - !ruby/object:Gem::Version
209
214
  version: '0'
210
215
  requirements: []
211
- rubygems_version: 3.3.5
216
+ rubygems_version: 3.3.14
212
217
  signing_key:
213
218
  specification_version: 4
214
219
  summary: API Client library for the Cloud Bigtable V2 API