google-cloud-bigtable 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 833d4009bf7801aeea418cc20c01957beb3aa7717eae7660aef91c4afc1b09c5
-  data.tar.gz: 95a806973acd438380803a215e1fdfb3d06846b66363ee541419ebe7f54cb507
+  metadata.gz: 248e897a1ecfff6e758a718695514e575d1322fcbac828a6541397444b16e9b8
+  data.tar.gz: 99fcdb65b38064cb3d29b1b635bacaca9faee59e6d444b7f808c63e8153fb5f2
 SHA512:
-  metadata.gz: 7f8ba6fe01b55f0eae24961447f829ca02bb8f709ee11b75d8ec985314f673d714ebc4f71528a74da3c34911777da9cd95895c667cc74334b55fb8b786689db6
-  data.tar.gz: 131d9b4c4f58215ce1808eb721b4f8a01086df6a6b207503629d86a2200ceb8b871894b5d93d0246a69e72b87d9c2a665baf4ee02e5d278f263daef72a473c4d
+  metadata.gz: 33d0e17401be95b707762eab720867f38e568736bb5b1690c684e0afcab2f8e20ecadffe2010bb4f39e68bb93f5a16f80c6859524abd18d2adb3d848445f9c51
+  data.tar.gz: a4d2d734c852ba5f49aae0034364c70b7f1ea66ce111ce4e723fbf34a1a48bb57ab7ecba19e49359a89d40f693c4aed242703d6c0ad18307b868e9f3c9a23a47

data/AUTHENTICATION.md

@@ -55,32 +55,10 @@ code.
 
 ### Google Cloud Platform environments
 
-While running on Google Cloud Platform environments such as Google Compute
-Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
-The **Project ID** and **Credentials** and are discovered automatically. Code
-should be written as if already authenticated. Just be sure when you [set up the
-GCE instance][gce-how-to], you add the correct scopes for the APIs you want to
-access. For example:
-
-  * **All APIs**
-    * `https://www.googleapis.com/auth/cloud-platform`
-    * `https://www.googleapis.com/auth/cloud-platform.read-only`
-  * **BigQuery**
-    * `https://www.googleapis.com/auth/bigquery`
-    * `https://www.googleapis.com/auth/bigquery.insertdata`
-  * **Compute Engine**
-    * `https://www.googleapis.com/auth/compute`
-  * **Datastore**
-    * `https://www.googleapis.com/auth/datastore`
-    * `https://www.googleapis.com/auth/userinfo.email`
-  * **DNS**
-    * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
-  * **Pub/Sub**
-    * `https://www.googleapis.com/auth/pubsub`
-  * **Storage**
-    * `https://www.googleapis.com/auth/devstorage.full_control`
-    * `https://www.googleapis.com/auth/devstorage.read_only`
-    * `https://www.googleapis.com/auth/devstorage.read_write`
+When running on Google Cloud Platform (GCP), including Google Compute Engine (GCE),
+Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud Functions
+(GCF) and Cloud Run, the **Project ID** and **Credentials** and are discovered
+automatically. Code should be written as if already authenticated.
 
 ### Environment Variables
 

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Release History
 
+### 0.8.0 / 2019-11-01
+
+#### ⚠ BREAKING CHANGES
+
+* The following methods now raise Google::Cloud::Error instead of
+  Google::Gax::GaxError and/or GRPC::BadStatus:
+  * Table#mutate_row
+  * Table#read_modify_write_row
+  * Table#check_and_mutate_row
+  * Table#sample_row_keys
+
+#### Features
+
+* Raise Google::Cloud::Error from Table#mutate_row, Table#read_modify_write_row,
+  Table#check_and_mutate_row, and Table#sample_row_keys.
+
+#### Bug Fixes
+
+* Update minimum runtime dependencies
+
+#### Documentation
+
+* Update the list of GCP environments for automatic authentication
+
 ### 0.7.0 / 2019-10-22
 
 #### Features

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

@@ -19,7 +19,7 @@ module Google
   module Cloud
     module Bigtable
       # @private
-      # # RowsMutator
+      # # ChunkProcessor
       #
       # Read a chunk of data and merge it based on states and build rows and cells
       #

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

@@ -52,14 +52,6 @@ module Google
           @gc_rule = gc_rule
         end
 
-        # @private
-        # @return [Google::Bigtable::Admin::V2::ColumnFamily]
-        def to_grpc
-          grpc = Google::Bigtable::Admin::V2::ColumnFamily.new
-          grpc.gc_rule = gc_rule.to_grpc if gc_rule
-          grpc
-        end
-
         # @private
         #
         # Create a new ColumnFamily instance from a {Google::Bigtable::Admin::V2::ColumnFamily}.

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

@@ -76,7 +76,7 @@ module Google
         #   table.mutate_row(entry)
         #
         def mutate_row entry
-          client.mutate_row path, entry.row_key, entry.mutations, app_profile_id: @app_profile_id
+          service.mutate_row path, entry.row_key, entry.mutations, app_profile_id: @app_profile_id
           true
         end
 
@@ -158,7 +158,7 @@ module Google
         #   puts row.cells
         #
         def read_modify_write_row key, rules
