google-cloud-bigtable 2.1.0 → 2.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a096cf8d1c1d26e38753da0ac165bdec3491bd821ce49da374b35362d5dc32a2
-  data.tar.gz: b7c9b2b6832514c1861f8cd9c6af2e73b1c4c7c2fa1ce3354ff7dd125c769dea
+  metadata.gz: 1d2ceaa917a67e31cae160f8cfb03ecb1617aebf24c634d89a3f5805589d3f46
+  data.tar.gz: c2c614ffbd788256c15037c22ff9f7fd09208399a49ee85149e9515e0976f0f9
 SHA512:
-  metadata.gz: b40689f9ab7ef728fa6e156e2cd3c2aa8dbaa0e23adb957501ec2b016fc1dff0235485c2c95f2a9d2398bee9a070455fc36f55f2fcdd5cc4ebabb971c3155e66
-  data.tar.gz: 33383bc875ced164d0f32e230653c03b2786ffaa00f024145bfb3ee1e067412e60eedb28814a2571d904e1c3706bea34c3cbc9129b7063c7259050ccd38eb2bb
+  metadata.gz: 6e019a7ad97017938d2960b52951dda90911d5f84c6d3c95cd09abd0086d35b68f8f4139d5626c92065928eec8493758aa0fb6d6185cf89a149eadde53c54675
+  data.tar.gz: f3eeec0098bd030dad2a8cd07b08dae4d58d02753ead572d552eaf7543a93776ca48576bb7c37199a7cd181f6f23e98f989778a0f7ee8e9e614522f97fbf23e8

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Release History
 
+### 2.4.1 / 2021-04-01
+
+#### Bug Fixes
+
+* Update internal management of view states in Table
+
+### 2.4.0 / 2021-03-10
+
+#### Features
+
+* Drop support for Ruby 2.4 and add support for Ruby 3.0
+
+#### Documentation
+
+* Add link to Garbage collection docs
+
+### 2.3.0 / 2021-02-04
+
+#### Features
+
+* Add integer support to RowFilter#value and ValueRange
+  * Encode Integer arguments as 64-bit signed big-endian integer data
+
+### 2.2.1 / 2021-01-13
+
+#### Documentation
+
+* Use consistent column family and field names in samples
+
+### 2.2.0 / 2020-11-11
+
+#### Features
+
+* Add Backup-level IAM Policy support
+  * Add Backup#policy
+  * Add Backup#update_policy
+  * Add Backup#test_iam_permissions
+
 ### 2.1.0 / 2020-09-17
 
 #### Features

data/CONTRIBUTING.md

@@ -24,7 +24,7 @@ be able to accept your pull requests.
 In order to use the google-cloud-bigtable console and run the project's tests,
 there is a small amount of setup:
 
