google-cloud-bigtable 1.2.2 → 2.2.1

data/lib/google/cloud/bigtable/row_filter/condition_filter.rb

@@ -48,7 +48,7 @@ module Google
           # @param predicate [SimpleFilter, ChainFilter, InterleaveFilter, ConditionFilter]
           #
           def initialize predicate
-            @grpc = Google::Bigtable::V2::RowFilter::Condition.new
+            @grpc = Google::Cloud::Bigtable::V2::RowFilter::Condition.new
             @grpc.predicate_filter = predicate.to_grpc
           end
 
@@ -102,10 +102,10 @@ module Google
 
           # @private
           # Gets the row-filter gRPC instance.
-          # @return [Google::Bigtable::V2::RowFilter]
+          # @return [Google::Cloud::Bigtable::V2::RowFilter]
           #
           def to_grpc
-            Google::Bigtable::V2::RowFilter.new condition: @grpc
+            Google::Cloud::Bigtable::V2::RowFilter.new condition: @grpc
           end
         end
       end

data/lib/google/cloud/bigtable/row_filter/interleave_filter.rb

@@ -595,11 +595,11 @@ module Google
           #
           # Gets a gRPC object of RowFilter with interleave filter.
           #
-          # @return [Google::Bigtable::V2::RowFilter]
+          # @return [Google::Cloud::Bigtable::V2::RowFilter]
           #
           def to_grpc
