google-cloud-bigtable 1.3.0

data/lib/google/cloud/bigtable.rb

@@ -0,0 +1,184 @@
+# Copyright 2018 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.
+
+
+require "google-cloud-bigtable"
+require "google/cloud/env"
+require "google/cloud/errors"
+require "google/cloud/bigtable/credentials"
+require "google/cloud/bigtable/project"
+
+module Google
+  module Cloud
+    ##
+    # Cloud Bigtable
+    #
+    # See {file:OVERVIEW.md Bigtable Overview}.
+    #
+    module Bigtable
+      ##
+      # Service for managing Cloud Bigtable instances and tables and for reading from and
+      # writing to Bigtable tables.
+      #
+      # @param project_id [String]
+      #   Project identifier for the Bigtable service you are connecting to.
+      #   If not present, the default project for the credentials is used.
+      # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel,
+      #   GRPC::Core::ChannelCredentials, Proc]
+      #   Provides the means for authenticating requests made by the client. This parameter can
+      #   be one of the following types:
+      #   `Google::Auth::Credentials` uses the properties of its represented keyfile for
+      #   authenticating requests made by this client.
+      #   `String` will be treated as the path to the keyfile to use to construct
+      #   credentials for this client.
+      #   `Hash` will be treated as the contents of a keyfile to use to construct
+      #   credentials for this client.
+      #   `GRPC::Core::Channel` will be used to make calls through.
+      #   `GRPC::Core::ChannelCredentials` for the setting up the gRPC client. The channel credentials
+      #   should already be composed with a `GRPC::Core::CallCredentials` object.
+      #   `Proc` will be used as an updater_proc for the gRPC channel. The proc transforms the
+      #   metadata for requests, generally, to give OAuth credentials.
+      # @param [String] endpoint Override of the endpoint host name. Optional.
+      #   If the param is nil, uses the default endpoint.
+      # @param [String] emulator_host Bigtable emulator host. Optional.
+      #   If the parameter is nil, uses the value of the `emulator_host` config.
+      # @param scope [Array<String>]
+      #   The OAuth 2.0 scopes controlling the set of resources and operations
+      #   that the connection can access. See [Using OAuth 2.0 to Access Google
+      #   APIs](https://developers.google.com/identity/protocols/OAuth2).
+      #   The OAuth scopes for this service. This parameter is ignored if an
+      #   updater_proc is supplied.
+      # @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.
+      # @param timeout [Integer]
+      #   The default timeout, in seconds, for calls made through this client. Optional.
+      # @return [Google::Cloud::Bigtable::Project]
+      #
+      # @example
+      #   require "google/cloud/bigtable"
+      #
+      #   client = Google::Cloud::Bigtable.new
+      #
+      def self.new project_id: nil, credentials: nil, emulator_host: nil, scope: nil, client_config: nil, endpoint: nil,
+                   timeout: nil
+        project_id    ||= default_project_id
+        scope         ||= configure.scope
+        timeout       ||= configure.timeout
+        client_config ||= configure.client_config
+        emulator_host ||= configure.emulator_host
+        endpoint      ||= configure.endpoint
+
+        if emulator_host
+          return new_with_emulator project_id, emulator_host, timeout,
+                                   client_config
+        end
+
+        credentials = resolve_credentials credentials, scope
+        project_id = resolve_project_id project_id, credentials
+        raise ArgumentError, "project_id is missing" if project_id.empty?
+
+        service = Bigtable::Service.new(
+          project_id, credentials,
+          host: endpoint, timeout: timeout, client_config: client_config
+        )
+        Bigtable::Project.new service
+      end
+
+      ##
+      # Configure the Google Cloud Bigtable library.
+      #
+      # The following Bigtable configuration parameters are supported:
+      #
+      # * `project_id` - (String) Identifier for a Bigtable project. (The
+      #   parameter `project` is considered deprecated, but may also be used.)
+      # * `credentials` - (String, Hash, Google::Auth::Credentials,
+      #    GRPC::Core::Channel, GRPC::Core::ChannelCredentials) The path to
+      #   the keyfile as a String, the contents of the keyfile as a Hash, or a
+      #   Google::Auth::Credentials object. (See {Bigtable::Credentials}) (The
+      #   parameter `keyfile` is considered deprecated, but may also be used.)
+      # * `scope` - (String, Array<String>) The OAuth 2.0 scopes controlling
+      #   the set of resources and operations that the connection can access.
+      # * `timeout` - (Integer) Default timeout to use in requests.
+      # * `client_config` - (Hash) A hash of values to override the default
+      #   behavior of the API client.
+      # * `endpoint` - (String) Override of the endpoint host name, or `nil`
+      #   to use the default endpoint.
+      #
+      # @return [Google::Cloud::Config] The configuration object the
+      #   Google::Cloud::Bigtable library uses.
+      #
+      def self.configure
+        yield Google::Cloud.configure.bigtable if block_given?
+
+        Google::Cloud.configure.bigtable
+      end
+
+      # @private
+      # New client given an emulator host.
+      #
+      def self.new_with_emulator project_id, emulator_host, timeout,
+                                 client_config
+        project_id = project_id.to_s # Always cast to a string
+        raise ArgumentError, "project_id is missing" if project_id.empty?
+
+        Bigtable::Project.new(
+          Bigtable::Service.new(
+            project_id, :this_channel_is_insecure,
+            host: emulator_host, timeout: timeout,
+            client_config: client_config
+          )
+        )
+      end
+
+      # @private
+      # Resolve credentials
+      #
+      def self.resolve_credentials given_credentials, scope
+        credentials = given_credentials || default_credentials(scope: scope)
+        return credentials if credentials.is_a? Google::Auth::Credentials
+        Bigtable::Credentials.new credentials, scope: scope
+      end
+
+      # @private
+      # Resolve project.
+      #
+      def self.resolve_project_id given_project_id, credentials
+        project_id = given_project_id || default_project_id
+        project_id ||= credentials.project_id if credentials.respond_to? :project_id
+        project_id.to_s # Always cast to a string
+      end
+
+      # @private
+      # Default project.
+      #
+      def self.default_project_id
+        Google::Cloud.configure.bigtable.project_id ||
+          Google::Cloud.configure.project_id ||
+          Google::Cloud.env.project_id
+      end
+
+      # @private
+      # Default credentials.
+      #
+      def self.default_credentials scope: nil
+        Google::Cloud.configure.bigtable.credentials ||
+          Google::Cloud.configure.credentials ||
+          Bigtable::Credentials.default(scope: scope)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,202 @@
+# Copyright 2020 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.
+
+
+require "google/gax"
+require "pathname"
+
+module Google
+  module Cloud
+    module Bigtable
+      # rubocop:disable LineLength
+
+      ##
+      # # Ruby Client for Cloud Bigtable Admin API
+      #
+      # [Cloud Bigtable Admin API][Product Documentation]:
+      # Administer your Cloud Bigtable tables and instances.
+      # - [Product Documentation][]
+      #
+      # ## Quick Start
+      # In order to use this library, you first need to go through the following
+      # steps:
+      #
+      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+      # 3. [Enable the Cloud Bigtable Admin API.](https://console.cloud.google.com/apis/library/bigtableadmin.googleapis.com)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
+      #
+      # ### Installation
+      # ```
+      # $ gem install google-cloud-bigtable
+      # ```
+      #
+      # ### Next Steps
+      # - Read the [Cloud Bigtable Admin API Product documentation][Product Documentation]
+      #   to learn more about the product and see How-to Guides.
+      # - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
+      #   to see the full list of Cloud APIs that we cover.
+      #
+      # [Product Documentation]: https://cloud.google.com/bigtable/docs/reference/admin/rpc
+      #
+      # ## Enabling Logging
+      #
+      # 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/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+      # that will write logs to [Stackdriver 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.
+      #
+      # Configuring a Ruby stdlib logger:
+      #
+      # ```ruby
+      # require "logger"
+      #
+      # module MyLogger
+      #   LOGGER = Logger.new $stderr, level: Logger::WARN
+      #   def logger
+      #     LOGGER
+      #   end
+      # end
+      #
+      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+      # module GRPC
+      #   extend MyLogger
+      # end
+      # ```
+      #
+      module Admin
+        # rubocop:enable LineLength
+
+        FILE_DIR = File.realdirpath(Pathname.new(__FILE__).join("..").join("admin"))
+
+        AVAILABLE_VERSIONS = Dir["#{FILE_DIR}/*"]
+          .select { |file| File.directory?(file) }
+          .select { |dir| Google::Gax::VERSION_MATCHER.match(File.basename(dir)) }
+          .select { |dir| File.exist?(dir + ".rb") }
+          .map { |dir| File.basename(dir) }
+
+        module BigtableInstanceAdmin
+          ##
+          # Service for creating, configuring, and deleting Cloud Bigtable Instances and
+          # Clusters. Provides access to the Instance and Cluster schemas only, not the
+          # tables' metadata or data stored in those tables.
+          #
+          # @param version [Symbol, String]
+          #   The major version of the service to be used. By default :v2
+          #   is used.
+          # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
+          #   @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+          #     Provides the means for authenticating requests made by the client. This parameter can
+          #     be many types.
+          #     A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+          #     authenticating requests made by this client.
+          #     A `String` will be treated as the path to the keyfile to be used for the construction of
+          #     credentials for this client.
+          #     A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+          #     credentials for this client.
+          #     A `GRPC::Core::Channel` will be used to make calls through.
+          #     A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+          #     should already be composed with a `GRPC::Core::CallCredentials` object.
+          #     A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+          #     metadata for requests, generally, to give OAuth credentials.
+          #   @param scopes [Array<String>]
+          #     The OAuth scopes for this service. This parameter is ignored if
+          #     an updater_proc is supplied.
+          #   @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.
+          #   @param timeout [Numeric]
+          #     The default timeout, in seconds, for calls made through this client.
+          #   @param metadata [Hash]
+          #     Default metadata to be sent with each request. This can be overridden on a per call basis.
+          #   @param exception_transformer [Proc]
+          #     An optional proc that intercepts any exceptions raised during an API call to inject
+          #     custom error handling.
+          def self.new(*args, version: :v2, **kwargs)
+            unless AVAILABLE_VERSIONS.include?(version.to_s.downcase)
+              raise "The version: #{version} is not available. The available versions " \
+                "are: [#{AVAILABLE_VERSIONS.join(", ")}]"
+            end
+
+            require "#{FILE_DIR}/#{version.to_s.downcase}"
+            version_module = Google::Cloud::Bigtable::Admin
+              .constants
+              .select {|sym| sym.to_s.downcase == version.to_s.downcase}
+              .first
+            Google::Cloud::Bigtable::Admin.const_get(version_module)::BigtableInstanceAdmin.new(*args, **kwargs)
+          end
+        end
+
+        module BigtableTableAdmin
+          ##
+          # Service for creating, configuring, and deleting Cloud Bigtable tables.
+          #
+          #
+          # Provides access to the table schemas only, not the data stored within
+          # the tables.
+          #
+          # @param version [Symbol, String]
+          #   The major version of the service to be used. By default :v2
+          #   is used.
+          # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
+          #   @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+          #     Provides the means for authenticating requests made by the client. This parameter can
+          #     be many types.
+          #     A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+          #     authenticating requests made by this client.
+          #     A `String` will be treated as the path to the keyfile to be used for the construction of
+          #     credentials for this client.
+          #     A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+          #     credentials for this client.
+          #     A `GRPC::Core::Channel` will be used to make calls through.
+          #     A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+          #     should already be composed with a `GRPC::Core::CallCredentials` object.
+          #     A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+          #     metadata for requests, generally, to give OAuth credentials.
+          #   @param scopes [Array<String>]
+          #     The OAuth scopes for this service. This parameter is ignored if
+          #     an updater_proc is supplied.
+          #   @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.
+          #   @param timeout [Numeric]
+          #     The default timeout, in seconds, for calls made through this client.
+          #   @param metadata [Hash]
+          #     Default metadata to be sent with each request. This can be overridden on a per call basis.
+          #   @param exception_transformer [Proc]
+          #     An optional proc that intercepts any exceptions raised during an API call to inject
+          #     custom error handling.
+          def self.new(*args, version: :v2, **kwargs)
+            unless AVAILABLE_VERSIONS.include?(version.to_s.downcase)
+              raise "The version: #{version} is not available. The available versions " \
+                "are: [#{AVAILABLE_VERSIONS.join(", ")}]"
+            end
+
+            require "#{FILE_DIR}/#{version.to_s.downcase}"
+            version_module = Google::Cloud::Bigtable::Admin
+              .constants
+              .select {|sym| sym.to_s.downcase == version.to_s.downcase}
+              .first
+            Google::Cloud::Bigtable::Admin.const_get(version_module)::BigtableTableAdmin.new(*args, **kwargs)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigtable/admin/credentials.rb