-1. Install Ruby. google-cloud-bigtable requires Ruby 2.4+. You may choose to
+1. Install Ruby. google-cloud-bigtable requires Ruby 2.5+. You may choose to
    manage your Ruby and gem installations with [RVM](https://rvm.io/),
    [rbenv](https://github.com/rbenv/rbenv), or
    [chruby](https://github.com/postmodern/chruby).
@@ -45,7 +45,7 @@ there is a small amount of setup:
 
    ```sh
    $ cd google-cloud-bigtable/
-   $ bundle exec rake bundleupdate
+   $ bundle install
    ```
 
 ## Console

data/LOGGING.md

@@ -3,7 +3,7 @@
 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
+[`Logger`](https://ruby-doc.org/stdlib/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

data/OVERVIEW.md

@@ -194,8 +194,8 @@ table = bigtable.table("my-instance", "my-table")
 
 entry = table.new_mutation_entry("user-1")
 entry.set_cell(
-  "cf-1",
-  "field-1",
+  "cf1",
+  "field1",
   "XYZ",
   timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
 ).delete_cells("cf2", "field02")
@@ -245,8 +245,8 @@ table = bigtable.table("my-instance", "my-table")
 predicate_filter = Google::Cloud::Bigtable::RowFilter.key("user-10")
 on_match_mutations = Google::Cloud::Bigtable::MutationEntry.new
 on_match_mutations.set_cell(
-  "cf-1",
-  "field-1",
+  "cf1",
+  "field1",
   "XYZ",
   timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
 ).delete_cells("cf2", "field02")

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

@@ -122,12 +122,12 @@ module Google
           #     app_profile.name
           #   end
           #
-          def all
+          def all &block
             return enum_for :all unless block_given?
 
             results = self
             loop do
-              results.each { |r| yield r }
+              results.each(&block)
               break unless next?
               grpc.next_page
               results = self.class.from_grpc grpc, service

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

@@ -18,6 +18,7 @@
 require "google/cloud/bigtable/backup/job"
 require "google/cloud/bigtable/backup/list"
 require "google/cloud/bigtable/convert"
+require "google/cloud/bigtable/policy"
 require "google/cloud/bigtable/table/restore_job"
 
 
@@ -206,6 +207,126 @@ module Google
           state == :READY
         end
 
+        ##
+        # Gets the [Cloud IAM](https://cloud.google.com/iam/) access control
+        # policy for the backup.
+        #
+        # @see https://cloud.google.com/bigtable/docs/access-control
+        #
+        # @yield [policy] A block for updating the policy. The latest policy
+        #   will be read from the Bigtable service and passed to the block. After
+        #   the block completes, the modified policy will be written to the
+        #   service.
+        # @yieldparam [Policy] policy the current Cloud IAM Policy for this
+        #   backup.
+        #
+        # @return [Policy] The current Cloud IAM Policy for the backup.
+        #
+        # @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")
+        #
+        #   policy = backup.policy
+        #
+        # @example Update the policy by passing a block.
+        #   require "google/cloud/bigtable"
+        #
+        #   bigtable = Google::Cloud::Bigtable.new
+        #   instance = bigtable.instance("my-instance")
+        #   cluster = instance.cluster("my-cluster")
+        #
+        #   backup = cluster.backup("my-backup")
+        #
+        #   backup.policy do |p|
+        #     p.add("roles/owner", "user:owner@example.com")
+        #   end # 2 API calls
+        #
+        def policy
+          ensure_service!
+          grpc = service.get_backup_policy instance_id, cluster_id, backup_id
+          policy = Policy.from_grpc grpc
+          return policy unless block_given?
+          yield policy
+          update_policy policy
+        end
+
+        ##
+        # Updates the [Cloud IAM](https://cloud.google.com/iam/) access control
+        # policy for the backup. The policy should be read from {#policy}.
+        # See {Google::Cloud::Bigtable::Policy} for an explanation of the policy
+        # `etag` property and how to modify policies.
+        #
+        # You can also update the policy by passing a block to {#policy}, which
+        # will call this method internally after the block completes.
+        #
+        # @param new_policy [Policy] a new or modified Cloud IAM Policy for this
+        #   backup
+        #
+        # @return [Policy] The policy returned by the API update 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")
+        #
+        #   policy = backup.policy
+        #   policy.add("roles/owner", "user:owner@example.com")
+        #   updated_policy = backup.update_policy(policy)
+        #
+        #   puts updated_policy.roles
+        #
+        def update_policy new_policy
+          ensure_service!
+          grpc = service.set_backup_policy instance_id, cluster_id, backup_id, new_policy.to_grpc
+          Policy.from_grpc grpc
+        end
+        alias policy= update_policy
+
+        ##
+        # Tests the specified permissions against the [Cloud
+        # IAM](https://cloud.google.com/iam/) access control policy.
+        #
+        # @see https://cloud.google.com/iam/docs/managing-policies Managing Policies
+        # @see https://cloud.google.com/bigtable/docs/access-control Access Control
+        #
+        # @param permissions [String, Array<String>] permissions The set of permissions to
+        #   check access for. Permissions with wildcards (such as `*` or `bigtable.*`) are
+        #   not allowed.
+        #   See [Access Control](https://cloud.google.com/bigtable/docs/access-control).
+        #
+        # @return [Array<String>] The permissions that are configured for the policy.
+        #
+        # @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")
+        #
+        #   permissions = backup.test_iam_permissions(
+        #     "bigtable.backups.delete",
+        #     "bigtable.backups.get"
+        #   )
+        #   permissions.include? "bigtable.backups.delete" #=> false
+        #   permissions.include? "bigtable.backups.get" #=> true
+        #
+        def test_iam_permissions *permissions
+          ensure_service!
+          grpc = service.test_backup_permissions instance_id, cluster_id, backup_id, permissions.flatten
+          grpc.permissions.to_a
+        end
+
         ##
         # Creates a new table by restoring from a completed backup.
         #

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

@@ -124,12 +124,12 @@ module Google
           #     backup.backup_id
           #   end
           #
-          def all
+          def all &block
             return enum_for :all unless block_given?
 
             results = self
             loop do
-              results.each { |r| yield r }
+              results.each(&block)
               break unless next?
               grpc.next_page
               results = self.class.from_grpc grpc, service

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

@@ -57,11 +57,12 @@ module Google
 
           raise_if chunk.value_size.positive?, "Commit rows cannot have a non-zero value_size." if chunk.commit_row
 
-          if state == NEW_ROW
+          case state
+          when NEW_ROW
             process_new_row
-          elsif state == CELL_IN_PROGRESS
+          when CELL_IN_PROGRESS
             process_cell_in_progress
-          elsif state == ROW_IN_PROGRESS
+          when ROW_IN_PROGRESS
             process_row_in_progress
           end
         end

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

@@ -129,12 +129,12 @@ module Google
           #     puts cluster.cluster_id
           #   end
           #
-          def all
+          def all &block
             return enum_for :all unless block_given?
 
             results = self
             loop do
-              results.each { |r| yield r }
+              results.each(&block)
               break unless results.next?
               results = results.next
             end

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

@@ -45,7 +45,11 @@ module Google
         ##
         # The garbage collection rule to be used for the column family.
         # Optional. The service default value will be used when not specified.
+        #
+        # @see https://cloud.google.com/bigtable/docs/garbage-collection Garbage collection
+        #
         # @return [Google::Cloud::Bigtable::GcRule, nil]
+        #
         attr_accessor :gc_rule
 
         # @private

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

@@ -222,6 +222,8 @@ module Google
         ##
         # Updates an existing column family in the table.
         #
+        # @see https://cloud.google.com/bigtable/docs/garbage-collection Garbage collection
+        #
         # @param name [String] Column family name.
         # @param gc_rule [Google::Cloud::Bigtable::GcRule] The new garbage
         #   collection rule to be used for the column family. Optional. The

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

@@ -77,6 +77,18 @@ module Google
 
           Google::Protobuf::Timestamp.new seconds: time.to_i, nanos: time.nsec
         end
+
+        ##
+        # Converts an Integer to 64-bit signed big-endian integer data.
+        # Returns a string argument unchanged.
+        #
+        # @param value [String, Integer]
+        # @return [String]
+        #
+        def integer_to_signed_be_64 value
+          return [value].pack "q>" if value.is_a? Integer
+          value
+        end
       end
     end
   end

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

@@ -28,6 +28,8 @@ module Google
       # so it is possible for reads to return a cell even if it matches the
       # active GC expression for its column family.
       #
+      # @see https://cloud.google.com/bigtable/docs/garbage-collection Garbage collection
+      #
       # GC Rule types:
       #   * `max_num_versions` - A garbage-collection rule that explicitly
       #     states the maximum number of cells to keep for all columns in a

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

@@ -509,8 +509,8 @@ module Google
         #
         #   entry = table.new_mutation_entry("user-1")
         #   entry.set_cell(
-        #     "cf-1",
-        #     "field-1",
+        #     "cf1",
+        #     "field1",
         #     "XYZ",
         #     timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
         #   ).delete_cells("cf2", "field02")
@@ -520,6 +520,7 @@ module Google
         def table table_id, view: nil, perform_lookup: nil, app_profile_id: nil
           ensure_service!
 
+          view ||= :SCHEMA_VIEW
           table = if perform_lookup
                     grpc = service.get_table instance_id, table_id, view: view
                     Table.from_grpc grpc, service, view: view

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

@@ -126,12 +126,12 @@ module Google
           #     puts instance.instance_id
           #   end
           #
-          def all
+          def all &block
             return enum_for :all unless block_given?
 
             results = self
             loop do
-              results.each { |r| yield r }
+              results.each(&block)
               break unless results.next?
               results = results.next
             end

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

@@ -15,6 +15,8 @@
 # limitations under the License.
 
 
+require "google/cloud/bigtable/convert"
+
 module Google
   module Cloud
     module Bigtable
@@ -84,8 +86,9 @@ module Google
         # @param qualifier [String] Column qualifier name.
         #   The qualifier of the column into which new data should be written.
         #   Can be any byte string, including an empty string.
-        # @param value [String, Integer] Cell value data.
-        #   The value to be written into the specified cell.
+        # @param value [String, Integer] Cell value data. The value to be written
+        #   into the specified cell. If the argument is an Integer, it will be
+        #   encoded as a 64-bit signed big-endian integer.
         # @param timestamp [Integer] Timestamp value in microseconds.
         #   The timestamp of the cell into which new data should be written.
         #   Use -1 for current Bigtable server time.
@@ -104,15 +107,15 @@ module Google
         # @example With timestamp.
         #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
         #   entry.set_cell(
-        #     "cf-1",
-        #     "field-1",
+        #     "cf1",
+        #     "field1",
         #     "XYZ",
         #     timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
         #   )
         #
         def set_cell family, qualifier, value, timestamp: nil
           # If value is integer, covert it to a 64-bit signed big-endian integer.
-          value = [value].pack "q>" if value.is_a? Integer
+          value = Convert.integer_to_signed_be_64 value
           options = {
             family_name:      family,
             column_qualifier: qualifier,
@@ -156,14 +159,14 @@ module Google
         #
         # @example Without timestamp range.
         #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
-        #   entry.delete_cells("cf-1", "field-1")
+        #   entry.delete_cells("cf1", "field1")
         #
         # @example With timestamp range.
         #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
         #   timestamp_micros = (Time.now.to_f * 1000000).round(-3)
         #   entry.delete_cells(
         #     "cf1",
-        #     "field-1",
+        #     "field1",
         #     timestamp_from: timestamp_micros - 5000000,
         #     timestamp_to: timestamp_micros
         #   )
@@ -172,7 +175,7 @@ module Google
         #   timestamp_micros = (Time.now.to_f * 1000000).round(-3)
         #   entry.delete_cells(
         #     "cf1",
-        #     "field-1",
+        #     "field1",
         #     timestamp_from: timestamp_micros - 5000000
         #   )
         #
@@ -201,7 +204,7 @@ module Google
         #
         # @example
         #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
-        #   entry.delete_from_family("cf-1")
+        #   entry.delete_from_family("cf1")
         #
         def delete_from_family family
           @mutations << Google::Cloud::Bigtable::V2::Mutation.new(delete_from_family: { family_name: family })

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

@@ -65,8 +65,8 @@ module Google
         #
         #   entry = table.new_mutation_entry("user-1")
         #   entry.set_cell(
-        #     "cf-1",
-        #     "field-1",
+        #     "cf1",
+        #     "field1",
         #     "XYZ",
         #     timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
         #   ).delete_cells("cf2", "field02")
@@ -219,8 +219,8 @@ module Google
         #   predicate_filter = Google::Cloud::Bigtable::RowFilter.key("user-10")
         #   on_match_mutations = Google::Cloud::Bigtable::MutationEntry.new
         #   on_match_mutations.set_cell(
-        #     "cf-1",
-        #     "field-1",
+        #     "cf1",
+        #     "field1",
         #     "XYZ",
         #     timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
         #   ).delete_cells("cf2", "field02")
@@ -335,7 +335,8 @@ module Google
         #   end
         #
         class Response
-          attr_reader :index, :status
+          attr_reader :index
+          attr_reader :status
 
           ##
           # @private Creates a MutationEntry::Response object.

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

@@ -54,7 +54,8 @@ module Google
       #   policy.roles["roles/viewer"] = ["allUsers"]
       #
       class Policy
-        attr_reader :etag, :roles
+        attr_reader :etag
+        attr_reader :roles
 
         # Creates a Policy instance.
         # @param etag [String]

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

@@ -316,18 +316,18 @@ module Google
         #
         #   table = bigtable.table("my-instance", "my-table")
         #
-        # @example Get a table with schema-only view.
+        # @example Retrieve a table with a schema-only view.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
         #
-        #   table = bigtable.table("my-instance", "my-table", perform_lookup: true, view: :SCHEMA_VIEW)
+        #   table = bigtable.table("my-instance", "my-table", perform_lookup: true)
         #   if table
         #     puts table.name
         #     puts table.column_families
         #   end
         #
-        # @example Get a table with all fields, cluster states, and column families.
+        # @example Retrieve a table with all fields, cluster states, and column families.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -342,6 +342,7 @@ module Google
         def table instance_id, table_id, view: nil, perform_lookup: nil, app_profile_id: nil
           ensure_service!
 
+          view ||= :SCHEMA_VIEW
           table = if perform_lookup
                     grpc = service.get_table instance_id, table_id, view: view
                     Table.from_grpc grpc, service, view: view

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

@@ -141,7 +141,8 @@ module Google
       #     Default value is false.
       #
       class SingleClusterRouting < RoutingPolicy
-        attr_reader :cluster_id, :allow_transactional_writes
+        attr_reader :cluster_id
+        attr_reader :allow_transactional_writes
 
         ##
         # Creates a new single-cluster routing policy.
@@ -155,6 +156,7 @@ module Google
         #   Default value is false.
         #
         def initialize cluster_id, allow_transactional_writes
+          super()
           @cluster_id = cluster_id
           @allow_transactional_writes = allow_transactional_writes
         end

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

@@ -30,7 +30,11 @@ module Google
         # Row cell built from data chunks.
         #
         class Cell
-          attr_reader :family, :qualifier, :value, :labels, :timestamp
+          attr_reader :family
+          attr_reader :qualifier
+          attr_reader :value
+          attr_reader :labels
+          attr_reader :timestamp
 
           ##
           # Creates a row cell instance.

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

@@ -15,6 +15,8 @@
 # limitations under the License.
 
 
+require "google/cloud/bigtable/convert"
+
 module Google
   module Cloud
     module Bigtable
@@ -147,10 +149,13 @@ module Google
           # will not match the new line character `\n`, which may be present in a
           # binary value.
           #
-          # @param regex [String] Regex to match cell value.
+          # @param regex [String, Integer] Regex to match cell value, or an Integer
+          #   value to be encoded as a 64-bit signed big-endian integer.
           # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
           #
           def value regex
+            # If regex is integer, covert it to a 64-bit signed big-endian integer.
+            regex = Convert.integer_to_signed_be_64 regex
             @grpc.value_regex_filter = regex
             self
           end

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

@@ -170,10 +170,10 @@ module Google
         # @return [Boolean]
         #
         def start_key_read? range
-          start_key = if !range.start_key_closed.empty?
-                        range.start_key_closed
-                      else
+          start_key = if range.start_key_closed.empty?
                         range.start_key_open
+                      else
+                        range.start_key_closed
                       end
 
           start_key.empty? || last_key >= start_key
@@ -186,10 +186,10 @@ module Google
         # @return [Boolean]
         #
         def end_key_read? range
-          end_key = if !range.end_key_closed.empty?
-                      range.end_key_closed
-                    else
+          end_key = if range.end_key_closed.empty?
                       range.end_key_open
+                    else
+                      range.end_key_closed
                     end
 
           end_key && end_key <= last_key

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

@@ -515,6 +515,47 @@ module Google
                                        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
+
         ##
         # Gets the access control policy for an instance resource. Returns an empty
         # policy if an instance exists but does not have a policy set.

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

@@ -47,7 +47,10 @@ module Google
       #   end
       #
       class Status
-        attr_reader :code, :description, :message, :details
+        attr_reader :code
+        attr_reader :description
+        attr_reader :message
+        attr_reader :details
 
         ##
         # @private Creates a Status object.

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

@@ -56,6 +56,14 @@ module Google
         # The gRPC Service object.
         attr_accessor :service
 
+        # @private
+        # The current gRPC resource, for testing only.
+        attr_accessor :grpc
+
+        # @private
+        # The current loaded_views, for testing only. See #check_view_and_load, below.
+        attr_reader :loaded_views
+
         ##
         # @return [String] App profile ID for request routing.
         #
@@ -64,10 +72,11 @@ module Google
         # @private
         #
         # Creates a new Table instance.
-        def initialize grpc, service, view: nil
+        def initialize grpc, service, view:
           @grpc = grpc
           @service = service
-          @view = view || :SCHEMA_VIEW
+          raise ArgumentError, "view must not be nil" if view.nil?
+          @loaded_views = Set[view]
         end
 
         ##
@@ -109,7 +118,8 @@ module Google
         end
 
         ##
-        # Reloads table data.
+        # Reloads table data with the provided `view`, or with `SCHEMA_VIEW`
+        # if none is provided. Previously loaded data is not retained.
         #
         # @param view [Symbol] Table view type.
         #   Default view type is `:SCHEMA_VIEW`.
@@ -123,8 +133,9 @@ module Google
         # @return [Google::Cloud::Bigtable::Table]
         #
         def reload! view: nil
-          @view = view || :SCHEMA_VIEW
+          view ||= :SCHEMA_VIEW
           @grpc = service.get_table instance_id, name, view: view
+          @loaded_views = Set[view]
           self
         end
 
@@ -133,7 +144,10 @@ module Google
         # If it could not be determined whether or not the table has data in a
         # particular cluster (for example, if its zone is unavailable), then
         # there will be an entry for the cluster with UNKNOWN `replication_status`.
-        # Views: `FULL`.
+        #
+        # Reloads the table if necessary to retrieve the cluster states data,
+        # since it is only available in a table with view type `REPLICATION_VIEW`
+        # or `FULL`. Previously loaded data is retained.
         #
         # @return [Array<Google::Cloud::Bigtable::Table::ClusterState>]
         #
@@ -146,15 +160,19 @@ module Google
 
         ##
         # Returns a frozen object containing the column families configured for
-        # the table, mapped by column family name. Reloads the table if
-        # necessary to retrieve the column families data, since it is only
-        # available in a table with view type `SCHEMA_VIEW` or `FULL`.
+        # the table, mapped by column family name.
+        #
+        # Reloads the table if necessary to retrieve the column families data,
+        # since it is only available in a table with view type `SCHEMA_VIEW`
+        # or `FULL`. Previously loaded data is retained.
         #
         # Also accepts a block for making modifications to the table's column
         # families. After the modifications are completed, the table will be
         # updated with the changes, and the updated column families will be
         # returned.
         #
+        # @see https://cloud.google.com/bigtable/docs/garbage-collection Garbage collection
+        #
         # @yield [column_families] A block for modifying the table's column
         #   families. Applies multiple column modifications. Performs a series
         #   of column family modifications on the specified table. Either all or
@@ -222,7 +240,10 @@ module Google
         # The granularity (e.g. `MILLIS`, `MICROS`) at which timestamps are stored in
         # this table. Timestamps not matching the granularity will be rejected.
         # If unspecified at creation time, the value will be set to `MILLIS`.
-        # Views: `SCHEMA_VIEW`, `FULL`.
+        #
+        # Reloads the table if necessary to retrieve the column families data,
+        # since it is only available in a table with view type `SCHEMA_VIEW`
+        # or `FULL`. Previously loaded data is retained.
         #
         # @return [Symbol]
         #
@@ -437,7 +458,7 @@ module Google
           }.delete_if { |_, v| v.nil? })
 
           grpc = service.create_table instance_id, table_id, table, initial_splits: initial_splits
-          from_grpc grpc, service
+          from_grpc grpc, service, view: :SCHEMA_VIEW
         end
 
         ##
@@ -623,7 +644,7 @@ module Google
         # @param view [Symbol] View type.
         # @return [Google::Cloud::Bigtable::Table]
         #
-        def self.from_grpc grpc, service, view: nil
+        def self.from_grpc grpc, service, view:
           new grpc, service, view: view
         end
 
@@ -664,7 +685,6 @@ module Google
         #
         def check_view_and_load view
           ensure_service!
-          @loaded_views ||= Set.new [@view]
 
           return if @loaded_views.include?(view) || @loaded_views.include?(:FULL)
 

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

@@ -114,12 +114,12 @@ module Google
           #     puts table.table_id
           #   end
           #
-          def all
+          def all &block
             return enum_for :all unless block_given?
 
             results = self
             loop do
-              results.each { |r| yield r }
+              results.each(&block)
               break unless next?
               grpc.next_page
               results = self.class.from_grpc grpc, service

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

@@ -108,7 +108,7 @@ module Google
           #   end
           #
           def table
-            Table.from_grpc results, service if results
+            Table.from_grpc results, service, view: :NAME_ONLY if results
           end
         end
       end

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

@@ -15,6 +15,8 @@
 # limitations under the License.
 
 
+require "google/cloud/bigtable/convert"
+
 module Google
   module Cloud
     module Bigtable
@@ -65,7 +67,9 @@ module Google
         ##
         # Sets the row range with the lower bound.
         #
-        # @param value [String] The value. Required.
+        # @param value [String, Integer] The value. Required. If the argument
+        #   is an Integer, it will be encoded as a 64-bit signed big-endian
+        #   integer.
         # @param inclusive [Boolean] Whether the value is an inclusive or
         #   exclusive lower bound. Default is `true`, an inclusive lower bound.
         # @return [Google::Cloud::Bigtable::ValueRange]
@@ -87,6 +91,8 @@ module Google
         #   range = table.new_value_range.from("value-001", inclusive: false)
         #
         def from value, inclusive: true
+          # If value is integer, covert it to a 64-bit signed big-endian integer.
+          value = Convert.integer_to_signed_be_64 value
           if inclusive
             @grpc.start_value_closed = value
           else
@@ -98,7 +104,9 @@ module Google
         ##
         # Sets the value range with upper bound.
         #
-        # @param value [String] value. Required
+        # @param value [String, Integer] value. Required. If the argument
+        #   is an Integer, it will be encoded as a 64-bit signed big-endian
+        #   integer.
         # @param inclusive [Boolean] Whether the value is an inclusive or
         #   exclusive lower bound. Default is `false`, an exclusive lower bound.
         # @return [Google::Cloud::Bigtable::ValueRange]
@@ -120,6 +128,8 @@ module Google
         #   range = table.new_value_range.to("value-010")
         #
         def to value, inclusive: false
+          # If value is integer, covert it to a 64-bit signed big-endian integer.
+          value = Convert.integer_to_signed_be_64 value
           if inclusive
             @grpc.end_value_closed = value
           else
@@ -131,8 +141,12 @@ module Google
         ##
         # Sets the value range with inclusive lower and upper bounds.
         #
-        # @param from_value [String] Inclusive from value. Required
-        # @param to_value [String] Inclusive to value. Required
+        # @param from_value [String, Integer] Inclusive from value. Required.
+        #   If the argument is an Integer, it will be encoded as a 64-bit
+        #   signed big-endian integer.
+        # @param to_value [String, Integer] Inclusive to value. Required.
+        #   If the argument is an Integer, it will be encoded as a 64-bit
+        #   signed big-endian integer.
         # @return [Google::Cloud::Bigtable::ValueRange]
         #   Range with inclusive from and to values.
         #
@@ -151,8 +165,12 @@ module Google
         ##
         # Set value range with an inclusive lower bound and an exclusive upper bound.
         #
-        # @param from_value [String] Inclusive from value
-        # @param to_value [String] Exclusive to value
+        # @param from_value [String, Integer] Inclusive from value. Required.
+        #   If the argument is an Integer, it will be encoded as a 64-bit
+        #   signed big-endian integer.
+        # @param to_value [String, Integer] Exclusive to value. Required.
+        #   If the argument is an Integer, it will be encoded as a 64-bit
+        #   signed big-endian integer.
         # @return [Google::Cloud::Bigtable::ValueRange]
         #   Range with an inclusive from value and an exclusive to value.
         #

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.4.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-17 00:00:00.000000000 Z
+date: 2021-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-bigtable-admin-v2
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -241,14 +241,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.13
 signing_key: 
 specification_version: 4
 summary: API Client library for Cloud Bigtable API