google-cloud-bigtable-v2 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cfc6e05ad85852561ba6aa5d53d5fe73c273f2e0dde7703f6c63802af275ff9
-  data.tar.gz: a5b32e4d889b81242c3622f883fb117e81d26a911064c6ebd64b6f03f0287c3c
+  metadata.gz: 56f0ee2f4dfa798c23723bf390e3510c931fa7ad3b9a5096123a380b52ab03cd
+  data.tar.gz: 41aa3fbf9e0d41be02e74c9f6eb471255b5d6bb0c0e8c0ec7139ac9025bc293d
 SHA512:
-  metadata.gz: 73c03468e20fd6ea4e9306cf304018635bc55d1caf8e3e878be7298155a5d01bbefd7a0535012a89ee19cc1b896cb94bfd7c26892276d1bbb7d9b9fc01891432
-  data.tar.gz: 3c1710b480304d76b52a0e7552851f59ab0edc03dfa23c069bae7bf3a698292dc91dee244c69c26b52af25cd10933a99c3d958fb477b5a537fa2ed1001561ea0
+  metadata.gz: a530bada3cf51cbfa3d0bfc20bf46f33b7f982eddc52be3212b7c4fa6401c608954e28f377a9beedf089cf81801d293d9797b3faee861de2e6ca4e653bc73005
+  data.tar.gz: 835c96c7518d3039e2ba9d64d09c70968f15933bd609e509b0077b95dbbc87beca2b74c3bbfee1367b14fe6d78f7c9c0dffb084c90bb1658b5c365e1f2b5700c

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud Bigtable V2 API
 
-API Client library for the Cloud Bigtable V2 API
+API for reading and writing the contents of Bigtables associated with a cloud project.
 
 Cloud Bigtable is a fully managed, scalable NoSQL database service for large analytical and operational workloads.
 
@@ -47,7 +47,7 @@ for general usage information.
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

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

@@ -75,11 +75,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.bigtable.v2.MutateRowsResponse" do
       repeated :entries, :message, 1, "google.bigtable.v2.MutateRowsResponse.Entry"
+      proto3_optional :rate_limit_info, :message, 3, "google.bigtable.v2.RateLimitInfo"
     end
     add_message "google.bigtable.v2.MutateRowsResponse.Entry" do
       optional :index, :int64, 1
       optional :status, :message, 2, "google.rpc.Status"
     end
+    add_message "google.bigtable.v2.RateLimitInfo" do
+      optional :period, :message, 1, "google.protobuf.Duration"
+      optional :factor, :double, 2
+    end
     add_message "google.bigtable.v2.CheckAndMutateRowRequest" do
       optional :table_name, :string, 1
       optional :app_profile_id, :string, 7
@@ -164,6 +169,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.bigtable.v2.ReadChangeStreamResponse.CloseStream" do
       optional :status, :message, 1, "google.rpc.Status"
       repeated :continuation_tokens, :message, 2, "google.bigtable.v2.StreamContinuationToken"
+      repeated :new_partitions, :message, 3, "google.bigtable.v2.StreamPartition"
     end
   end
 end
@@ -184,6 +190,7 @@ module Google
         MutateRowsRequest::Entry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.MutateRowsRequest.Entry").msgclass
         MutateRowsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.MutateRowsResponse").msgclass
         MutateRowsResponse::Entry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.MutateRowsResponse.Entry").msgclass
+        RateLimitInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.RateLimitInfo").msgclass
         CheckAndMutateRowRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.CheckAndMutateRowRequest").msgclass
         CheckAndMutateRowResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.CheckAndMutateRowResponse").msgclass
         PingAndWarmRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.PingAndWarmRequest").msgclass

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

@@ -0,0 +1,22 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/bigtable/v2/feature_flags.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/bigtable/v2/feature_flags.proto", :syntax => :proto3) do
+    add_message "google.bigtable.v2.FeatureFlags" do
+      optional :mutate_rows_rate_limit, :bool, 3
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Bigtable
+      module V2
+        FeatureFlags = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.v2.FeatureFlags").msgclass
+      end
+    end
+  end
+end

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

@@ -190,8 +190,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. This API only accepts the
-            #     empty value of app_profile_id.
+            #     This value specifies routing for replication. If not specified, the
+            #     "default" application profile will be used.
             #   @param rows [::Google::Cloud::Bigtable::V2::RowSet, ::Hash]
             #     The row keys and/or ranges to read sequentially. If not specified, reads
             #     from all rows.
@@ -1153,9 +1153,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Bigtable
       module V2
-        VERSION = "0.8.0"
+        VERSION = "0.10.0"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

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. This API only accepts the
-        #     empty value of app_profile_id.
+        #     This value specifies routing for replication. If not specified, the
+        #     "default" application profile will be used.
         # @!attribute [rw] rows
         #   @return [::Google::Cloud::Bigtable::V2::RowSet]
         #     The row keys and/or ranges to read sequentially. If not specified, reads
@@ -274,6 +274,11 @@ module Google
         # @!attribute [rw] entries
         #   @return [::Array<::Google::Cloud::Bigtable::V2::MutateRowsResponse::Entry>]
         #     One or more results for Entries from the batch request.
