google-cloud-bigtable-v2 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3d0a762196c965a95b62e358f682a2c49486cee28f3d857e449d229c530a4c9
-  data.tar.gz: 124d897a14d9176041a7d8932fc91c18236f883ed330f3c9513a80f4f178d196
+  metadata.gz: 9d95d9ba14cb16bd07793227a4cee13bda16cb26b3e901c89c2c05faa9a3face
+  data.tar.gz: 21d78d9dc582f3beb6555eade471e89e3eb55a7402c185cfd962f7cfb24e7845
 SHA512:
-  metadata.gz: 73c368aa55886ecbb17eee966d89a7bff00928050231a2d78f6e9fdd306883f49919084eeedbf8c359f553516b40b7b7e3faa9c6f623f45ea6f1ee7e81a48c3d
-  data.tar.gz: 14c33cbb66b68371afdb2099398234408782d5ac8c3916e4767776db3ebf5a268edb4d5279ee77610dad1072f320848c6b9aacabe33ff898c48945fa3cac0bb8
+  metadata.gz: 8f7f1346f52674c2229a73b90f44c920351885d117a0ed368856eaf20bf5c33f4c61a001a8622e9f53a04ed0e4ae92f556a9213fa68c373bbe4f4076b6edd43c
+  data.tar.gz: 3c6551336d90500086d5d8d03377a3c7ed9b8f14de8fd230a4ccc52eed036863f7739eaadbeaff246ce93ba5761e909385d81a673eb8c38b4fdad4cfdbd83fec

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/lib/google/bigtable/v2/bigtable_pb.rb

@@ -9,6 +9,7 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/api/routing_pb'
 require 'google/bigtable/v2/data_pb'
+require 'google/bigtable/v2/request_stats_pb'
 require 'google/protobuf/wrappers_pb'
 require 'google/rpc/status_pb'
 
@@ -20,10 +21,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :rows, :message, 2, "google.bigtable.v2.RowSet"
       optional :filter, :message, 3, "google.bigtable.v2.RowFilter"
       optional :rows_limit, :int64, 4
+      optional :request_stats_view, :enum, 6, "google.bigtable.v2.ReadRowsRequest.RequestStatsView"
+    end
+    add_enum "google.bigtable.v2.ReadRowsRequest.RequestStatsView" do
+      value :REQUEST_STATS_VIEW_UNSPECIFIED, 0
+      value :REQUEST_STATS_NONE, 1
+      value :REQUEST_STATS_EFFICIENCY, 2
+      value :REQUEST_STATS_FULL, 3
     end
     add_message "google.bigtable.v2.ReadRowsResponse" do
       repeated :chunks, :message, 1, "google.bigtable.v2.ReadRowsResponse.CellChunk"
       optional :last_scanned_row_key, :bytes, 2
+      optional :request_stats, :message, 3, "google.bigtable.v2.RequestStats"
     end
     add_message "google.bigtable.v2.ReadRowsResponse.CellChunk" do
       optional :row_key, :bytes, 1
@@ -104,6 +113,7 @@ module Google
     module Bigtable
       module V2
         ReadRowsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsRequest").msgclass
+        ReadRowsRequest::RequestStatsView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsRequest.RequestStatsView").enummodule
         ReadRowsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse").msgclass
         ReadRowsResponse::CellChunk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadRowsResponse.CellChunk").msgclass
         SampleRowKeysRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.SampleRowKeysRequest").msgclass

data/lib/google/bigtable/v2/request_stats_pb.rb

