google-cloud-bigtable 2.5.0 → 2.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87e7128a687d06d1e5dc3e74f2b529ab43b3c9ea28717d738c433ea86fb297ad
-  data.tar.gz: a04ca13f900445078568a3a1cf64ef84d57686a494f3a652cc6ec461af41712e
+  metadata.gz: d5d6fdd59208f51aa50479e83129f8689ecac860ae17f2abe04d525392f5a595
+  data.tar.gz: 1aa4c9cd7b7fb605d538cbf70bb6adb1f4210e60302cf600db4ccc33594e77de
 SHA512:
-  metadata.gz: dc329bd4e9f0d1ed5c5376c40da2924a41f83681df93803aafcadd9ed846bdd2119b913661054b95cfc70cbbfada891b58563b3146396acd872ae2fa79cbff2b
-  data.tar.gz: af466ef435035adae503c5368b0e7c899e84424151044d49efb51f2920e121854ca8af51708c9fce7181e1116410408c635a040442b8b004df45d76b5184c721
+  metadata.gz: 5bd7202000a07744b619c074784d318295370063275a2b3ac28aa287c1ac3718874f26f70bffddf9853cf71a34530dee0d9753a28091f1e2e4fb7ec836efd74c
+  data.tar.gz: ce6d9e219982b4e1f9c908f5f320b4b0d4b472b304e4c9cff654469c8610bf4734090ee4abb864e6f22b841fd7671776d98efe242ba941e167346ba5fdd0884a

data/AUTHENTICATION.md

@@ -95,7 +95,8 @@ client = Google::Cloud::Bigtable.new
 
 ### Configuration
 
