google-cloud-bigtable 0.7.0 → 1.1.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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -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,13 @@ 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.
           # @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 +403,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 +451,12 @@ 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.
           # @param app_profile_id [String]
           #   This value specifies routing for replication. If not specified, the
           #   "default" application profile will be used.
@@ -529,14 +529,14 @@ 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.
           # @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/credentials.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -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
@@ -117,7 +118,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
@@ -147,7 +148,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 +157,10 @@ 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.
       # @!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 +171,26 @@ 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.
         # @!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 +202,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 +219,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 +229,7 @@ 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.
       # @!attribute [rw] predicate_filter
       #   @return [Google::Bigtable::V2::RowFilter]
       #     The filter to be applied to the contents of the specified row. Depending
@@ -259,7 +262,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 +272,10 @@ 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.
       # @!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/v2/doc/google/bigtable/v2/data.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,67 +17,19 @@ module Google
   module Rpc
     # The `Status` type defines a logical error model that is suitable for
     # different programming environments, including REST APIs and RPC APIs. It is
-    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
+    # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+    # three pieces of data: error code, error message, and error details.
     #
-    # * Simple to use and understand for most users
-    # * Flexible enough to meet unexpected needs
-    #
-    # = Overview
-    #
-    # The `Status` message contains three pieces of data: error code, error
-    # message, and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes
-    # if needed.  The error message should be a developer-facing English message
-    # that helps developers *understand* and *resolve* the error. If a localized
-    # user-facing error message is needed, put the localized message in the error
-    # details or localize it in the client. The optional error details may contain
-    # arbitrary information about the error. There is a predefined set of error
-    # detail types in the package `google.rpc` that can be used for common error
-    # conditions.
-    #
-    # = Language mapping
-    #
-    # The `Status` message is the logical representation of the error model, but it
-    # is not necessarily the actual wire format. When the `Status` message is
-    # exposed in different client libraries and different wire protocols, it can be
-    # mapped differently. For example, it will likely be mapped to some exceptions
-    # in Java, but more likely mapped to some error codes in C.
-    #
-    # = Other uses
-    #
-    # The error model and the `Status` message can be used in a variety of
-    # environments, either with or without APIs, to provide a
-    # consistent developer experience across different environments.
-    #
-    # Example uses of this error model include:
-    #
-    # * Partial errors. If a service needs to return partial errors to the client,
-    #   it may embed the `Status` in the normal response to indicate the partial
-    #   errors.
-    #
-    # * Workflow errors. A typical workflow has multiple steps. Each step may
-    #   have a `Status` message for error reporting.
-    #
-    # * Batch operations. If a client uses batch request and batch response, the
-    #   `Status` message should be used directly inside batch response, one for
-    #   each error sub-response.
-    #
-    # * Asynchronous operations. If an API call embeds asynchronous operation
-    #   results in its response, the status of those operations should be
-    #   represented directly using the `Status` message.
-    #
-    # * Logging. If some API errors are stored in logs, the message `Status` could
-    #   be used directly after any stripping needed for security/privacy reasons.
+    # You can find out more about this error model and how to work with it in the
+    # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of
-    #     {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized
-    #     by the client.
+    #     {Google::Rpc::Status#details} field, or localized by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

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"