@@ -0,0 +1,49 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/bigtable/v2/request_stats.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/duration_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/bigtable/v2/request_stats.proto", :syntax => :proto3) do
+    add_message "google.bigtable.v2.ReadIteratorStats" do
+      optional :rows_seen_count, :int64, 1
+      optional :rows_returned_count, :int64, 2
+      optional :cells_seen_count, :int64, 3
+      optional :cells_returned_count, :int64, 4
+      optional :deletes_seen_count, :int64, 5
+    end
+    add_message "google.bigtable.v2.RequestLatencyStats" do
+      optional :frontend_server_latency, :message, 1, "google.protobuf.Duration"
+    end
+    add_message "google.bigtable.v2.ReadEfficiencyStats" do
+      optional :read_iterator_stats, :message, 1, "google.bigtable.v2.ReadIteratorStats"
+      optional :request_latency_stats, :message, 2, "google.bigtable.v2.RequestLatencyStats"
+    end
+    add_message "google.bigtable.v2.AllReadStats" do
+      optional :read_iterator_stats, :message, 1, "google.bigtable.v2.ReadIteratorStats"
+      optional :request_latency_stats, :message, 2, "google.bigtable.v2.RequestLatencyStats"
+    end
+    add_message "google.bigtable.v2.RequestStats" do
+      oneof :stats do
+        optional :read_efficiency_stats, :message, 1, "google.bigtable.v2.ReadEfficiencyStats"
+        optional :all_read_stats, :message, 2, "google.bigtable.v2.AllReadStats"
+      end
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Bigtable
+      module V2
+        ReadIteratorStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadIteratorStats").msgclass
+        RequestLatencyStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.RequestLatencyStats").msgclass
+        ReadEfficiencyStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ReadEfficiencyStats").msgclass
+        AllReadStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.AllReadStats").msgclass
+        RequestStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.RequestStats").msgclass
+      end
+    end
+  end
+end

data/lib/google/bigtable/v2/response_params_pb.rb

@@ -0,0 +1,23 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/bigtable/v2/response_params.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/bigtable/v2/response_params.proto", :syntax => :proto3) do
+    add_message "google.bigtable.v2.ResponseParams" do
+      proto3_optional :zone_id, :string, 1
+      proto3_optional :cluster_id, :string, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Bigtable
+      module V2
+        ResponseParams = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.ResponseParams").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/bigtable/v2/bigtable/client.rb

@@ -176,7 +176,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload read_rows(table_name: nil, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil)
+            # @overload read_rows(table_name: nil, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil, request_stats_view: nil)
             #   Pass arguments to `read_rows` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -186,8 +186,8 @@ module Google
             #     Values are of the form
             #     `projects/<project>/instances/<instance>/tables/<table>`.
             #   @param app_profile_id [::String]
-            #     This value specifies routing for replication. If not specified, the
-            #     "default" application profile will be used.
+            #     This value specifies routing for replication. This API only accepts the
+            #     empty value of app_profile_id.
             #   @param rows [::Google::Cloud::Bigtable::V2::RowSet, ::Hash]
             #     The row keys and/or ranges to read sequentially. If not specified, reads
             #     from all rows.
@@ -197,6 +197,8 @@ module Google
             #   @param rows_limit [::Integer]
             #     The read will stop after committing to N rows' worth of results. The
             #     default (zero) is to return all results.
+            #   @param request_stats_view [::Google::Cloud::Bigtable::V2::ReadRowsRequest::RequestStatsView]
+            #     The view into RequestStats, as described above.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Enumerable<::Google::Cloud::Bigtable::V2::ReadRowsResponse>]
@@ -389,8 +391,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param table_name [::String]
-            #     Required. The unique name of the table to which the mutation should be applied.
-            #     Values are of the form
+            #     Required. The unique name of the table to which the mutation should be
+            #     applied. Values are of the form
             #     `projects/<project>/instances/<instance>/tables/<table>`.
             #   @param app_profile_id [::String]
             #     This value specifies routing for replication. If not specified, the
@@ -398,9 +400,9 @@ module Google
             #   @param row_key [::String]
             #     Required. The key of the row to which the mutation should be applied.
             #   @param mutations [::Array<::Google::Cloud::Bigtable::V2::Mutation, ::Hash>]
