google-cloud-bigtable 0.8.0 → 1.0.0

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

@@ -39,7 +39,8 @@ 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.
-          # @return [Symbol]
+          #
+          # @return [Symbol] The state of replication.
           #
           def replication_state
             @grpc.replication_state
@@ -49,7 +50,8 @@ module Google
           # The cluster was recently created, and the table must finish copying
           # over pre-existing data from other clusters before it can begin
           # receiving live replication updates and serving.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is initializing.
           #
           def initializing?
             replication_state == :INITIALIZING
@@ -58,7 +60,8 @@ module Google
           ##
           # The table is temporarily unable to serve
           # requests from this cluster due to planned internal maintenance.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is in planned maintenance.
           #
           def planned_maintenance?
             replication_state == :PLANNED_MAINTENANCE
@@ -67,7 +70,8 @@ module Google
           ##
           # The table is temporarily unable to serve requests from this
           # cluster due to unplanned or emergency maintenance.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is in unplanned maintenance.
           #
           def unplanned_maintenance?
             replication_state == :UNPLANNED_MAINTENANCE
@@ -77,7 +81,8 @@ module Google
           # The table can serve requests from this cluster.
           # Depending on replication delay, reads may not immediately
           # reflect the state of the table in other clusters.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is ready.
           #
           def ready?
             replication_state == :READY

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

@@ -92,11 +92,11 @@ module Google
           # over the results returned by a single API call). Use with caution.
           #
           # @yield [table] The block for accessing each table instance.
-          # @yieldparam [Table] instance The table instance object.
+          # @yieldparam [Table] table The table instance object.
           #
           # @return [Enumerator]
           #
-          # @example Iterating each instance by passing a block:
+          # @example Iterating each table by passing a block:
           #   require "google/cloud/bigtable"
           #
           #   bigtable = Google::Cloud::Bigtable.new

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

@@ -21,7 +21,7 @@ module Google
       # rubocop:disable LineLength
 
       ##
-      # # Ruby Client for Cloud Bigtable API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
+      # # Ruby Client for Cloud Bigtable API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
       #
       # [Cloud Bigtable API][Product Documentation]:
       # API for reading and writing the contents of Bigtables associated with a

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

@@ -250,7 +250,7 @@ module Google
           # ReadRowsResponse documentation for details.
           #
           # @param table_name [String]
-          #   The unique name of the table from which to read.
+          #   Required. The unique name of the table from which to read.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param app_profile_id [String]
@@ -308,7 +308,7 @@ module Google
           # mapreduces.
           #
           # @param table_name [String]
-          #   The unique name of the table from which to sample row keys.
+          #   Required. The unique name of the table from which to sample row keys.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param app_profile_id [String]
@@ -346,13 +346,16 @@ module Google
           # unchanged unless explicitly changed by `mutation`.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the mutation should be applied.
+          #   Required. The unique name of the table to which the mutation should be applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the mutation should be applied.
+          #   Required. The key of the row to which the mutation should be applied.
+          #
+          #   Classified as IDENTIFYING_ID to provide context around data accesses for
+          #   auditing systems.
           # @param mutations [Array<Google::Bigtable::V2::Mutation | Hash>]
-          #   Changes to be atomically applied to the specified row. Entries are applied
+          #   Required. Changes to be atomically applied to the specified row. Entries are applied
           #   in order, meaning that earlier mutations can be masked by later ones.
           #   Must contain at least one entry and at most 100000.
           #   A hash of the same form as `Google::Bigtable::V2::Mutation`
@@ -403,9 +406,9 @@ module Google
           # atomically.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the mutations should be applied.
+          #   Required. The unique name of the table to which the mutations should be applied.
           # @param entries [Array<Google::Bigtable::V2::MutateRowsRequest::Entry | Hash>]
-          #   The row keys and corresponding mutations to be applied in bulk.
+          #   Required. The row keys and corresponding mutations to be applied in bulk.
           #   Each entry is applied as an atomic mutation, but the entries may be
           #   applied in arbitrary order (even between entries for the same row).
           #   At least one entry must be specified, and in total the entries can
@@ -451,12 +454,15 @@ module Google
           # Mutates a row atomically based on the output of a predicate Reader filter.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the conditional mutation should be
+          #   Required. The unique name of the table to which the conditional mutation should be
           #   applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the conditional mutation should be applied.
+          #   Required. The key of the row to which the conditional mutation should be applied.
+          #
+          #   Classified as IDENTIFYING_ID to provide context around data accesses for
+          #   auditing systems.
           # @param app_profile_id [String]
           #   This value specifies routing for replication. If not specified, the
           #   "default" application profile will be used.
@@ -529,14 +535,17 @@ module Google
           # time. The method returns the new contents of all modified cells.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the read/modify/write rules should be
