google-cloud-bigtable 1.2.1 → 2.2.0

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

@@ -431,7 +431,7 @@ module Google
 
           yield column_families if block_given?
 
-          table = Google::Bigtable::Admin::V2::Table.new({
+          table = Google::Cloud::Bigtable::Admin::V2::Table.new({
             column_families: column_families.to_grpc_hash,
             granularity:     granularity
           }.delete_if { |_, v| v.nil? })
@@ -587,6 +587,7 @@ module Google
         #
         # @param row_key_prefix [String] Row key prefix (for example, "user").
         # @param delete_all_data [Boolean]
+        # @param timeout [Integer] Call timeout in seconds.
         # @return [Boolean]
         #
         # @example
@@ -615,9 +616,9 @@ module Google
         end
 
         # @private
-        # Creates a new Table instance from a Google::Bigtable::Admin::V2::Table.
+        # Creates a new Table instance from a Google::Cloud::Bigtable::Admin::V2::Table.
         #
-        # @param grpc [Google::Bigtable::Admin::V2::Table]
+        # @param grpc [Google::Cloud::Bigtable::Admin::V2::Table]
         # @param service [Google::Cloud::Bigtable::Service]
         # @param view [Symbol] View type.
         # @return [Google::Cloud::Bigtable::Table]
@@ -636,7 +637,7 @@ module Google
         # @return [Google::Cloud::Bigtable::Table]
         #
         def self.from_path path, service
-          grpc = Google::Bigtable::Admin::V2::Table.new name: path
+          grpc = Google::Cloud::Bigtable::Admin::V2::Table.new name: path
           new grpc, service, view: :NAME_ONLY
         end
 

data/lib/google/cloud/bigtable/table/cluster_state.rb

@@ -21,6 +21,8 @@ module Google
       class Table
         ##
         # Table::ClusterState is the state of a table's data in a particular cluster.
+        #
+        # @attr [String] cluster_name The name of the cluster.
         class ClusterState
           attr_reader :cluster_name
 
@@ -39,6 +41,10 @@ module Google
           #   * `:PLANNED_MAINTENANCE` - The table is temporarily unable to serve.
           #   * `:UNPLANNED_MAINTENANCE` - The table is temporarily unable to serve.
           #   * `:READY` - The table can serve.
+          #   * `:READY_OPTIMIZING` - The table is fully created and ready for use
+          #     after a restore, and is being optimized for performance. When
+          #     optimizations are complete, the table will transition to `READY`
+          #     state.
           #
           # @return [Symbol] The state of replication.
           #
@@ -51,7 +57,7 @@ module Google
           # over pre-existing data from other clusters before it can begin
           # receiving live replication updates and serving.
           #
-          # @return [Boolean] `true` if the cluster is initializing.
+          # @return [Boolean] `true` if the table in this cluster is initializing.
           #
           def initializing?
             replication_state == :INITIALIZING
@@ -61,7 +67,8 @@ module Google
           # The table is temporarily unable to serve
           # requests from this cluster due to planned internal maintenance.
           #
-          # @return [Boolean] `true` if the cluster is in planned maintenance.
+          # @return [Boolean] `true` if the table in this cluster is in planned
+          #   maintenance.
           #
           def planned_maintenance?
             replication_state == :PLANNED_MAINTENANCE
@@ -71,7 +78,8 @@ module Google
           # The table is temporarily unable to serve requests from this
           # cluster due to unplanned or emergency maintenance.
           #
-          # @return [Boolean] `true` if the cluster is in unplanned maintenance.
+          # @return [Boolean] `true` if the table in this cluster is in unplanned
+          #   maintenance.
           #
           def unplanned_maintenance?
             replication_state == :UNPLANNED_MAINTENANCE
@@ -82,15 +90,28 @@ module Google
           # Depending on replication delay, reads may not immediately
           # reflect the state of the table in other clusters.
           #
-          # @return [Boolean] `true` if the cluster is ready.
+          # @return [Boolean] `true` if the table in this cluster is ready.
           #
           def ready?
             replication_state == :READY
           end
 
+          ##
+          # The table is fully created and ready for use after a
+          # restore, and is being optimized for performance. When
+          # optimizations are complete, the table will transition to `READY`
+          # state.
+          #
+          # @return [Boolean] `true` if the table in this cluster is being
+          #   optimized.
+          #
+          def ready_optimizing?
+            replication_state == :READY_OPTIMIZING
+          end
+
           # @private
-          # New Table::ClusterState from a Google::Bigtable::Admin::V2::Table::ClusterState object.
-          # @param grpc [Google::Bigtable::Admin::V2::Table::ClusterState]
+          # New Table::ClusterState from a Google::Cloud::Bigtable::Admin::V2::Table::ClusterState object.
+          # @param grpc [Google::Cloud::Bigtable::Admin::V2::Table::ClusterState]
           # @param cluster_name [String]
           # @return [Google::Cloud::Bigtable::Table::ClusterState]
           #

data/lib/google/cloud/bigtable/table/list.rb

@@ -94,7 +94,7 @@ module Google
           # @yield [table] The block for accessing each table instance.
           # @yieldparam [Table] table The table instance object.
           #
-          # @return [Enumerator]
+          # @return [Enumerator,nil] An enumerator is returned if no block is given, otherwise `nil`.
           #
           # @example Iterating each table by passing a block:
           #   require "google/cloud/bigtable"
@@ -127,7 +127,7 @@ module Google
           end
 
           # @private
-          # New Table::List from a Google::Gax::PagedEnumerable<Google::Bigtable::Admin::V2::Table> object.
+          # New Table::List from a Gapic::PagedEnumerable<Google::Cloud::Bigtable::Admin::V2::Table> object.
           #
           def self.from_grpc grpc, service
             tables = List.new(Array(grpc.response.tables).map do |table|

data/lib/google/cloud/bigtable/table/restore_job.rb

@@ -0,0 +1,117 @@
+# 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.
+
+
+module Google
+  module Cloud
+    module Bigtable
+      class Table
+        ##
+        # # RestoreJob
+        #
+        # A resource representing the long-running, asynchronous processing of a backup restore operation. The
+        # job can be refreshed to retrieve the table object once the operation has been completed.
+        #
+        # See {Backup#restore}.
+        #
+        # @see https://cloud.google.com/bigtable/docs/reference/admin/rpc/google.longrunning#google.longrunning.Operation
+        #   Long-running Operation
+        #
+        # @example
+        #   require "google/cloud/bigtable"
+        #
+        #   bigtable = Google::Cloud::Bigtable.new
+        #   instance = bigtable.instance("my-instance")
+        #   cluster = instance.cluster("my-cluster")
+        #
+        #   backup = cluster.backup("my-backup")
+        #
+        #   job = backup.restore("my-new-table")
+        #
+        #   job.wait_until_done!
+        #   job.done? #=> true
+        #
+        #   if job.error?
+        #     status = job.error
+        #   else
+        #     table = job.table
+        #     optimized = job.optimize_table_operation_name
+        #   end
+        #
+        class RestoreJob < LongrunningJob
+          ##
+          # The optimize table operation name from operation metadata.
+          #
+          # @return [String, nil] The optimize table operation name, or `nil` if the optimize table operation is not
+          #   complete.
+          #
+          # @example
+          #   require "google/cloud/bigtable"
+          #
+          #   bigtable = Google::Cloud::Bigtable.new
+          #   instance = bigtable.instance("my-instance")
+          #   cluster = instance.cluster("my-cluster")
+          #
+          #   backup = cluster.backup("my-backup")
+          #
+          #   job = backup.restore("my-new-table")
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          #   if job.error?
+          #     status = job.error
+          #   else
+          #     table = job.table
+          #     optimized = job.optimize_table_operation_name
+          #   end
+          #
+          def optimize_table_operation_name
+            metadata.optimize_table_operation_name
+          end
+
+          ##
+          # Gets the table object from operation results.
+          #
+          # @return [Google::Cloud::Bigtable::Table, nil] The table instance, or `nil` if the operation is not complete.
+          #
+          # @example
+          #   require "google/cloud/bigtable"
+          #
+          #   bigtable = Google::Cloud::Bigtable.new
+          #   instance = bigtable.instance("my-instance")
+          #   cluster = instance.cluster("my-cluster")
+          #
+          #   backup = cluster.backup("my-backup")
+          #
+          #   job = backup.restore("my-new-table")
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          #   if job.error?
+          #     status = job.error
+          #   else
+          #     table = job.table
+          #     optimized = job.optimize_table_operation_name
+          #   end
+          #
+          def table
+            Table.from_grpc results, service if results
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -59,7 +59,7 @@ module Google
         # @private
         # Creates a value range instance.
         def initialize
-          @grpc = Google::Bigtable::V2::ValueRange.new
+          @grpc = Google::Cloud::Bigtable::V2::ValueRange.new
         end
 
         ##
@@ -170,7 +170,7 @@ module Google
 
         # @private
         #
-        # @return [Google::Bigtable::V2::ValueRange]
+        # @return [Google::Cloud::Bigtable::V2::ValueRange]
         #
         def to_grpc
           @grpc

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigtable
-      VERSION = "1.2.1".freeze
+      VERSION = "2.2.0".freeze
     end
   end
 end

metadata

@@ -1,97 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-21 00:00:00.000000000 Z
+date: 2020-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: google-cloud-core
+  name: google-cloud-bigtable-admin-v2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
-  name: google-gax
+  name: google-cloud-bigtable-v2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
-- !ruby/object:Gem::Dependency
-  name: googleapis-common-protos
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.3.9
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.3.9
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
-  name: googleapis-common-protos-types
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.4
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.4
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: grpc-google-iam-v1
+  name: google-cloud-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.9
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.9
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
@@ -221,43 +181,13 @@ files:
 - OVERVIEW.md
 - TROUBLESHOOTING.md
 - lib/google-cloud-bigtable.rb
-- lib/google/bigtable/admin/v2/bigtable_instance_admin_pb.rb
-- lib/google/bigtable/admin/v2/bigtable_instance_admin_services_pb.rb
-- lib/google/bigtable/admin/v2/bigtable_table_admin_pb.rb
-- lib/google/bigtable/admin/v2/bigtable_table_admin_services_pb.rb
-- lib/google/bigtable/admin/v2/common_pb.rb
-- lib/google/bigtable/admin/v2/instance_pb.rb
-- lib/google/bigtable/admin/v2/table_pb.rb
-- lib/google/bigtable/v2/bigtable_pb.rb
-- lib/google/bigtable/v2/bigtable_services_pb.rb
-- lib/google/bigtable/v2/data_pb.rb
 - lib/google/cloud/bigtable.rb
-- lib/google/cloud/bigtable/admin.rb
-- lib/google/cloud/bigtable/admin/credentials.rb
-- lib/google/cloud/bigtable/admin/v2.rb
-- lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client.rb
-- lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client_config.json
-- lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client.rb
-- lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json
-- lib/google/cloud/bigtable/admin/v2/credentials.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_instance_admin.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_table_admin.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/instance.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/table.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/iam/v1/iam_policy.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/iam/v1/options.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/iam/v1/policy.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/longrunning/operations.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/any.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/duration.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/empty.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/field_mask.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/timestamp.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/rpc/status.rb
-- lib/google/cloud/bigtable/admin/v2/doc/google/type/expr.rb
 - lib/google/cloud/bigtable/app_profile.rb
 - lib/google/cloud/bigtable/app_profile/job.rb
 - lib/google/cloud/bigtable/app_profile/list.rb
+- lib/google/cloud/bigtable/backup.rb
+- lib/google/cloud/bigtable/backup/job.rb
+- lib/google/cloud/bigtable/backup/list.rb
 - lib/google/cloud/bigtable/chunk_processor.rb
 - lib/google/cloud/bigtable/cluster.rb
 - lib/google/cloud/bigtable/cluster/job.rb
@@ -296,15 +226,7 @@ files:
 - lib/google/cloud/bigtable/table.rb
 - lib/google/cloud/bigtable/table/cluster_state.rb
 - lib/google/cloud/bigtable/table/list.rb
-- lib/google/cloud/bigtable/v2.rb
-- lib/google/cloud/bigtable/v2/bigtable_client.rb
-- lib/google/cloud/bigtable/v2/bigtable_client_config.json
-- lib/google/cloud/bigtable/v2/credentials.rb
-- lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/bigtable.rb
-- lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/data.rb
-- lib/google/cloud/bigtable/v2/doc/google/protobuf/any.rb
-- lib/google/cloud/bigtable/v2/doc/google/protobuf/wrappers.rb
-- lib/google/cloud/bigtable/v2/doc/google/rpc/status.rb
+- lib/google/cloud/bigtable/table/restore_job.rb
 - lib/google/cloud/bigtable/value_range.rb
 - lib/google/cloud/bigtable/version.rb
 homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-bigtable
@@ -326,7 +248,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: API Client library for Cloud Bigtable API