-            #     Required. Changes to be atomically applied to the specified row. Entries are applied
-            #     in order, meaning that earlier mutations can be masked by later ones.
-            #     Must contain at least one entry and at most 100000.
+            #     Required. Changes to be atomically applied to the specified row. Entries
+            #     are applied in order, meaning that earlier mutations can be masked by later
+            #     ones. Must contain at least one entry and at most 100000.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Bigtable::V2::MutateRowResponse]
@@ -491,7 +493,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param table_name [::String]
-            #     Required. The unique name of the table to which the mutations should be applied.
+            #     Required. The unique name of the table to which the mutations should be
+            #     applied.
             #   @param app_profile_id [::String]
             #     This value specifies routing for replication. If not specified, the
             #     "default" application profile will be used.
@@ -592,15 +595,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param table_name [::String]
-            #     Required. The unique name of the table to which the conditional mutation should be
-            #     applied.
-            #     Values are of the form
+            #     Required. The unique name of the table to which the conditional mutation
+            #     should be applied. Values are of the form
             #     `projects/<project>/instances/<instance>/tables/<table>`.
             #   @param app_profile_id [::String]
             #     This value specifies routing for replication. If not specified, the
             #     "default" application profile will be used.
             #   @param row_key [::String]
-            #     Required. The key of the row to which the conditional mutation should be applied.
+            #     Required. The key of the row to which the conditional mutation should be
+            #     applied.
             #   @param predicate_filter [::Google::Cloud::Bigtable::V2::RowFilter, ::Hash]
             #     The filter to be applied to the contents of the specified row. Depending
             #     on whether or not any results are yielded, either `true_mutations` or
@@ -707,8 +710,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The unique name of the instance to check permissions for as well as
-            #     respond. Values are of the form `projects/<project>/instances/<instance>`.
+            #     Required. The unique name of the instance to check permissions for as well
+            #     as respond. Values are of the form
+            #     `projects/<project>/instances/<instance>`.
             #   @param app_profile_id [::String]
             #     This value specifies routing for replication. If not specified, the
             #     "default" application profile will be used.
@@ -804,19 +808,19 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param table_name [::String]
-            #     Required. The unique name of the table to which the read/modify/write rules should be
-            #     applied.
-            #     Values are of the form
+            #     Required. The unique name of the table to which the read/modify/write rules
+            #     should be applied. Values are of the form
             #     `projects/<project>/instances/<instance>/tables/<table>`.
             #   @param app_profile_id [::String]
             #     This value specifies routing for replication. If not specified, the
             #     "default" application profile will be used.
             #   @param row_key [::String]
-            #     Required. The key of the row to which the read/modify/write rules should be applied.
+            #     Required. The key of the row to which the read/modify/write rules should be
+            #     applied.
             #   @param rules [::Array<::Google::Cloud::Bigtable::V2::ReadModifyWriteRule, ::Hash>]
-            #     Required. Rules specifying how the specified row's contents are to be transformed
-            #     into writes. Entries are applied in order, meaning that earlier rules will
-            #     affect the results of later ones.
+            #     Required. Rules specifying how the specified row's contents are to be
+            #     transformed into writes. Entries are applied in order, meaning that earlier
+            #     rules will affect the results of later ones.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Bigtable::V2::ReadModifyWriteRowResponse]

data/lib/google/cloud/bigtable/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Bigtable
       module V2
-        VERSION = "0.6.0"
+        VERSION = "0.7.0"
       end
     end
   end

data/proto_docs/google/bigtable/v2/bigtable.rb

@@ -29,8 +29,8 @@ module Google
         #     `projects/<project>/instances/<instance>/tables/<table>`.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
-        #     This value specifies routing for replication. If not specified, the
-        #     "default" application profile will be used.
+        #     This value specifies routing for replication. This API only accepts the
+        #     empty value of app_profile_id.
         # @!attribute [rw] rows
         #   @return [::Google::Cloud::Bigtable::V2::RowSet]
         #     The row keys and/or ranges to read sequentially. If not specified, reads
@@ -43,9 +43,31 @@ module Google
         #   @return [::Integer]
         #     The read will stop after committing to N rows' worth of results. The
         #     default (zero) is to return all results.