-          res_row = client.read_modify_write_row(
+          res_row = service.read_modify_write_row(
             path,
             key,
             Array(rules).map(&:to_grpc),
@@ -243,7 +243,7 @@ module Google
         def check_and_mutate_row key, predicate, on_match: nil, otherwise: nil
           true_mutations = on_match.mutations if on_match
           false_mutations = otherwise.mutations if otherwise
-          response = client.check_and_mutate_row(
+          response = service.check_and_mutate_row(
             path,
             key,
             predicate_filter: predicate.to_grpc,
@@ -254,41 +254,6 @@ module Google
           response.predicate_matched
         end
 
-        ##
-        # Read sample row keys.
-        #
-        # Returns a sample of row keys in the table. The returned row keys will
-        # delimit contiguous sections of the table of approximately equal size. The
-        # sections can be used to break up the data for distributed tasks like
-        # MapReduces.
-        #
-        # @yieldreturn [Google::Cloud::Bigtable::SampleRowKey]
-        # @return [:yields: sample_row_key]
-        #   Yield block for each processed SampleRowKey.
-        #
-        # @example
-        #   require "google/cloud/bigtable"
-        #
-        #   bigtable = Google::Cloud::Bigtable.new
-        #   table = bigtable.table("my-instance", "my-table")
-        #
-        #   table.sample_row_keys.each do |sample_row_key|
-        #     p sample_row_key.key # user00116
-        #     p sample_row_key.offset # 805306368
-        #   end
-        #
-        def sample_row_keys
-          return enum_for :sample_row_keys unless block_given?
-
-          response = client.sample_row_keys(
-            path,
-            app_profile_id: @app_profile_id
-          )
-          response.each do |grpc|
-            yield SampleRowKey.from_grpc grpc
-          end
-        end
-
         ##
         # Create an instance of mutation_entry
         #

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

@@ -60,7 +60,7 @@ module Google
         def sample_row_keys
           return enum_for :sample_row_keys unless block_given?
 
-          response = client.sample_row_keys path, app_profile_id: @app_profile_id
+          response = service.sample_row_keys path, app_profile_id: @app_profile_id
           response.each do |grpc|
             yield SampleRowKey.from_grpc grpc
           end

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

@@ -83,14 +83,10 @@ module Google
         # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         def mutate_rows entries
-          response = @table.client.mutate_rows @table.path, entries, app_profile_id: @table.app_profile_id
+          response = @table.service.mutate_rows @table.path, entries, app_profile_id: @table.app_profile_id
           response.each_with_object [] do |res, statuses|
             statuses.concat res.entries
           end
-        rescue Google::Gax::GaxError => e
-          raise Google::Cloud::Error.from_error(e.cause)
-        rescue GRPC::BadStatus => e
-          raise Google::Cloud::Error.from_error(e)
         end
 
         ##

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

@@ -75,8 +75,9 @@ module Google
         #   Array of row or yield block for each processed row.
         #
         def read rows: nil, filter: nil, rows_limit: nil
-          response = @table.client.read_rows(
-            @table.path,
+          response = @table.service.read_rows(
+            @table.instance_id,
+            @table.table_id,
             rows:           rows,
             filter:         filter,
             rows_limit:     rows_limit,

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

@@ -640,6 +640,48 @@ module Google
           end
         end
 
+        def read_rows instance_id, table_id, app_profile_id: nil, rows: nil, filter: nil, rows_limit: nil
+          # execute is not used because error handling is in ReadOperations#read_rows
+          client.read_rows table_path(instance_id, table_id),
+                           rows:           rows,
+                           filter:         filter,
+                           rows_limit:     rows_limit,
+                           app_profile_id: app_profile_id
+        end
+
+        def sample_row_keys table_name, app_profile_id: nil
+          execute do
+            client.sample_row_keys table_name, app_profile_id: app_profile_id
+          end
+        end
+
+        def mutate_row table_name, row_key, mutations, app_profile_id: nil
+          execute do
+            client.mutate_row table_name, row_key, mutations, app_profile_id: app_profile_id
+          end
+        end
+
+        def mutate_rows table_name, entries, app_profile_id: nil
+          execute do
+            client.mutate_rows table_name, entries, app_profile_id: app_profile_id
+          end
+        end
+
+        def check_and_mutate_row table_name, row_key, app_profile_id: nil, predicate_filter: nil, true_mutations: nil,
+                                 false_mutations: nil
+          execute do
+            client.check_and_mutate_row table_name, row_key, app_profile_id: app_profile_id,
+                                        predicate_filter: predicate_filter, true_mutations: true_mutations,
+                                        false_mutations: false_mutations
+          end
+        end
+
+        def read_modify_write_row table_name, row_key, rules, app_profile_id: nil
+          execute do
+            client.read_modify_write_row table_name, row_key, rules, app_profile_id: app_profile_id
+          end
+        end
+
         ##
         # Executes the API call and wrap errors to {Google::Cloud::Error}.
         #
@@ -714,20 +756,6 @@ module Google
           Admin::V2::BigtableTableAdminClient.table_path project_id, instance_id, table_id
         end
 
-        ##
-        # Creates a formatted snapshot path.
-        #
-        # @param instance_id [String]
-        # @param cluster_id [String]
-        # @param snapshot_id [String]
-        # @return [String]
-        #   Formatted snapshot path
-        #   +projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>+
-        #
-        def snapshot_path instance_id, cluster_id, snapshot_id
-          Admin::V2::BigtableTableAdminClient.snapshot_path project_id, instance_id, cluster_id, snapshot_id
-        end
-
         ##
         # Creates a formatted app profile path.
         #

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

@@ -424,15 +424,6 @@ module Google
           status
         end
 
-        # @private
-        # Gets the data client instance.
-        #
-        # @return [Google::Cloud::Bigtable::V2::BigtableClient]
-        #
-        def client
-          service.client
-        end
-
         ##
         # Deletes all rows.
         #

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-22 00:00:00.000000000 Z
+date: 2019-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -38,6 +38,46 @@ dependencies:
     - - "~>"
       - !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'
+- !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
   requirement: !ruby/object:Gem::Requirement