-            Google::Bigtable::V2::RowFilter.new(
-              interleave: Google::Bigtable::V2::RowFilter::Interleave.new(filters: @filters.map(&:to_grpc))
+            Google::Cloud::Bigtable::V2::RowFilter.new(
+              interleave: Google::Cloud::Bigtable::V2::RowFilter::Interleave.new(filters: @filters.map(&:to_grpc))
             )
           end
 

data/lib/google/cloud/bigtable/row_filter/simple_filter.rb

@@ -28,7 +28,7 @@ module Google
           # Creates a simple filter instance.
           #
           def initialize
-            @grpc = Google::Bigtable::V2::RowFilter.new
+            @grpc = Google::Cloud::Bigtable::V2::RowFilter.new
           end
 
           ##
@@ -230,7 +230,7 @@ module Google
           # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
           #
           def timestamp_range from, to
-            range_grpc = Google::Bigtable::V2::TimestampRange.new
+            range_grpc = Google::Cloud::Bigtable::V2::TimestampRange.new
             range_grpc.start_timestamp_micros = from if from
             range_grpc.end_timestamp_micros = to if to
             @grpc.timestamp_range_filter = range_grpc
@@ -276,7 +276,7 @@ module Google
           #
           # Converts to a gRPC row filter instance.
           #
-          # @return [Google::Bigtable::V2::RowFilter]
+          # @return [Google::Cloud::Bigtable::V2::RowFilter]
           def to_grpc
             @grpc
           end

data/lib/google/cloud/bigtable/row_range.rb

@@ -57,7 +57,7 @@ module Google
         # @private
         # Creates a row range instance.
         def initialize
-          @grpc = Google::Bigtable::V2::RowRange.new
+          @grpc = Google::Cloud::Bigtable::V2::RowRange.new
         end
 
         ##
@@ -168,7 +168,7 @@ module Google
 
         # @private
         #
-        # @return [Google::Bigtable::V2::RowRange]
+        # @return [Google::Cloud::Bigtable::V2::RowRange]
         #
         def to_grpc
           @grpc

data/lib/google/cloud/bigtable/rows_mutator.rb

@@ -53,7 +53,7 @@ module Google
         ##
         # Applies mutations.
         #
-        # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
+        # @return [Array<Google::Cloud::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         def apply_mutations
           @req_entries = @entries.map(&:to_grpc)
@@ -80,7 +80,7 @@ module Google
         # Mutates rows.
         #
         # @param entries [Array<Google::Cloud::Bigtable::MutationEntry>]
-        # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
+        # @return [Array<Google::Cloud::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         def mutate_rows entries
           response = @table.service.mutate_rows @table.path, entries, app_profile_id: @table.app_profile_id
@@ -92,7 +92,7 @@ module Google
         ##
         # Collects failed entries, retries mutation, and updates status.
         #
-        # @param statuses [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
+        # @param statuses [Array<Google::Cloud::Bigtable::V2::MutateRowsResponse::Entry>]
         # @param indices [Array<Integer>]
         #   Retry entries position mapping list
         # @return [Array<Integer>]

data/lib/google/cloud/bigtable/rows_reader.rb

@@ -59,14 +59,14 @@ module Google
         ##
         # Read rows
         #
-        # @param rows [Google::Bigtable::V2::RowSet]
+        # @param rows [Google::Cloud::Bigtable::V2::RowSet]
         #   The row keys and/or ranges to read.
         #   If not specified, reads from all rows.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::V2::RowSet`.
-        # @param filter [Google::Bigtable::V2::RowFilter | Hash]
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::V2::RowSet`.
+        # @param filter [Google::Cloud::Bigtable::V2::RowFilter | Hash]
         #   The filter to apply to the contents of the specified row(s). If unset,
         #   reads the entirety of each row.
-        #   A hash in the form of `Google::Bigtable::V2::RowFilter`
+        #   A hash in the form of `Google::Cloud::Bigtable::V2::RowFilter`
         #   can also be provided.
         # @param rows_limit [Integer]
         #   The read will terminate after committing to N rows' worth of results.
@@ -111,12 +111,12 @@ module Google
         # @param rows_limit [Integer]
         #   The read will terminate after committing to N rows' worth of results.
         #   The default (zero) is to return all results.
-        # @param row_set [Google::Bigtable::V2::RowSet]
+        # @param row_set [Google::Cloud::Bigtable::V2::RowSet]
         #   The row keys and/or ranges to read.
         #   If not specified, reads from all rows.
-        #   A hash of the same form as `Google::Bigtable::V2::RowSet`
+        #   A hash of the same form as `Google::Cloud::Bigtable::V2::RowSet`
         #   can also be provided.
-        # @return [Integer, Google::Bigtable::V2::RowSet]
+        # @return [Integer, Google::Cloud::Bigtable::V2::RowSet]
         #
         def retry_options rows_limit, row_set
           return [rows_limit, row_set] unless last_key
@@ -142,7 +142,7 @@ module Google
 
           if row_set.row_ranges.empty?
             row_set.row_ranges <<
-              Google::Bigtable::V2::RowRange.new(start_key_open: last_key)
+              Google::Cloud::Bigtable::V2::RowRange.new(start_key_open: last_key)
           end
 
           # 3. Remove all individual keys before and up to the last read key
@@ -166,7 +166,7 @@ module Google
         ##
         # Checks if the start key was already read for the range.
         #
-        # @param range [Google::Bigtable::V2::RowRange]
+        # @param range [Google::Cloud::Bigtable::V2::RowRange]
         # @return [Boolean]
         #
         def start_key_read? range
@@ -182,7 +182,7 @@ module Google
         ##
         # Checks if the end key was already read for the range.
         #
-        # @param range [Google::Bigtable::V2::RowRange]
+        # @param range [Google::Cloud::Bigtable::V2::RowRange]
         # @return [Boolean]
         #
         def end_key_read? range

data/lib/google/cloud/bigtable/sample_row_key.rb

@@ -72,8 +72,8 @@ module Google
         # @private
         #
         # Creates a new SampleRowKey instance from a
-        # Google::Bigtable::V2::SampleRowKey.
-        # @param grpc [Google::Bigtable::V2::SampleRowKeysResponse]
+        # Google::Cloud::Bigtable::V2::SampleRowKey.
+        # @param grpc [Google::Cloud::Bigtable::V2::SampleRowKeysResponse]
         # @return [Google::Cloud::Bigtable::SampleRowKey]
         #
         def self.from_grpc grpc

data/lib/google/cloud/bigtable/service.rb

@@ -18,9 +18,8 @@
 require "google/cloud/bigtable/version"
 require "google/cloud/bigtable/errors"
 require "google/cloud/bigtable/credentials"
-require "google/cloud/bigtable/admin/v2/bigtable_instance_admin_client"
-require "google/cloud/bigtable/admin/v2/bigtable_table_admin_client"
-require "google/cloud/bigtable/v2/bigtable_client"
+require "google/cloud/bigtable/v2"
+require "google/cloud/bigtable/admin/v2"
 
 module Google
   module Cloud
@@ -29,7 +28,7 @@ module Google
       # gRPC Cloud Bigtable service, including API methods.
       class Service
         # @private
-        attr_accessor :project_id, :credentials, :host, :timeout, :client_config
+        attr_accessor :project_id, :credentials, :host, :host_admin, :timeout
 
         # @private
         # Creates a new Service instance.
@@ -49,109 +48,74 @@ module Google
         #   generally, to give OAuth credentials.
         # @param timeout [Integer]
         #   The default timeout, in seconds, for calls made through this client.
-        # @param client_config [Hash]
-        #   A hash for call options for each method. See Google::Gax#construct_settings for the structure of this data.
-        #   Falls back to the default config if not specified or the specified config is missing data points.
         #
-        def initialize project_id, credentials, host: nil, timeout: nil, client_config: nil
+        def initialize project_id, credentials, host: nil, host_admin: nil, timeout: nil
           @project_id = project_id
           @credentials = credentials
           @host = host
+          @host_admin = host_admin
           @timeout = timeout
-          @client_config = client_config || {}
         end
 
-        def channel default_host
-          require "grpc"
-          GRPC::Core::Channel.new((host || default_host), chan_args, chan_creds)
-        end
-
-        def chan_args
-          { "grpc.max_send_message_length"           => -1,
-            "grpc.max_receive_message_length"        => -1,
-            "grpc.service_config_disable_resolution" => 1 }
-        end
-
-        def chan_creds
-          return credentials if insecure?
-          require "grpc"
-          GRPC::Core::ChannelCredentials.new.compose GRPC::Core::CallCredentials.new credentials.client.updater_proc
-        end
-
-        ##
-        # Creates or returns an instance of an instance admin client.
-        #
-        # @return [Google::Cloud::Bigtable::Admin::V2::BigtableInstanceAdminClient]
-        #
         def instances
           return mocked_instances if mocked_instances
-          @instances ||= Admin::V2::BigtableInstanceAdminClient.new(
-            credentials:   channel(Admin::V2::BigtableInstanceAdminClient::SERVICE_ADDRESS),
-            timeout:       timeout,
-            client_config: client_config,
-            lib_name:      "gccl",
-            lib_version:   Google::Cloud::Bigtable::VERSION
-          )
+          @instances ||= Admin::V2::BigtableInstanceAdmin::Client.new do |config|
+            config.credentials = credentials if credentials
+            config.timeout = timeout if timeout
+            config.endpoint = host_admin if host_admin
+            config.lib_name = "gccl"
+            config.lib_version = Google::Cloud::Bigtable::VERSION
+            config.metadata = { "google-cloud-resource-prefix": "projects/#{@project_id}" }
+          end
         end
         attr_accessor :mocked_instances
 
-        ##
-        # Creates or returns an instance of a table admin client.
-        #
-        # @return [Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient]
-        #
         def tables
           return mocked_tables if mocked_tables
-          @tables ||= Admin::V2::BigtableTableAdminClient.new(
-            credentials:   channel(Admin::V2::BigtableTableAdminClient::SERVICE_ADDRESS),
-            timeout:       timeout,
-            client_config: client_config,
-            lib_name:      "gccl",
-            lib_version:   Google::Cloud::Bigtable::VERSION
-          )
+          @tables ||= Admin::V2::BigtableTableAdmin::Client.new do |config|
+            config.credentials = credentials if credentials
+            config.timeout = timeout if timeout
+            config.endpoint = host_admin if host_admin
+            config.lib_name = "gccl"
+            config.lib_version = Google::Cloud::Bigtable::VERSION
+            config.metadata = { "google-cloud-resource-prefix": "projects/#{@project_id}" }
+          end
         end
         attr_accessor :mocked_tables
 
-        ##
-        # Creates an instance of a data client.
-        #
-        # @return [Google::Cloud::Bigtable::V2::BigtableClient]
-        #
         def client
           return mocked_client if mocked_client
-          @client ||= V2::BigtableClient.new(
-            credentials:   channel(V2::BigtableClient::SERVICE_ADDRESS),
-            timeout:       timeout,
-            client_config: client_config,
-            lib_name:      "gccl",
-            lib_version:   Google::Cloud::Bigtable::VERSION
-          )
+          @client ||= V2::Bigtable::Client.new do |config|
+            config.credentials = credentials if credentials
+            config.timeout = timeout if timeout
+            config.endpoint = host if host
+            config.lib_name = "gccl"
+            config.lib_version = Google::Cloud::Bigtable::VERSION
+            config.metadata = { "google-cloud-resource-prefix": "projects/#{@project_id}" }
+          end
         end
         attr_accessor :mocked_client
 
-        def insecure?
-          credentials == :this_channel_is_insecure
-        end
-
         ##
         # Creates an instance within a project.
         #
         # @param instance_id [String]
         #   The permanent identifier to be used for the new instance.
         #
-        # @param instance [Google::Bigtable::Admin::V2::Instance | Hash]
-        # @param clusters [Hash{String => Google::Bigtable::Admin::V2::Cluster | Hash}]
+        # @param instance [Google::Cloud::Bigtable::Admin::V2::Instance | Hash]
+        # @param clusters [Hash{String => Google::Cloud::Bigtable::Admin::V2::Cluster | Hash}]
         #   The clusters to be created in the instance.
         #   Note that the cluster ID is the last segment of a cluster name. In the
         #   following cluster name, 'mycluster' is the cluster ID:
         #   +projects/myproject/instances/myinstance/clusters/mycluster+.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Cluster`
-        # @return [Google::Gax::Operation]
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::Admin::V2::Cluster`
+        # @return [Gapic::Operation]
         #
         def create_instance instance_id, instance, clusters
-          execute do
-            instances.create_instance project_path, instance_id, instance, clusters
-          end
+          instances.create_instance parent:      project_path,
+                                    instance_id: instance_id,
+                                    instance:    instance,
+                                    clusters:    clusters
         end
 
         ##
@@ -159,12 +123,10 @@ module Google
         #
         # @param token [String]
         #   The value of +next_page_token+ returned by a previous call.
-        # @return [Google::Bigtable::Admin::V2::ListInstancesResponse]
+        # @return [Google::Cloud::Bigtable::Admin::V2::ListInstancesResponse]
         #
         def list_instances token: nil
-          execute do
-            instances.list_instances project_path, page_token: token
-          end
+          instances.list_instances parent: project_path, page_token: token
         end
 
         ##
@@ -172,30 +134,26 @@ module Google
         #
         # @param instance_id [String]
         #   Unique ID of the requested instance.
-        # @return [Google::Bigtable::Admin::V2::Instance]
+        # @return [Google::Cloud::Bigtable::Admin::V2::Instance]
         #
         def get_instance instance_id
-          execute do
-            instances.get_instance instance_path(instance_id)
-          end
+          instances.get_instance name: instance_path(instance_id)
         end
 
         ##
         # Partially updates an instance.
         #
-        # @param instance [Google::Bigtable::Admin::V2::Instance | Hash]
+        # @param instance [Google::Cloud::Bigtable::Admin::V2::Instance | Hash]
         #   The instance that will (partially) replace the current value.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Instance.
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::Admin::V2::Instance.
         # @param update_mask [Google::Protobuf::FieldMask | Hash]
         #   List of instance properties to be replaced.
         #   Must be explicitly set.
         #   Alternatively, provide a hash in the form of `Google::Protobuf::FieldMask`.
-        # @return [Google::Gax::Operation]
+        # @return [Gapic::Operation]
         #
         def partial_update_instance instance, update_mask
-          execute do
-            instances.partial_update_instance instance, update_mask
-          end
+          instances.partial_update_instance instance: instance, update_mask: update_mask
         end
 
         ##
@@ -205,11 +163,7 @@ module Google
         #   Unique ID of the instance to be deleted.
         #
         def delete_instance instance_id
-          execute do
-            instances.delete_instance(
-              instance_path(instance_id)
-            )
-          end
+          instances.delete_instance name: instance_path(instance_id)
         end
 
         ##
@@ -219,18 +173,16 @@ module Google
         #   Unique ID of the instance in which to create the new cluster
         # @param cluster_id [String]
         #   Unique permanent identifier for the new cluster
-        # @param cluster [Google::Bigtable::Admin::V2::Cluster | Hash]
+        # @param cluster [Google::Cloud::Bigtable::Admin::V2::Cluster | Hash]
         #   The cluster to be created.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Cluster`
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::Admin::V2::Cluster`
         #
-        # @return [Google::Gax::Operation]
+        # @return [Gapic::Operation]
         #
         def create_cluster instance_id, cluster_id, cluster
           cluster.location = location_path cluster.location unless cluster.location == ""
 
-          execute do
-            instances.create_cluster instance_path(instance_id), cluster_id, cluster
-          end
+          instances.create_cluster parent: instance_path(instance_id), cluster_id: cluster_id, cluster: cluster
         end
 
         ##
@@ -240,12 +192,10 @@ module Google
         #   Unique ID of the instance for which a list of clusters is requested.
         # @param token [String]
         #   The value of +next_page_token+ returned by a previous call.
-        # @return [Google::Bigtable::Admin::V2::ListClustersResponse]
+        # @return [Google::Cloud::Bigtable::Admin::V2::ListClustersResponse]
         #
         def list_clusters instance_id, token: nil
-          execute do
-            instances.list_clusters instance_path(instance_id), page_token: token
-          end
+          instances.list_clusters parent: instance_path(instance_id), page_token: token
         end
 
         ##
@@ -255,12 +205,10 @@ module Google
         #   Unique ID of the instance the cluster is in.
         # @param cluster_id [String]
         #   Unique ID of the requested cluster.
-        # @return [Google::Bigtable::Admin::V2::Cluster]
+        # @return [Google::Cloud::Bigtable::Admin::V2::Cluster]
         #
         def get_cluster instance_id, cluster_id
-          execute do
-            instances.get_cluster cluster_path(instance_id, cluster_id)
-          end
+          instances.get_cluster name: cluster_path(instance_id, cluster_id)
         end
 
         ##
@@ -278,12 +226,12 @@ module Google
         # @param serve_nodes [Integer]
         #   The number of nodes allocated to this cluster. More nodes enable higher
         #   throughput and more consistent performance.
-        # @return [Google::Gax::Operation]
+        # @return [Gapic::Operation]
         #
         def update_cluster instance_id, cluster_id, location, serve_nodes
-          execute do
-            instances.update_cluster cluster_path(instance_id, cluster_id), location, serve_nodes
-          end
+          instances.update_cluster name:        cluster_path(instance_id, cluster_id),
+                                   location:    location,
+                                   serve_nodes: serve_nodes
         end
 
         ##
@@ -295,9 +243,7 @@ module Google
         #    Unique ID of the cluster to be deleted.
         #
         def delete_cluster instance_id, cluster_id
-          execute do
-            instances.delete_cluster cluster_path(instance_id, cluster_id)
-          end
+          instances.delete_cluster name: cluster_path(instance_id, cluster_id)
         end
 
         ##
@@ -308,10 +254,10 @@ module Google
         #   Unique ID of the instance to create the table in.
         # @param table_id [String]
         #   Unique, permanent identifier for the new table.
-        # @param table [Google::Bigtable::Admin::V2::Table | Hash]
+        # @param table [Google::Cloud::Bigtable::Admin::V2::Table | Hash]
         #   The table to create.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Table`.
-        # @param initial_splits [Array<Google::Bigtable::Admin::V2::CreateTableRequest::Split | Hash>]
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::Admin::V2::Table`.
+        # @param initial_splits [Array<Google::Cloud::Bigtable::Admin::V2::CreateTableRequest::Split | Hash>]
         #   The optional list of row keys that will be used to initially split the
         #   table into several tablets (tablets are similar to HBase regions).
         #   Given two split keys, +s1+ and +s2+, three tablets will be created,
@@ -329,15 +275,20 @@ module Google
         #       * Tablet 4 +[customer_2, other)      => {"customer_2"}.+
         #       * Tablet 5 +[other, )                => {"other", "zz"}.+
         #   Alternatively, provide a hash in the form of
-        #   `Google::Bigtable::Admin::V2::CreateTableRequest::Split`
-        # @return [Google::Bigtable::Admin::V2::Table]
+        #   `Google::Cloud::Bigtable::Admin::V2::CreateTableRequest::Split`
+        # @return [Google::Cloud::Bigtable::Admin::V2::Table]
         #
         def create_table instance_id, table_id, table, initial_splits: nil
           initial_splits = initial_splits.map { |key| { key: key } } if initial_splits
 
-          execute do
-            tables.create_table instance_path(instance_id), table_id, table, initial_splits: initial_splits
-          end
+          tables.create_table(
+            {
+              parent:         instance_path(instance_id),
+              table_id:       table_id,
+              table:          table,
+              initial_splits: initial_splits
+            }.delete_if { |_, v| v.nil? }
+          )
         end
 
         ##
@@ -345,18 +296,16 @@ module Google
         #
         # @param instance_id [String]
         #   Unique ID of the instance for which tables should be listed.
-        # @param view [Google::Bigtable::Admin::V2::Table::View]
+        # @param view [Google::Cloud::Bigtable::Admin::V2::Table::View]
         #   View to be applied to the returned tables' fields.
         #   Defaults to +NAME_ONLY+ if unspecified; no others are currently supported.
-        # @return [Google::Gax::PagedEnumerable<Google::Bigtable::Admin::V2::Table>]
-        #   An enumerable of Google::Bigtable::Admin::V2::Table instances.
-        #   See Google::Gax::PagedEnumerable documentation for other
+        # @return [Gapic::PagedEnumerable<Google::Cloud::Bigtable::Admin::V2::Table>]
+        #   An enumerable of Google::Cloud::Bigtable::Admin::V2::Table instances.
+        #   See Gapic::PagedEnumerable documentation for other
         #   operations such as per-page iteration or access to the response.
         #
         def list_tables instance_id, view: nil
-          execute do
-            tables.list_tables instance_path(instance_id), view: view
-          end
+          tables.list_tables parent: instance_path(instance_id), view: view
         end
 
         ##
@@ -366,15 +315,13 @@ module Google
         #   Unique ID of the instance the table is in.
         # @param table_id [String]
         #   Unique ID of the requested table.
-        # @param view [Google::Bigtable::Admin::V2::Table::View]
+        # @param view [Google::Cloud::Bigtable::Admin::V2::Table::View]
         #   View to be applied to the returned table's fields.
         #   Defaults to +SCHEMA_VIEW+ if unspecified.
-        # @return [Google::Bigtable::Admin::V2::Table]
+        # @return [Google::Cloud::Bigtable::Admin::V2::Table]
         #
         def get_table instance_id, table_id, view: nil
-          execute do
-            tables.get_table table_path(instance_id, table_id), view: view
-          end
+          tables.get_table name: table_path(instance_id, table_id), view: view
         end
 
         ##
@@ -386,9 +333,7 @@ module Google
         #   Unique ID of the table to be deleted.
         #
         def delete_table instance_id, table_id
-          execute do
-            tables.delete_table table_path(instance_id, table_id)
-          end
+          tables.delete_table name: table_path(instance_id, table_id)
         end
 
         ##
@@ -401,19 +346,18 @@ module Google
         #   Unique ID of the instance the table is in.
         # @param table_id [String]
         #   Unique ID of the table whose families should be modified.
-        # @param modifications [Array<Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification | Hash>]
+        # @param modifications
+        #   [Array<Google::Cloud::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification | Hash>]
         #   Modifications to be atomically applied to the specified table's families.
         #   Entries are applied in order, meaning that earlier modifications can be
         #   masked by later ones (in the case of repeated updates to the same family,
         #   for example).
         #   Alternatively, provide a hash in the form of
-        #    `Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification`.
-        # @return [Google::Bigtable::Admin::V2::Table]
+        #    `Google::Cloud::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification`.
+        # @return [Google::Cloud::Bigtable::Admin::V2::Table]
         #
         def modify_column_families instance_id, table_id, modifications
-          execute do
-            tables.modify_column_families table_path(instance_id, table_id), modifications
-          end
+          tables.modify_column_families name: table_path(instance_id, table_id), modifications: modifications
         end
 
         ##
@@ -426,12 +370,10 @@ module Google
         #   Unique ID of the instance the table is in.
         # @param table_id [String]
         #   Unique ID of the table the consistency token is for.
-        # @return [Google::Bigtable::Admin::V2::GenerateConsistencyTokenResponse]
+        # @return [Google::Cloud::Bigtable::Admin::V2::GenerateConsistencyTokenResponse]
         #
         def generate_consistency_token instance_id, table_id
-          execute do
-            tables.generate_consistency_token table_path(instance_id, table_id)
-          end
+          tables.generate_consistency_token name: table_path(instance_id, table_id)
         end
 
         ##
@@ -445,12 +387,10 @@ module Google
         #   Unique ID of the table to check for replication consistency.
         # @param token [String] Consistency token
         #   The token created for the table using GenerateConsistencyToken.
-        # @return [Google::Bigtable::Admin::V2::CheckConsistencyResponse]
+        # @return [Google::Cloud::Bigtable::Admin::V2::CheckConsistencyResponse]
         #
         def check_consistency instance_id, table_id, token
-          execute do
-            tables.check_consistency table_path(instance_id, table_id), token
-          end
+          tables.check_consistency name: table_path(instance_id, table_id), consistency_token: token
         end
 
         ##
@@ -467,8 +407,7 @@ module Google
         #   Prefix cannot be zero length.
         # @param delete_all_data_from_table [true, false]
         #   If true, delete all rows in the table. Setting this to false is a no-op.
-        # @param timeout [Integer]
-        #   Sets the API call timeout if deadline exceeds exception.
+        # @param timeout [Integer] Seconds. Sets the API call timeout if deadline exceeds exception.
         #
         def drop_row_range instance_id, table_id, row_key_prefix: nil, delete_all_data_from_table: nil, timeout: nil
           call_options = nil
@@ -476,21 +415,18 @@ module Google
           # Pass a timeout with a larger value if the drop operation throws
           # an error for timeout time.
           if timeout
-            retry_options = Google::Gax::RetryOptions.new(
-              [],
-              Google::Gax::BackoffSettings.new(0, 0, 0, timeout * 1000, 0, 0, 0)
-            )
-            call_options = Google::Gax::CallOptions.new retry_options: retry_options
+            retry_policy = Gapic::CallOptions::RetryPolicy.new max_delay: timeout * 1000
+            call_options = Gapic::CallOptions.new retry_policy: retry_policy
           end
 
-          execute do
-            tables.drop_row_range(
-              table_path(instance_id, table_id),
+          tables.drop_row_range(
+            {
+              name:                       table_path(instance_id, table_id),
               row_key_prefix:             row_key_prefix,
-              delete_all_data_from_table: delete_all_data_from_table,
-              options:                    call_options
-            )
-          end
+              delete_all_data_from_table: delete_all_data_from_table
+            },
+            call_options
+          )
         end
 
         ##
@@ -501,22 +437,18 @@ module Google
         # @param app_profile_id [String]
         #   The permanent identifier for the new app profile within its
         #   instance.
-        # @param app_profile [Google::Bigtable::Admin::V2::AppProfile | Hash]
+        # @param app_profile [Google::Cloud::Bigtable::Admin::V2::AppProfile | Hash]
         #   The app profile to be created.
-        #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::AppProfile`.
+        #   Alternatively, provide a hash in the form of `Google::Cloud::Bigtable::Admin::V2::AppProfile`.
         # @param ignore_warnings [Boolean]
         #   If true, ignore safety checks when creating the app profile.
-        # @return [Google::Bigtable::Admin::V2::AppProfile]
+        # @return [Google::Cloud::Bigtable::Admin::V2::AppProfile]
         #
         def create_app_profile instance_id, app_profile_id, app_profile, ignore_warnings: nil
-          execute do
-            instances.create_app_profile(
-              instance_path(instance_id),
-              app_profile_id,
-              app_profile,
-              ignore_warnings: ignore_warnings
-            )
-          end
+          instances.create_app_profile parent:          instance_path(instance_id),
+                                       app_profile_id:  app_profile_id,
+                                       app_profile:     app_profile,
+                                       ignore_warnings: ignore_warnings
         end
 
         ##
@@ -526,12 +458,10 @@ module Google
         #   Unique ID of the instance.
         # @param app_profile_id [String]
         #   Unique ID of the requested app profile.
-        # @return [Google::Bigtable::Admin::V2::AppProfile]
+        # @return [Google::Cloud::Bigtable::Admin::V2::AppProfile]
         #
         def get_app_profile instance_id, app_profile_id
-          execute do
-            instances.get_app_profile app_profile_path(instance_id, app_profile_id)
-          end
+          instances.get_app_profile name: app_profile_path(instance_id, app_profile_id)
         end
 
         ##
@@ -539,25 +469,23 @@ module Google
         #
         # @param instance_id [String]
         #   Unique ID of the instance
-        # @return [Google::Gax::PagedEnumerable<Google::Bigtable::Admin::V2::AppProfile>]
-        #   An enumerable of Google::Bigtable::Admin::V2::AppProfile instances.
-        #   See Google::Gax::PagedEnumerable documentation for other
+        # @return [Gapic::PagedEnumerable<Google::Cloud::Bigtable::Admin::V2::AppProfile>]
+        #   An enumerable of Google::Cloud::Bigtable::Admin::V2::AppProfile instances.
+        #   See Gapic::PagedEnumerable documentation for other
         #   operations such as per-page iteration or access to the response
         #   object.
         #
         def list_app_profiles instance_id
-          execute do
-            instances.list_app_profiles instance_path(instance_id)
-          end
+          instances.list_app_profiles parent: instance_path(instance_id)
         end
 
         ##
         # Updates an app profile within an instance.
         #
-        # @param app_profile [Google::Bigtable::Admin::V2::AppProfile | Hash]
+        # @param app_profile [Google::Cloud::Bigtable::Admin::V2::AppProfile | Hash]
         #   The app profile that will (partially) replace the current value.
         #   Alternatively, provide a hash in the form of
-        #   `Google::Bigtable::Admin::V2::AppProfile`.
+        #   `Google::Cloud::Bigtable::Admin::V2::AppProfile`.
         # @param update_mask [Google::Protobuf::FieldMask | Hash]
         #   The subset of app profile fields that should be replaced.
         #   If unset, all fields will be replaced.
@@ -567,9 +495,9 @@ module Google
         # @return [Google::Longrunning::Operation]
         #
         def update_app_profile app_profile, update_mask, ignore_warnings: nil
-          execute do
-            instances.update_app_profile app_profile, update_mask, ignore_warnings: ignore_warnings
-          end
+          instances.update_app_profile app_profile:     app_profile,
+                                       update_mask:     update_mask,
+                                       ignore_warnings: ignore_warnings
         end
 
         ##
@@ -583,9 +511,49 @@ module Google
         #   If true, ignore safety checks when deleting the app profile.
         #
         def delete_app_profile instance_id, app_profile_id, ignore_warnings: nil
-          execute do
-            instances.delete_app_profile app_profile_path(instance_id, app_profile_id), ignore_warnings
-          end
+          instances.delete_app_profile name:            app_profile_path(instance_id, app_profile_id),
+                                       ignore_warnings: ignore_warnings
+        end
+
+        ##
+        # Gets the access control policy for an backup resource. Returns an empty
+        # policy if an backup exists but does not have a policy set.
+        #
+        # @return [Google::Iam::V1::Policy]
+        #
+        def get_backup_policy instance_id, cluster_id, backup_id
+          tables.get_iam_policy resource: backup_path(instance_id, cluster_id, backup_id)
+        end
+
+        ##
+        # Sets the access control policy on an backup resource. Replaces any
+        # existing policy.
+        #
+        # @param policy [Google::Iam::V1::Policy | Hash]
+        #   REQUIRED: The complete policy to be applied to the +resource+. The size of
+        #   the policy is limited to a few 10s of KB. An empty policy is valid
+        #   for Cloud Bigtable, but certain Cloud Platform services (such as Projects)
+        #   might reject an empty policy.
+        #   Alternatively, provide a hash similar to `Google::Iam::V1::Policy`.
+        # @return [Google::Iam::V1::Policy]
+        #
+        def set_backup_policy instance_id, cluster_id, backup_id, policy
+          tables.set_iam_policy resource: backup_path(instance_id, cluster_id, backup_id), policy: policy
+        end
+
+        ##
+        # Returns permissions that the caller has for the specified backup resource.
+        #
+        # @param permissions [Array<String>]
+        #   The set of permissions to check for the +resource+. Permissions with
+        #   wildcards (such as '*' or 'storage.*') are not allowed. For more
+        #   information see
+        #   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+        # @return [Google::Iam::V1::TestIamPermissionsResponse]
+        #
+        def test_backup_permissions instance_id, cluster_id, backup_id, permissions
+          tables.test_iam_permissions resource:    backup_path(instance_id, cluster_id, backup_id),
+                                      permissions: permissions
         end
 
         ##
@@ -597,9 +565,7 @@ module Google
         # @return [Google::Iam::V1::Policy]
         #
         def get_instance_policy instance_id
-          execute do
-            instances.get_iam_policy instance_path(instance_id)
-          end
+          instances.get_iam_policy resource: instance_path(instance_id)
         end
 
         ##
@@ -617,9 +583,7 @@ module Google
         # @return [Google::Iam::V1::Policy]
         #
         def set_instance_policy instance_id, policy
-          execute do
-            instances.set_iam_policy instance_path(instance_id), policy
-          end
+          instances.set_iam_policy resource: instance_path(instance_id), policy: policy
         end
 
         ##
@@ -635,9 +599,7 @@ module Google
         # @return [Google::Iam::V1::TestIamPermissionsResponse]
         #
         def test_instance_permissions instance_id, permissions
-          execute do
-            instances.test_iam_permissions instance_path(instance_id), permissions
-          end
+          instances.test_iam_permissions resource: instance_path(instance_id), permissions: permissions
         end
 
         ##
@@ -649,9 +611,7 @@ module Google
         # @return [Google::Iam::V1::Policy]
         #
         def get_table_policy instance_id, table_id
-          execute do
-            tables.get_iam_policy table_path(instance_id, table_id)
-          end
+          tables.get_iam_policy resource: table_path(instance_id, table_id)
         end
 
         ##
@@ -669,9 +629,7 @@ module Google
         # @return [Google::Iam::V1::Policy]
         #
         def set_table_policy instance_id, table_id, policy
-          execute do
-            tables.set_iam_policy table_path(instance_id, table_id), policy
-          end
+          tables.set_iam_policy resource: table_path(instance_id, table_id), policy: policy
         end
 
         ##
@@ -687,14 +645,11 @@ module Google
         # @return [Google::Iam::V1::TestIamPermissionsResponse]
         #
         def test_table_permissions instance_id, table_id, permissions
-          execute do
-            tables.test_iam_permissions table_path(instance_id, table_id), permissions
-          end
+          tables.test_iam_permissions resource: table_path(instance_id, table_id), permissions: permissions
         end
 
         def read_rows instance_id, table_id, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil
-          # execute is not used because error handling is in ReadOperations#read_rows
-          client.read_rows table_path(instance_id, table_id),
+          client.read_rows table_name:     table_path(instance_id, table_id),
                            rows:           rows,
                            filter:         filter,
                            rows_limit:     rows_limit,
@@ -702,49 +657,114 @@ module Google
         end
 
         def sample_row_keys table_name, app_profile_id: nil
-          execute do
-            client.sample_row_keys table_name, app_profile_id: app_profile_id
-          end
+          client.sample_row_keys table_name: table_name, app_profile_id: app_profile_id
         end
 
         def mutate_row table_name, row_key, mutations, app_profile_id: nil
-          execute do
-            client.mutate_row table_name, row_key, mutations, app_profile_id: app_profile_id
-          end
+          client.mutate_row(
+            {
+              table_name:     table_name,
+              app_profile_id: app_profile_id,
+              row_key:        row_key,
+              mutations:      mutations
+            }.delete_if { |_, v| v.nil? }
+          )
         end
 
         def mutate_rows table_name, entries, app_profile_id: nil
-          execute do
-            client.mutate_rows table_name, entries, app_profile_id: app_profile_id
-          end
+          client.mutate_rows(
+            {
+              table_name:     table_name,
+              app_profile_id: app_profile_id,
+              entries:        entries
+            }.delete_if { |_, v| v.nil? }
+          )
         end
 
-        def check_and_mutate_row table_name, row_key, app_profile_id: nil, predicate_filter: nil, true_mutations: nil,
+        def check_and_mutate_row table_name,
+                                 row_key,
+                                 app_profile_id: nil,
+                                 predicate_filter: nil,
+                                 true_mutations: nil,
                                  false_mutations: nil
-          execute do
-            client.check_and_mutate_row table_name, row_key, app_profile_id: app_profile_id,
-                                        predicate_filter: predicate_filter, true_mutations: true_mutations,
-                                        false_mutations: false_mutations
-          end
+          client.check_and_mutate_row(
+            {
+              table_name:       table_name,
+              app_profile_id:   app_profile_id,
+              row_key:          row_key,
+              predicate_filter: predicate_filter,
+              true_mutations:   true_mutations,
+              false_mutations:  false_mutations
+            }.delete_if { |_, v| v.nil? }
+          )
         end
 
         def read_modify_write_row table_name, row_key, rules, app_profile_id: nil
-          execute do
-            client.read_modify_write_row table_name, row_key, rules, app_profile_id: app_profile_id
-          end
+          client.read_modify_write_row(
+            {
+              table_name:     table_name,
+              app_profile_id: app_profile_id,
+              row_key:        row_key,
+              rules:          rules
+            }.delete_if { |_, v| v.nil? }
+          )
         end
 
         ##
-        # Executes the API call and wrap errors to {Google::Cloud::Error}.
+        # Starts creating a new backup. The underlying Google::Longrunning::Operation tracks creation of the backup.
         #
-        # @raise [Google::Cloud::Error]
+        # @return [Gapic::Operation]
+        #
+        def create_backup instance_id:, cluster_id:, backup_id:, source_table_id:, expire_time:
+          backup = Google::Cloud::Bigtable::Admin::V2::Backup.new \
+            source_table: table_path(instance_id, source_table_id), expire_time: expire_time
+          tables.create_backup parent: cluster_path(instance_id, cluster_id), backup_id: backup_id, backup: backup
+        end
+
+        ##
+        # @return [Google::Cloud::Bigtable::Admin::V2::Backup]
         #
-        def execute
-          yield
-        rescue Google::Gax::GaxError => e
-          raise Google::Cloud::Error.from_error(e.cause)
-        rescue GRPC::BadStatus => e
-          raise Google::Cloud::Error.from_error(e)
+        def get_backup instance_id, cluster_id, backup_id
+          tables.get_backup name: backup_path(instance_id, cluster_id, backup_id)
+        end
+
+        ##
+        # @return [Gapic::PagedEnumerable<Google::Cloud::Bigtable::Admin::V2::Backup>]
+        #
+        def list_backups instance_id, cluster_id
+          tables.list_backups parent: cluster_path(instance_id, cluster_id)
+        end
+
+        ##
+        # @param backup [Google::Cloud::Bigtable::Admin::V2::Backup | Hash]
+        # @param fields [Array(String|Symbol)] the paths of fields to be updated
+        #
+        def update_backup backup, fields
+          mask = Google::Protobuf::FieldMask.new paths: fields.map(&:to_s)
+          tables.update_backup backup: backup, update_mask: mask
+        end
+
+        def delete_backup instance_id, cluster_id, backup_id
+          tables.delete_backup name: backup_path(instance_id, cluster_id, backup_id)
+        end
+
+        ##
+        # Create a new table by restoring from a completed backup.
+        #
+        # @param table_id [String] The table ID for the new table. This table must not yet exist.
+        # @param instance_id [String] The instance ID for the source backup. The table will be created in this instance.
+        # @param cluster_id [String] The cluster ID for the source backup.
+        # @param backup_id [String] The backup ID for the source backup.
+        #
+        # @return [Gapic::Operation] The {Google::Longrunning::Operation#metadata metadata} field type is
+        #   {Google::Cloud::Bigtable::Admin::RestoreTableMetadata RestoreTableMetadata}. The
+        #   {Google::Longrunning::Operation#response response} type is
+        #   {Google::Cloud::Bigtable::Admin::V2::Table Table}, if successful.
+        #
+        def restore_table table_id, instance_id, cluster_id, backup_id
+          tables.restore_table parent:   instance_path(instance_id),
+                               table_id: table_id,
+                               backup:   backup_path(instance_id, cluster_id, backup_id)
         end
 
         ##
@@ -755,7 +775,7 @@ module Google
         #   +projects/<project>+
         #
         def project_path
-          Admin::V2::BigtableInstanceAdminClient.project_path project_id
+          Admin::V2::BigtableInstanceAdmin::Paths.project_path project: project_id
         end
 
         ##
@@ -767,7 +787,7 @@ module Google
         #   +projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]+.
         #
         def instance_path instance_id
-          Admin::V2::BigtableInstanceAdminClient.instance_path project_id, instance_id
+          Admin::V2::BigtableInstanceAdmin::Paths.instance_path project: project_id, instance: instance_id
         end
 
         ##
@@ -780,7 +800,9 @@ module Google
         #   +projects/<project>/instances/<instance>/clusters/<cluster>+.
         #
         def cluster_path instance_id, cluster_id
-          Admin::V2::BigtableInstanceAdminClient.cluster_path project_id, instance_id, cluster_id
+          Admin::V2::BigtableInstanceAdmin::Paths.cluster_path project:  project_id,
+                                                               instance: instance_id,
+                                                               cluster:  cluster_id
         end
 
         ##
@@ -793,7 +815,7 @@ module Google
         #   +projects/<project_id>/locations/<location>+.
         #
         def location_path location
-          Admin::V2::BigtableInstanceAdminClient.location_path project_id, location
+          Admin::V2::BigtableInstanceAdmin::Paths.location_path project: project_id, location: location
         end
 
         ##
@@ -805,7 +827,7 @@ module Google
         #   +projects/<project>/instances/<instance>/tables/<table>+
         #
         def table_path instance_id, table_id
-          Admin::V2::BigtableTableAdminClient.table_path project_id, instance_id, table_id
+          Admin::V2::BigtableTableAdmin::Paths.table_path project: project_id, instance: instance_id, table: table_id
         end
 
         ##
@@ -818,7 +840,22 @@ module Google
         #   +projects/<project>/instances/<instance>/appProfiles/<app_profile>+
         #
         def app_profile_path instance_id, app_profile_id
-          Admin::V2::BigtableInstanceAdminClient.app_profile_path project_id, instance_id, app_profile_id
+          Admin::V2::BigtableInstanceAdmin::Paths.app_profile_path project:     project_id,
+                                                                   instance:    instance_id,
+                                                                   app_profile: app_profile_id
+        end
+
+        ##
+        # Creates a formatted backup path.
+        #
+        # @return [String] Formatted backup path
+        #   `projects/<project>/instances/<instance>/clusters/<cluster>/backups/<backup>`
+        #
+        def backup_path instance_id, cluster_id, backup_id
+          Admin::V2::BigtableTableAdmin::Paths.backup_path project:  project_id,
+                                                           instance: instance_id,
+                                                           cluster:  cluster_id,
+                                                           backup:   backup_id
         end
 
         ##