+        # @!attribute [rw] request_stats_view
+        #   @return [::Google::Cloud::Bigtable::V2::ReadRowsRequest::RequestStatsView]
+        #     The view into RequestStats, as described above.
         class ReadRowsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The desired view into RequestStats that should be returned in the response.
+          #
+          # See also: RequestStats message.
+          module RequestStatsView
+            # The default / unset value. The API will default to the NONE option below.
+            REQUEST_STATS_VIEW_UNSPECIFIED = 0
+
+            # Do not include any RequestStats in the response. This will leave the
+            # RequestStats embedded message unset in the response.
+            REQUEST_STATS_NONE = 1
+
+            # Include stats related to the efficiency of the read.
+            REQUEST_STATS_EFFICIENCY = 2
+
+            # Include the full set of available RequestStats in the response,
+            # applicable to this read.
+            REQUEST_STATS_FULL = 3
+          end
         end
 
         # Response message for Bigtable.ReadRows.
@@ -61,6 +83,27 @@ module Google
         #     This is primarily useful for cases where the server has read a
         #     lot of data that was filtered out since the last committed row
         #     key, allowing the client to skip that work on a retry.
+        # @!attribute [rw] request_stats
+        #   @return [::Google::Cloud::Bigtable::V2::RequestStats]
+        #     If requested, provide enhanced query performance statistics. The semantics
+        #     dictate:
+        #       * request_stats is empty on every (streamed) response, except
+        #       * request_stats has non-empty information after all chunks have been
+        #         streamed, where the ReadRowsResponse message only contains
+        #         request_stats.
+        #           * For example, if a read request would have returned an empty
+        #             response instead a single ReadRowsResponse is streamed with empty
+        #             chunks and request_stats filled.
+        #
+        #     Visually, response messages will stream as follows:
+        #        ... -> \\{chunks: [...]} -> \\{chunks: [], request_stats: \\{...}}
+        #       \______________________/  \________________________________/
+        #           Primary response         Trailer of RequestStats info
+        #
+        #     Or if the read did not return any values:
+        #       \\{chunks: [], request_stats: \\{...}}
+        #       \________________________________/
+        #          Trailer of RequestStats info
         class ReadRowsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -169,8 +212,8 @@ module Google
         # Request message for Bigtable.MutateRow.
         # @!attribute [rw] table_name
         #   @return [::String]
-        #     Required. The unique name of the table to which the mutation should be applied.
-        #     Values are of the form
+        #     Required. The unique name of the table to which the mutation should be
+        #     applied. Values are of the form
         #     `projects/<project>/instances/<instance>/tables/<table>`.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
@@ -181,9 +224,9 @@ module Google
         #     Required. The key of the row to which the mutation should be applied.
         # @!attribute [rw] mutations
         #   @return [::Array<::Google::Cloud::Bigtable::V2::Mutation>]
-        #     Required. Changes to be atomically applied to the specified row. Entries are applied
-        #     in order, meaning that earlier mutations can be masked by later ones.
-        #     Must contain at least one entry and at most 100000.
+        #     Required. Changes to be atomically applied to the specified row. Entries
+        #     are applied in order, meaning that earlier mutations can be masked by later
+        #     ones. Must contain at least one entry and at most 100000.
         class MutateRowRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -198,7 +241,8 @@ module Google
         # Request message for BigtableService.MutateRows.
         # @!attribute [rw] table_name
         #   @return [::String]
-        #     Required. The unique name of the table to which the mutations should be applied.
+        #     Required. The unique name of the table to which the mutations should be
+        #     applied.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
         #     This value specifies routing for replication. If not specified, the
@@ -220,10 +264,9 @@ module Google
           #     The key of the row to which the `mutations` should be applied.
           # @!attribute [rw] mutations
           #   @return [::Array<::Google::Cloud::Bigtable::V2::Mutation>]