+          #   Required. The unique name of the table to which the read/modify/write rules should be
           #   applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the read/modify/write rules should be applied.
+          #   Required. The key of the row to which the read/modify/write rules should be applied.
+          #
+          #   Classified as IDENTIFYING_ID to provide context around data accesses for
+          #   auditing systems.
           # @param rules [Array<Google::Bigtable::V2::ReadModifyWriteRule | Hash>]
-          #   Rules specifying how the specified row's contents are to be transformed
+          #   Required. Rules specifying how the specified row's contents are to be transformed
           #   into writes. Entries are applied in order, meaning that earlier rules will
           #   affect the results of later ones.
           #   A hash of the same form as `Google::Bigtable::V2::ReadModifyWriteRule`

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

@@ -19,7 +19,7 @@ module Google
       # Request message for Bigtable.ReadRows.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table from which to read.
+      #     Required. The unique name of the table from which to read.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -42,6 +42,7 @@ module Google
       # Response message for Bigtable.ReadRows.
       # @!attribute [rw] chunks
       #   @return [Array<Google::Bigtable::V2::ReadRowsResponse::CellChunk>]
+      #     A collection of a row's contents as part of the read request.
       # @!attribute [rw] last_scanned_row_key
       #   @return [String]
       #     Optionally the server might return the row key of the last row it
@@ -60,6 +61,9 @@ module Google
         #     this CellChunk is a continuation of the same row as the previous
         #     CellChunk in the response stream, even if that CellChunk was in a
         #     previous ReadRowsResponse message.
+        #
+        #     Classified as IDENTIFYING_ID to provide context around data accesses for
+        #     auditing systems.
         # @!attribute [rw] family_name
         #   @return [Google::Protobuf::StringValue]
         #     The column family name for this chunk of data.  If this message
@@ -117,7 +121,7 @@ module Google
       # Request message for Bigtable.SampleRowKeys.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table from which to sample row keys.
+      #     Required. The unique name of the table from which to sample row keys.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -136,6 +140,9 @@ module Google
       #     Note that row keys in this list may not have ever been written to or read
       #     from, and users should therefore not make any assumptions about the row key
       #     structure that are specific to their use case.
+      #
+      #     Classified as IDENTIFYING_ID to provide context around data accesses for
+      #     auditing systems.
       # @!attribute [rw] offset_bytes
       #   @return [Integer]
       #     Approximate total storage space used by all rows in the table which precede
@@ -147,7 +154,7 @@ module Google
       # Request message for Bigtable.MutateRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the mutation should be applied.
+      #     Required. The unique name of the table to which the mutation should be applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -156,10 +163,13 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the mutation should be applied.
+      #     Required. The key of the row to which the mutation should be applied.
+      #
+      #     Classified as IDENTIFYING_ID to provide context around data accesses for
+      #     auditing systems.
       # @!attribute [rw] mutations
       #   @return [Array<Google::Bigtable::V2::Mutation>]
-      #     Changes to be atomically applied to the specified row. Entries are applied
+      #     Required. Changes to be atomically applied to the specified row. Entries are applied
       #     in order, meaning that earlier mutations can be masked by later ones.
       #     Must contain at least one entry and at most 100000.
       class MutateRowRequest; end
@@ -170,25 +180,29 @@ module Google
       # Request message for BigtableService.MutateRows.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the mutations should be applied.
+      #     Required. The unique name of the table to which the mutations should be applied.
       # @!attribute [rw] app_profile_id
       #   @return [String]
       #     This value specifies routing for replication. If not specified, the
       #     "default" application profile will be used.
       # @!attribute [rw] entries
       #   @return [Array<Google::Bigtable::V2::MutateRowsRequest::Entry>]
-      #     The row keys and corresponding mutations to be applied in bulk.
+      #     Required. The row keys and corresponding mutations to be applied in bulk.
       #     Each entry is applied as an atomic mutation, but the entries may be
       #     applied in arbitrary order (even between entries for the same row).
       #     At least one entry must be specified, and in total the entries can
       #     contain at most 100000 mutations.
       class MutateRowsRequest
+        # A mutation for a given row.
         # @!attribute [rw] row_key
         #   @return [String]
         #     The key of the row to which the `mutations` should be applied.
+        #
+        #     Classified as IDENTIFYING_ID to provide context around data accesses for
+        #     auditing systems.
         # @!attribute [rw] mutations
         #   @return [Array<Google::Bigtable::V2::Mutation>]
-        #     Changes to be atomically applied to the specified row. Mutations are
+        #     Required. Changes to be atomically applied to the specified row. Mutations are
         #     applied in order, meaning that earlier mutations can be masked by
         #     later ones.
         #     You must specify at least one mutation.