@@ -0,0 +1,27 @@
+# Copyright 2018 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.
+
+
+require "google/cloud/bigtable/admin/v2/credentials"
+
+module Google
+  module Cloud
+    module Bigtable
+      module Admin
+        class Credentials < Google::Cloud::Bigtable::Admin::V2::Credentials
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,223 @@
+# Copyright 2020 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.
+
+
+require "google/cloud/bigtable/admin/v2/bigtable_instance_admin_client"
+require "google/cloud/bigtable/admin/v2/bigtable_table_admin_client"
+require "google/bigtable/admin/v2/bigtable_instance_admin_pb"
+require "google/bigtable/admin/v2/table_pb"
+require "google/bigtable/admin/v2/bigtable_table_admin_pb"
+
+module Google
+  module Cloud
+    module Bigtable
+      module Admin
+        # rubocop:disable LineLength
+
+        ##
+        # # Ruby Client for Cloud Bigtable Admin API
+        #
+        # [Cloud Bigtable Admin API][Product Documentation]:
+        # Administer your Cloud Bigtable tables and instances.
+        # - [Product Documentation][]
+        #
+        # ## Quick Start
+        # In order to use this library, you first need to go through the following
+        # steps:
+        #
+        # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+        # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+        # 3. [Enable the Cloud Bigtable Admin API.](https://console.cloud.google.com/apis/library/bigtableadmin.googleapis.com)
+        # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
+        #
+        # ### Installation
+        # ```
+        # $ gem install google-cloud-bigtable
+        # ```
+        #
+        # ### Next Steps
+        # - Read the [Cloud Bigtable Admin API Product documentation][Product Documentation]
+        #   to learn more about the product and see How-to Guides.
+        # - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
+        #   to see the full list of Cloud APIs that we cover.
+        #
+        # [Product Documentation]: https://cloud.google.com/bigtable/docs/reference/admin/rpc
+        #
+        # ## Enabling Logging
+        #
+        # 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/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+        # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+        # that will write logs to [Stackdriver 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.
+        #
+        # Configuring a Ruby stdlib logger:
+        #
+        # ```ruby
+        # require "logger"
+        #
+        # module MyLogger
+        #   LOGGER = Logger.new $stderr, level: Logger::WARN
+        #   def logger
+        #     LOGGER
+        #   end
+        # end
+        #
+        # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+        # module GRPC
+        #   extend MyLogger
+        # end
+        # ```
+        #
+        module V2
+          # rubocop:enable LineLength
+
+          module BigtableInstanceAdmin
+            ##
+            # Service for creating, configuring, and deleting Cloud Bigtable Instances and
+            # Clusters. Provides access to the Instance and Cluster schemas only, not the
+            # tables' metadata or data stored in those tables.
+            #
+            # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+            #   Provides the means for authenticating requests made by the client. This parameter can
+            #   be many types.
+            #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+            #   authenticating requests made by this client.
+            #   A `String` will be treated as the path to the keyfile to be used for the construction of
+            #   credentials for this client.
+            #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+            #   credentials for this client.
+            #   A `GRPC::Core::Channel` will be used to make calls through.
+            #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+            #   should already be composed with a `GRPC::Core::CallCredentials` object.
+            #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+            #   metadata for requests, generally, to give OAuth credentials.
+            # @param scopes [Array<String>]
+            #   The OAuth scopes for this service. This parameter is ignored if
+            #   an updater_proc is supplied.
+            # @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.
+            # @param timeout [Numeric]
+            #   The default timeout, in seconds, for calls made through this client.
+            # @param metadata [Hash]
+            #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+            # @param service_address [String]
+            #   Override for the service hostname, or `nil` to leave as the default.
+            # @param service_port [Integer]
+            #   Override for the service port, or `nil` to leave as the default.
+            # @param exception_transformer [Proc]
+            #   An optional proc that intercepts any exceptions raised during an API call to inject
+            #   custom error handling.
+            def self.new \
+                credentials: nil,
+                scopes: nil,
+                client_config: nil,
+                timeout: nil,
+                metadata: nil,
+                service_address: nil,
+                service_port: nil,
+                exception_transformer: nil,
+                lib_name: nil,
+                lib_version: nil
+              kwargs = {
+                credentials: credentials,
+                scopes: scopes,
+                client_config: client_config,
+                timeout: timeout,
+                metadata: metadata,
+                exception_transformer: exception_transformer,
+                lib_name: lib_name,
+                service_address: service_address,
+                service_port: service_port,
+                lib_version: lib_version
+              }.select { |_, v| v != nil }
+              Google::Cloud::Bigtable::Admin::V2::BigtableInstanceAdminClient.new(**kwargs)
+            end
+          end
+
+          module BigtableTableAdmin
+            ##
+            # Service for creating, configuring, and deleting Cloud Bigtable tables.
+            #
+            #
+            # Provides access to the table schemas only, not the data stored within
+            # the tables.
+            #
+            # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+            #   Provides the means for authenticating requests made by the client. This parameter can
+            #   be many types.
+            #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+            #   authenticating requests made by this client.
+            #   A `String` will be treated as the path to the keyfile to be used for the construction of
+            #   credentials for this client.
+            #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+            #   credentials for this client.
+            #   A `GRPC::Core::Channel` will be used to make calls through.
+            #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+            #   should already be composed with a `GRPC::Core::CallCredentials` object.
+            #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+            #   metadata for requests, generally, to give OAuth credentials.
+            # @param scopes [Array<String>]
+            #   The OAuth scopes for this service. This parameter is ignored if
+            #   an updater_proc is supplied.
+            # @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.
+            # @param timeout [Numeric]
+            #   The default timeout, in seconds, for calls made through this client.
+            # @param metadata [Hash]
+            #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+            # @param service_address [String]
+            #   Override for the service hostname, or `nil` to leave as the default.
+            # @param service_port [Integer]
+            #   Override for the service port, or `nil` to leave as the default.
+            # @param exception_transformer [Proc]
+            #   An optional proc that intercepts any exceptions raised during an API call to inject
+            #   custom error handling.
+            def self.new \
+                credentials: nil,
+                scopes: nil,
+                client_config: nil,
+                timeout: nil,
+                metadata: nil,
+                service_address: nil,
+                service_port: nil,
+                exception_transformer: nil,
+                lib_name: nil,
+                lib_version: nil
+              kwargs = {
+                credentials: credentials,
+                scopes: scopes,
+                client_config: client_config,
+                timeout: timeout,
+                metadata: metadata,
+                exception_transformer: exception_transformer,
+                lib_name: lib_name,
+                service_address: service_address,
+                service_port: service_port,
+                lib_version: lib_version
+              }.select { |_, v| v != nil }
+              Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.new(**kwargs)
+            end
+          end
+        end
+      end
+    end
+  end
+end