+        # @!attribute [rw] rate_limit_info
+        #   @return [::Google::Cloud::Bigtable::V2::RateLimitInfo]
+        #     Information about how client should limit the rate (QPS). Primirily used by
+        #     supported official Cloud Bigtable clients. If unset, the rate limit info is
+        #     not provided by the server.
         class MutateRowsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -295,6 +300,31 @@ module Google
           end
         end
 
+        # Information about how client should adjust the load to Bigtable.
+        # @!attribute [rw] period
+        #   @return [::Google::Protobuf::Duration]
+        #     Time that clients should wait before adjusting the target rate again.
+        #     If clients adjust rate too frequently, the impact of the previous
+        #     adjustment may not have been taken into account and may
+        #     over-throttle or under-throttle. If clients adjust rate too slowly, they
+        #     will not be responsive to load changes on server side, and may
+        #     over-throttle or under-throttle.
+        # @!attribute [rw] factor
+        #   @return [::Float]
+        #     If it has been at least one `period` since the last load adjustment, the
+        #     client should multiply the current load by this value to get the new target
+        #     load. For example, if the current load is 100 and `factor` is 0.8, the new
+        #     target load should be 80. After adjusting, the client should ignore
+        #     `factor` until another `period` has passed.
+        #
+        #     The client can measure its load using any unit that's comparable over time
+        #     For example, QPS can be used as long as each request involves a similar
+        #     amount of work.
+        class RateLimitInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for Bigtable.CheckAndMutateRow.
         # @!attribute [rw] table_name
         #   @return [::String]
@@ -614,17 +644,37 @@ module Google
           end
 
           # A message indicating that the client should stop reading from the stream.
-          # If status is OK and `continuation_tokens` is empty, the stream has finished
-          # (for example if there was an `end_time` specified).
-          # If `continuation_tokens` is present, then a change in partitioning requires
-          # the client to open a new stream for each token to resume reading.
+          # If status is OK and `continuation_tokens` & `new_partitions` are empty, the
+          # stream has finished (for example if there was an `end_time` specified).
+          # If `continuation_tokens` & `new_partitions` are present, then a change in
+          # partitioning requires the client to open a new stream for each token to
+          # resume reading. Example:
+          #                                  [B,      D) ends
+          #                                       |
+          #                                       v
+          #               new_partitions:  [A,  C) [C,  E)
+          # continuation_tokens.partitions:  [B,C) [C,D)
+          #                                  ^---^ ^---^
+          #                                  ^     ^
+          #                                  |     |
+          #                                  |     StreamContinuationToken 2
+          #                                  |
+          #                                  StreamContinuationToken 1
+          # To read the new partition [A,C), supply the continuation tokens whose
+          # ranges cover the new partition, for example ContinuationToken[A,B) &
+          # ContinuationToken[B,C).
           # @!attribute [rw] status
           #   @return [::Google::Rpc::Status]
           #     The status of the stream.
           # @!attribute [rw] continuation_tokens
           #   @return [::Array<::Google::Cloud::Bigtable::V2::StreamContinuationToken>]
-          #     If non-empty, contains the information needed to start reading the new
-          #     partition(s) that contain segments of this partition's row range.
+          #     If non-empty, contains the information needed to resume reading their
+          #     associated partitions.
+          # @!attribute [rw] new_partitions
+          #   @return [::Array<::Google::Cloud::Bigtable::V2::StreamPartition>]
+          #     If non-empty, contains the new partitions to start reading from, which
+          #     are related to but not necessarily identical to the partitions for the
+          #     above `continuation_tokens`.
           class CloseStream
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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
+        # Feature flags supported by a client.
+        # This is intended to be sent as part of request metadata to assure the server
+        # that certain behaviors are safe to enable. This proto is meant to be
+        # serialized and websafe-base64 encoded under the `bigtable-features` metadata
+        # key. The value will remain constant for the lifetime of a client and due to
+        # HTTP2's HPACK compression, the request overhead will be tiny.
+        # This is an internal implementation detail and should not be used by endusers
+        # directly.
+        # @!attribute [rw] mutate_rows_rate_limit
+        #   @return [::Boolean]
+        #     Notify the server that the client enables batch write flow control by
+        #     requesting RateLimitInfo from MutateRowsResponse.
+        class FeatureFlags
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable-v2
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-23 00:00:00.000000000 Z
+date: 2023-05-04 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.17.1
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.17.1
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -173,6 +173,7 @@ 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/feature_flags_pb.rb
 - lib/google/bigtable/v2/request_stats_pb.rb
 - lib/google/bigtable/v2/response_params_pb.rb
 - lib/google/cloud/bigtable/v2.rb
@@ -190,6 +191,7 @@ 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/feature_flags.rb
 - proto_docs/google/bigtable/v2/request_stats.rb
 - proto_docs/google/bigtable/v2/response_params.rb
 - proto_docs/google/protobuf/any.rb
@@ -219,5 +221,6 @@ requirements: []
 rubygems_version: 3.4.2
 signing_key: 
 specification_version: 4
-summary: API Client library for the Cloud Bigtable V2 API
+summary: API for reading and writing the contents of Bigtables associated with a cloud
+  project.
 test_files: []