-          #     Required. Changes to be atomically applied to the specified row. Mutations are
-          #     applied in order, meaning that earlier mutations can be masked by
-          #     later ones.
-          #     You must specify at least one mutation.
+          #     Required. Changes to be atomically applied to the specified row.
+          #     Mutations are applied in order, meaning that earlier mutations can be
+          #     masked by later ones. You must specify at least one mutation.
           class Entry
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -258,9 +301,8 @@ module Google
         # Request message for Bigtable.CheckAndMutateRow.
         # @!attribute [rw] table_name
         #   @return [::String]
-        #     Required. The unique name of the table to which the conditional mutation should be
-        #     applied.
-        #     Values are of the form
+        #     Required. The unique name of the table to which the conditional mutation
+        #     should be applied. Values are of the form
         #     `projects/<project>/instances/<instance>/tables/<table>`.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
@@ -268,7 +310,8 @@ module Google
         #     "default" application profile will be used.
         # @!attribute [rw] row_key
         #   @return [::String]
-        #     Required. The key of the row to which the conditional mutation should be applied.
+        #     Required. The key of the row to which the conditional mutation should be
+        #     applied.
         # @!attribute [rw] predicate_filter
         #   @return [::Google::Cloud::Bigtable::V2::RowFilter]
         #     The filter to be applied to the contents of the specified row. Depending
@@ -307,8 +350,9 @@ module Google
         # Request message for client connection keep-alive and warming.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The unique name of the instance to check permissions for as well as
-        #     respond. Values are of the form `projects/<project>/instances/<instance>`.
+        #     Required. The unique name of the instance to check permissions for as well
+        #     as respond. Values are of the form
+        #     `projects/<project>/instances/<instance>`.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
         #     This value specifies routing for replication. If not specified, the
@@ -327,9 +371,8 @@ module Google
         # Request message for Bigtable.ReadModifyWriteRow.
         # @!attribute [rw] table_name
         #   @return [::String]
-        #     Required. The unique name of the table to which the read/modify/write rules should be
-        #     applied.
-        #     Values are of the form
+        #     Required. The unique name of the table to which the read/modify/write rules
+        #     should be applied. Values are of the form
         #     `projects/<project>/instances/<instance>/tables/<table>`.
         # @!attribute [rw] app_profile_id
         #   @return [::String]
@@ -337,12 +380,13 @@ module Google
         #     "default" application profile will be used.
         # @!attribute [rw] row_key
         #   @return [::String]
-        #     Required. The key of the row to which the read/modify/write rules should be applied.
+        #     Required. The key of the row to which the read/modify/write rules should be
+        #     applied.
         # @!attribute [rw] rules
         #   @return [::Array<::Google::Cloud::Bigtable::V2::ReadModifyWriteRule>]
-        #     Required. Rules specifying how the specified row's contents are to be transformed
-        #     into writes. Entries are applied in order, meaning that earlier rules will
-        #     affect the results of later ones.
+        #     Required. Rules specifying how the specified row's contents are to be
+        #     transformed into writes. Entries are applied in order, meaning that earlier
+        #     rules will affect the results of later ones.
         class ReadModifyWriteRowRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/bigtable/v2/request_stats.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigtable
+      module V2
+        # ReadIteratorStats captures information about the iteration of rows or cells
+        # over the course of a read, e.g. how many results were scanned in a read
+        # operation versus the results returned.
+        # @!attribute [rw] rows_seen_count
+        #   @return [::Integer]
+        #     The rows seen (scanned) as part of the request. This includes the count of
+        #     rows returned, as captured below.
+        # @!attribute [rw] rows_returned_count
+        #   @return [::Integer]
+        #     The rows returned as part of the request.
+        # @!attribute [rw] cells_seen_count
+        #   @return [::Integer]
+        #     The cells seen (scanned) as part of the request. This includes the count of
+        #     cells returned, as captured below.
+        # @!attribute [rw] cells_returned_count
+        #   @return [::Integer]
+        #     The cells returned as part of the request.
+        # @!attribute [rw] deletes_seen_count
+        #   @return [::Integer]
+        #     The deletes seen as part of the request.
+        class ReadIteratorStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # RequestLatencyStats provides a measurement of the latency of the request as
+        # it interacts with different systems over its lifetime, e.g. how long the
+        # request took to execute within a frontend server.
+        # @!attribute [rw] frontend_server_latency
+        #   @return [::Google::Protobuf::Duration]
+        #     The latency measured by the frontend server handling this request, from
+        #     when the request was received, to when this value is sent back in the
+        #     response. For more context on the component that is measuring this latency,
+        #     see: https://cloud.google.com/bigtable/docs/overview
+        #
+        #     Note: This value may be slightly shorter than the value reported into
+        #     aggregate latency metrics in Monitoring for this request
+        #     (https://cloud.google.com/bigtable/docs/monitoring-instance) as this value
+        #     needs to be sent in the response before the latency measurement including
+        #     that transmission is finalized.
+        class RequestLatencyStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # ReadEfficiencyStats captures information about the efficiency of a read.
+        # @!attribute [rw] read_iterator_stats
+        #   @return [::Google::Cloud::Bigtable::V2::ReadIteratorStats]
+        #     Iteration stats describe how efficient the read is, e.g. comparing
+        #     rows seen vs. rows returned or cells seen vs cells returned can provide an
+        #     indication of read efficiency (the higher the ratio of seen to retuned the
+        #     better).
+        # @!attribute [rw] request_latency_stats
+        #   @return [::Google::Cloud::Bigtable::V2::RequestLatencyStats]
+        #     Request latency stats describe the time taken to complete a request, from
+        #     the server side.
+        class ReadEfficiencyStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # AllReadStats captures all known information about a read.
+        # @!attribute [rw] read_iterator_stats
+        #   @return [::Google::Cloud::Bigtable::V2::ReadIteratorStats]
+        #     Iteration stats describe how efficient the read is, e.g. comparing
+        #     rows seen vs. rows returned or cells seen vs cells returned can provide an
+        #     indication of read efficiency (the higher the ratio of seen to retuned the
+        #     better).
+        # @!attribute [rw] request_latency_stats
+        #   @return [::Google::Cloud::Bigtable::V2::RequestLatencyStats]
+        #     Request latency stats describe the time taken to complete a request, from
+        #     the server side.
+        class AllReadStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # RequestStats is the container for additional information pertaining to a
+        # single request, helpful for evaluating the performance of the sent request.
+        # Currently, there are the following supported methods:
+        #   * google.bigtable.v2.ReadRows
+        # @!attribute [rw] read_efficiency_stats
+        #   @return [::Google::Cloud::Bigtable::V2::ReadEfficiencyStats]
+        #     Available with the
+        #     ReadRowsRequest.RequestStatsView.REQUEST_STATS_EFFICIENCY view, see
+        #     package google.bigtable.v2.
+        # @!attribute [rw] all_read_stats
+        #   @return [::Google::Cloud::Bigtable::V2::AllReadStats]
+        #     Available with the ReadRowsRequest.RequestStatsView.REQUEST_STATS_FULL
+        #     view, see package google.bigtable.v2.
+        class RequestStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/bigtable/v2/response_params.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigtable
+      module V2
+        # Response metadata proto
+        # This is an experimental feature that will be used to get zone_id and
+        # cluster_id from response trailers to tag the metrics. This should not be
+        # used by customers directly
+        # @!attribute [rw] zone_id
+        #   @return [::String]
+        #     The cloud bigtable zone associated with the cluster.
+        # @!attribute [rw] cluster_id
+        #   @return [::String]
+        #     Identifier for a cluster that represents set of
+        #     bigtable resources.
+        class ResponseParams
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/protobuf/duration.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Protobuf
+    # A Duration represents a signed, fixed-length span of time represented
+    # as a count of seconds and fractions of seconds at nanosecond
+    # resolution. It is independent of any calendar and concepts like "day"
+    # or "month". It is related to Timestamp in that the difference between
+    # two Timestamp values is a Duration and it can be added or subtracted
+    # from a Timestamp. Range is approximately +-10,000 years.
+    #
+    # # Examples
+    #
+    # Example 1: Compute Duration from two Timestamps in pseudo code.
+    #
+    #     Timestamp start = ...;
+    #     Timestamp end = ...;
+    #     Duration duration = ...;
+    #
+    #     duration.seconds = end.seconds - start.seconds;
+    #     duration.nanos = end.nanos - start.nanos;
+    #
+    #     if (duration.seconds < 0 && duration.nanos > 0) {
+    #       duration.seconds += 1;
+    #       duration.nanos -= 1000000000;
+    #     } else if (duration.seconds > 0 && duration.nanos < 0) {
+    #       duration.seconds -= 1;
+    #       duration.nanos += 1000000000;
+    #     }
+    #
+    # Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+    #
+    #     Timestamp start = ...;
+    #     Duration duration = ...;
+    #     Timestamp end = ...;
+    #
+    #     end.seconds = start.seconds + duration.seconds;
+    #     end.nanos = start.nanos + duration.nanos;
+    #
+    #     if (end.nanos < 0) {
+    #       end.seconds -= 1;
+    #       end.nanos += 1000000000;
+    #     } else if (end.nanos >= 1000000000) {
+    #       end.seconds += 1;
+    #       end.nanos -= 1000000000;
+    #     }
+    #
+    # Example 3: Compute Duration from datetime.timedelta in Python.
+    #
+    #     td = datetime.timedelta(days=3, minutes=10)
+    #     duration = Duration()
+    #     duration.FromTimedelta(td)
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Duration type is encoded as a string rather than an
+    # object, where the string ends in the suffix "s" (indicating seconds) and
+    # is preceded by the number of seconds, with nanoseconds expressed as
+    # fractional seconds. For example, 3 seconds with 0 nanoseconds should be
+    # encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
+    # be expressed in JSON format as "3.000000001s", and 3 seconds and 1
+    # microsecond should be expressed in JSON format as "3.000001s".
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Signed seconds of the span of time. Must be from -315,576,000,000
+    #     to +315,576,000,000 inclusive. Note: these bounds are computed from:
+    #     60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Signed fractions of a second at nanosecond resolution of the span
+    #     of time. Durations less than one second are represented with a 0
+    #     `seconds` field and a positive or negative `nanos` field. For durations
+    #     of one second or more, a non-zero value for the `nanos` field must be
+    #     of the same sign as the `seconds` field. Must be from -999,999,999
+    #     to +999,999,999 inclusive.
+    class Duration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable-v2
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-01 00:00:00.000000000 Z
+date: 2022-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -173,6 +173,8 @@ files:
 - lib/google/bigtable/v2/bigtable_pb.rb
 - lib/google/bigtable/v2/bigtable_services_pb.rb
 - lib/google/bigtable/v2/data_pb.rb
+- lib/google/bigtable/v2/request_stats_pb.rb
+- lib/google/bigtable/v2/response_params_pb.rb
 - lib/google/cloud/bigtable/v2.rb
 - lib/google/cloud/bigtable/v2/bigtable.rb
 - lib/google/cloud/bigtable/v2/bigtable/client.rb
@@ -186,7 +188,10 @@ files:
 - proto_docs/google/api/routing.rb
 - proto_docs/google/bigtable/v2/bigtable.rb
 - proto_docs/google/bigtable/v2/data.rb
+- proto_docs/google/bigtable/v2/request_stats.rb
+- proto_docs/google/bigtable/v2/response_params.rb
 - proto_docs/google/protobuf/any.rb
+- proto_docs/google/protobuf/duration.rb
 - proto_docs/google/protobuf/wrappers.rb
 - proto_docs/google/rpc/status.rb
 homepage: https://github.com/googleapis/google-cloud-ruby