-The **Project ID** and **Credentials JSON** can be configured instead of placing them in environment variables or providing them as arguments.
+The **Project ID** and the path to the **Credentials JSON** file can be configured
+instead of placing them in environment variables or providing them as arguments.
 
 ```ruby
 require "google/cloud/bigtable"

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Release History
 
+### 2.6.3 / 2021-09-21
+
+#### Documentation
+
+* Fix typo in Emulator guide links
+
+### 2.6.2 / 2021-08-02
+
+#### Documentation
+
+* Update inline doc samples to match library code style
+
+### 2.6.1 / 2021-07-08
+
+#### Documentation
+
+* Update AUTHENTICATION.md in handwritten packages
+
+### 2.6.0 / 2021-05-03
+
+#### Features
+
+* Add support for Backup restore to different Instance
+  * Add instance to Backup#restore
+
 ### 2.5.0 / 2021-04-20
 
 #### Features

data/OVERVIEW.md

@@ -396,5 +396,5 @@ instance.delete
 ## Additional information
 
 Google Bigtable can be configured to use an emulator or to enable gRPC's
-logging. To learn more, see the {file:EMULATOR.md Emulator guide}} and
+logging. To learn more, see the {file:EMULATOR.md Emulator guide} and
 {file:LOGGING.md Logging guide}.

data/lib/google/cloud/bigtable/app_profile/job.rb

@@ -34,8 +34,8 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   instance = bigtable.instance "my-instance"
+        #   app_profile = instance.app_profile "my-app-profile"
         #
         #   app_profile.description = "User data instance app profile"
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.single_cluster_routing(
@@ -71,8 +71,8 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
-          #   app_profile = instance.app_profile("my-app-profile")
+          #   instance = bigtable.instance "my-instance"
+          #   app_profile = instance.app_profile "my-app-profile"
           #
           #   app_profile.description = "User data instance app profile"
           #   routing_policy = Google::Cloud::Bigtable::AppProfile.single_cluster_routing(

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

@@ -47,7 +47,7 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
+          #   instance = bigtable.instance "my-instance"
           #   app_profiles = instance.app_profiles
           #
           #   if app_profiles.next?
@@ -68,7 +68,7 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
+          #   instance = bigtable.instance "my-instance"
           #   app_profiles = instance.app_profiles
           #
           #   if app_profiles.next?
@@ -104,7 +104,7 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
+          #   instance = bigtable.instance "my-instance"
           #   app_profiles = instance.app_profiles
           #
           #   instance.app_profiles.all do |app_profile|
@@ -116,11 +116,9 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
+          #   instance = bigtable.instance "my-instance"
           #
-          #   all_app_profile_ids = instance.app_profiles.all.map do |app_profile|
-          #     app_profile.name
-          #   end
+          #   all_app_profile_ids = instance.app_profiles.all.map(&:name)
           #
           def all &block
             return enum_for :all unless block_given?

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

@@ -33,9 +33,9 @@ module Google
       #
       #   bigtable = Google::Cloud::Bigtable.new
       #
-      #   instance = bigtable.instance("my-instance")
+      #   instance = bigtable.instance "my-instance"
       #
-      #   app_profile = instance.app_profile("my-app-profile")
+      #   app_profile = instance.app_profile "my-app-profile"
       #
       #   # Update
       #   app_profile.description = "User data instance app profile"
@@ -172,8 +172,8 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   instance = bigtable.instance "my-instance"
+        #   app_profile = instance.app_profile "my-app-profile"
         #
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.multi_cluster_routing
         #   app_profile.routing_policy = routing_policy
@@ -182,11 +182,11 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   instance = bigtable.instance "my-instance"
+        #   app_profile = instance.app_profile "my-app-profile"
         #
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.single_cluster_routing(
-        #     "my-instance-cluster-1",
+        #     "my-cluster",
         #     allow_transactional_writes: true
         #   )
         #   app_profile.routing_policy = routing_policy
@@ -225,7 +225,7 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.multi_cluster_routing
         #
@@ -253,11 +253,11 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   app_profile = instance.app_profile "my-app-profile"
         #
-        #   app_profile.delete(ignore_warnings: true) # Ignore warnings.
+        #   app_profile.delete ignore_warnings: true # Ignore warnings.
         #
         #   # OR : Not ignoring warnings
         #   app_profile.delete
@@ -281,20 +281,19 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   app_profile = instance.app_profile "my-app-profile"
         #
         #   app_profile.description = "User data instance app profile"
-        #   app_profile.routing_policy = \
-        #     Google::Cloud::Bigtable::AppProfile.multi_cluster_routing
+        #   app_profile.routing_policy = Google::Cloud::Bigtable::AppProfile.multi_cluster_routing
         #
         #   job = app_profile.save
         #   job.wait_until_done!
         #   if job.error?
         #     puts job.error
         #   else
-        #     puts "App profile successfully update."
+        #     puts "App profile successfully updated."
         #     app_profile = job.app_profile
         #   end
         #
@@ -303,8 +302,8 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   app_profile = instance.app_profile("my-app-profile")
+        #   instance = bigtable.instance "my-instance"
+        #   app_profile = instance.app_profile "my-app-profile"
         #
         #   app_profile.description = "User data instance app profile"
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.single_cluster_routing(
@@ -360,7 +359,7 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.multi_cluster_routing
         #
@@ -396,10 +395,10 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #
         #   routing_policy = Google::Cloud::Bigtable::AppProfile.single_cluster_routing(
-        #     "my-instance-cluster-1",
+        #     "my-cluster",
         #     allow_transactional_writes: true
         #   )
         #

data/lib/google/cloud/bigtable/backup/job.rb

@@ -34,12 +34,12 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
-        #   table = instance.table("my-table")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
+        #   table = instance.table "my-table"
         #
         #   expire_time = Time.now + 60 * 60 * 7
-        #   job = cluster.create_backup(table, "my-backup", expire_time)
+        #   job = cluster.create_backup table, "my-backup", expire_time
         #
         #   job.wait_until_done!
         #   job.done? #=> true
@@ -61,12 +61,12 @@ module Google
           #   require "google/cloud/bigtable"
           #
           #   bigtable = Google::Cloud::Bigtable.new
-          #   instance = bigtable.instance("my-instance")
-          #   cluster = instance.cluster("my-cluster")
-          #   table = instance.table("my-table")
+          #   instance = bigtable.instance "my-instance"
+          #   cluster = instance.cluster "my-cluster"
+          #   table = instance.table "my-table"
           #
           #   expire_time = Time.now + 60 * 60 * 7
-          #   job = cluster.create_backup(table, "my-backup", expire_time)
+          #   job = cluster.create_backup table, "my-backup", expire_time
           #
           #   job.wait_until_done!
           #   job.done? #=> true

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

@@ -46,8 +46,8 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
-          #   cluster = instance.cluster("my-cluster")
+          #   instance = bigtable.instance "my-instance"
+          #   cluster = instance.cluster "my-cluster"
           #
           #   backups = cluster.backups
           #
@@ -69,8 +69,8 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
-          #   cluster = instance.cluster("my-cluster")
+          #   instance = bigtable.instance "my-instance"
+          #   cluster = instance.cluster "my-cluster"
           #
           #   backups = cluster.backups
           #
@@ -105,8 +105,8 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
-          #   cluster = instance.cluster("my-cluster")
+          #   instance = bigtable.instance "my-instance"
+          #   cluster = instance.cluster "my-cluster"
           #
           #   cluster.backups.all do |backup|
           #     puts backup.backup_id
@@ -117,12 +117,10 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
-          #   cluster = instance.cluster("my-cluster")
+          #   instance = bigtable.instance "my-instance"
+          #   cluster = instance.cluster "my-cluster"
           #
-          #   all_backup_ids = cluster.backups.all.map do |backup|
-          #     backup.backup_id
-          #   end
+          #   all_backup_ids = cluster.backups.all.map(&:backup_id)
           #
           def all &block
             return enum_for :all unless block_given?

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

@@ -34,10 +34,10 @@ module Google
       #   require "google/cloud/bigtable"
       #
       #   bigtable = Google::Cloud::Bigtable.new
-      #   instance = bigtable.instance("my-instance")
-      #   cluster = instance.cluster("my-cluster")
+      #   instance = bigtable.instance "my-instance"
+      #   cluster = instance.cluster "my-cluster"
       #
-      #   backup = cluster.backup("my-backup")
+      #   backup = cluster.backup "my-backup"
       #
       #   # Update
       #   backup.expire_time = Time.now + 60 * 60 * 7
@@ -216,10 +216,10 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   encryption_info = backup.encryption_info
         #   encryption_info.encryption_type #=> :GOOGLE_DEFAULT_ENCRYPTION
@@ -247,10 +247,10 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   policy = backup.policy
         #
@@ -258,13 +258,13 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   backup.policy do |p|
-        #     p.add("roles/owner", "user:owner@example.com")
+        #     p.add "roles/owner", "user:owner@example.com"
         #   end # 2 API calls
         #
         def policy
@@ -294,14 +294,14 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   policy = backup.policy
-        #   policy.add("roles/owner", "user:owner@example.com")
-        #   updated_policy = backup.update_policy(policy)
+        #   policy.add "roles/owner", "user:owner@example.com"
+        #   updated_policy = backup.update_policy policy
         #
         #   puts updated_policy.roles
         #
@@ -330,10 +330,10 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   permissions = backup.test_iam_permissions(
         #     "bigtable.backups.delete",
@@ -349,9 +349,12 @@ module Google
         end
 
         ##
-        # Creates a new table by restoring from a completed backup.
+        # Creates a new table by restoring data from a completed backup. The new table may be created in an instance
+        # different than that of the backup.
         #
         # @param table_id [String] The table ID for the new table. This table must not yet exist. Required.
+        # @param instance [Instance, String] The instance or the ID of the instance for the new table, if different from
+        #   the instance of the backup. Optional.
         #
         # @return [Google::Cloud::Bigtable::Table::RestoreJob] The job representing the long-running, asynchronous
         #   processing of a backup restore table operation.
@@ -360,12 +363,12 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
-        #   job = backup.restore("my-new-table")
+        #   job = backup.restore "my-new-table"
         #
         #   job.wait_until_done!
         #   job.done? #=> true
@@ -377,8 +380,35 @@ module Google
         #     optimized = job.optimize_table_operation_name
         #   end
         #
-        def restore table_id
-          grpc = service.restore_table table_id, instance_id, cluster_id, backup_id
+        # @example Create the table in a different instance.
+        #   require "google/cloud/bigtable"
+        #
+        #   bigtable = Google::Cloud::Bigtable.new
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
+        #
+        #   backup = cluster.backup "my-backup"
+        #
+        #   table_instance = bigtable.instance "my-other-instance"
+        #   job = backup.restore "my-new-table", instance: table_instance
+        #
+        #   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 restore table_id, instance: nil
+          table_instance_id = instance.respond_to?(:instance_id) ? instance.instance_id : instance
+          grpc = service.restore_table table_id,
+                                       instance_id,
+                                       cluster_id,
+                                       backup_id,
+                                       table_instance_id: table_instance_id
           Table::RestoreJob.from_grpc grpc, service
         end
 
@@ -393,10 +423,10 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   # Update
         #   backup.expire_time = Time.now + 60 * 60 * 7
@@ -428,10 +458,10 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   backup.delete
         #

data/lib/google/cloud/bigtable/cluster/job.rb

@@ -34,7 +34,7 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
+        #   instance = bigtable.instance "my-instance"
         #   job = instance.create_cluster(
         #     "my-new-cluster",
         #     "us-east-1b",
@@ -67,7 +67,7 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   instance = bigtable.instance("my-instance")
+          #   instance = bigtable.instance "my-instance"
           #   job = instance.create_cluster(
           #     "my-new-cluster",
           #     "us-east-1b",

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

@@ -33,8 +33,8 @@ module Google
       #
       #   bigtable = Google::Cloud::Bigtable.new
       #
-      #   instance = bigtable.instance("my-instance")
-      #   cluster = instance.cluster("my-cluster")
+      #   instance = bigtable.instance "my-instance"
+      #   cluster = instance.cluster "my-cluster"
       #
       #   # Update
       #   cluster.nodes = 3
@@ -239,12 +239,12 @@ module Google
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
-        #   table = instance.table("my-table")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
+        #   table = instance.table "my-table"
         #
         #   expire_time = Time.now + 60 * 60 * 7
-        #   job = cluster.create_backup(table, "my-backup", expire_time)
+        #   job = cluster.create_backup table, "my-backup", expire_time
         #
         #   job.wait_until_done!
         #   job.done? #=> true
@@ -277,10 +277,10 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
-        #   backup = cluster.backup("my-backup")
+        #   backup = cluster.backup "my-backup"
         #
         #   if backup
         #     puts backup.backup_id
@@ -303,8 +303,8 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #
         #   cluster.backups.all do |backup|
         #     puts backup.backup_id
@@ -329,8 +329,8 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #   cluster.nodes = 3
         #   job = cluster.save
         #
@@ -373,8 +373,8 @@ module Google
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   instance = bigtable.instance("my-instance")
-        #   cluster = instance.cluster("my-cluster")
+        #   instance = bigtable.instance "my-instance"
+        #   cluster = instance.cluster "my-cluster"
         #   cluster.delete
         #
         def delete

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

@@ -30,8 +30,8 @@ module Google
       #
       #   bigtable = Google::Cloud::Bigtable.new
       #
-      #   instance = bigtable.instance("my-instance")
-      #   table = instance.table("my-table")
+      #   instance = bigtable.instance "my-instance"
+      #   table = instance.table "my-table"
       #
       #   column_family = table.column_families["cf2"]
       #   puts column_family.gc_rule