@@ -200,6 +214,7 @@ module Google
       #   @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
       #     One or more results for Entries from the batch request.
       class MutateRowsResponse
+        # The result of applying a passed mutation in the original request.
         # @!attribute [rw] index
         #   @return [Integer]
         #     The index into the original request's `entries` list of the Entry
@@ -216,7 +231,7 @@ module Google
       # Request message for Bigtable.CheckAndMutateRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the conditional mutation should be
+      #     Required. The unique name of the table to which the conditional mutation should be
       #     applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
@@ -226,7 +241,10 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the conditional mutation should be applied.
+      #     Required. The key of the row to which the conditional mutation should be applied.
+      #
+      #     Classified as IDENTIFYING_ID to provide context around data accesses for
+      #     auditing systems.
       # @!attribute [rw] predicate_filter
       #   @return [Google::Bigtable::V2::RowFilter]
       #     The filter to be applied to the contents of the specified row. Depending
@@ -259,7 +277,7 @@ module Google
       # Request message for Bigtable.ReadModifyWriteRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the read/modify/write rules should be
+      #     Required. The unique name of the table to which the read/modify/write rules should be
       #     applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
@@ -269,10 +287,13 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the read/modify/write rules should be applied.
+      #     Required. The key of the row to which the read/modify/write rules should be applied.
+      #
+      #     Classified as IDENTIFYING_ID to provide context around data accesses for
+      #     auditing systems.
       # @!attribute [rw] rules
       #   @return [Array<Google::Bigtable::V2::ReadModifyWriteRule>]
-      #     Rules specifying how the specified row's contents are to be transformed
+      #     Required. Rules specifying how the specified row's contents are to be transformed
       #     into writes. Entries are applied in order, meaning that earlier rules will
       #     affect the results of later ones.
       class ReadModifyWriteRowRequest; end

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

@@ -34,7 +34,7 @@ module Google
       #   bigtable = Google::Cloud::Bigtable.new
       #   table = bigtable.table("my-instance", "my-table")
       #
-      #   # Range that includes all row keys including "value-001" to "value-005" excluding
+      #   # Range that includes all row keys including "value-001" to "value-005" excluding.
       #   table.new_value_range.from("value-001").to("value-005")
       #
       #   # Range that includes all row keys including "value-001" up to inclusive "value-010".
@@ -46,13 +46,13 @@ module Google
       #   # Range that includes all row keys exclusive "value-001" up until end of the row keys.
       #   table.new_value_range.from("value-001", inclusive: false)
       #
-      #   # Range with unbounded from and the exclusive end "value-100"
+      #   # Range with unbounded from and the exclusive end "value-100".
       #   table.new_value_range.to("value-100")
       #
-      #   # Range that includes all row keys including from and end row keys "value-001", "value-100"
+      #   # Range that includes all row keys including from and end row keys "value-001", "value-100".
       #   table.new_value_range.between("value-001", "value-100")
       #
-      #   # Range that includes all row keys including "value-001" up until "value-100"
+      #   # Range that includes all row keys including "value-001" up until "value-100".
       #   table.new_value_range.of("value-001", "value-100")
       #
       class ValueRange
@@ -65,9 +65,9 @@ module Google
         ##
         # Sets the row range with the lower bound.
         #
-        # @param value [String] value. Required
-        # @param inclusive [String] Inclusive/Exclusive lower bound.
-        #   Default it is an inclusive lower bound.
+        # @param value [String] The value. Required.
+        # @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]
         #
         # @example Inclusive lower bound.
@@ -99,8 +99,8 @@ module Google
         # Sets the value range with upper bound.
         #
         # @param value [String] value. Required
-        # @param inclusive [String] Inclusive/Exclusive upper bound.
-        #   Default it is an exclusive upper bound.
+        # @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]
         #
         # @example Inclusive upper bound.
@@ -129,12 +129,12 @@ module Google
         end
 
         ##
-        # Sets the value range with the inclusive lower and upper bound.
+        # Sets the value range with inclusive lower and upper bounds.
         #
         # @param from_value [String] Inclusive from value. Required
-        # @param to_value [String] Inclusive end value. Required
+        # @param to_value [String] Inclusive to value. Required
         # @return [Google::Cloud::Bigtable::ValueRange]
-        #   Range with inclusive from and end value.
+        #   Range with inclusive from and to values.
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -149,11 +149,12 @@ module Google
         end
 
         ##
-        # Set value range with the inclusive lower and the exclusive upper bound.
+        # 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
         # @return [Google::Cloud::Bigtable::ValueRange]
+        #   Range with an inclusive from value and an exclusive to value.
         #
         # @example
         #   require "google/cloud/bigtable"

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigtable
-      VERSION = "0.8.0".freeze
+      VERSION = "1.0.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.8.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-01 00:00:00.000000000 Z
+date: 2019-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core