google-cloud-bigtable-admin-v2 1.6.0 → 1.8.0

data/lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin/paths.rb

@@ -118,6 +118,44 @@ module Google
                 "projects/#{project}/locations/#{location}"
               end
 
+              ##
+              # Create a fully-qualified LogicalView resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/instances/{instance}/logicalViews/{logical_view}`
+              #
+              # @param project [String]
+              # @param instance [String]
+              # @param logical_view [String]
+              #
+              # @return [::String]
+              def logical_view_path project:, instance:, logical_view:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "instance cannot contain /" if instance.to_s.include? "/"
+
+                "projects/#{project}/instances/#{instance}/logicalViews/#{logical_view}"
+              end
+
+              ##
+              # Create a fully-qualified MaterializedView resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`
+              #
+              # @param project [String]
+              # @param instance [String]
+              # @param materialized_view [String]
+              #
+              # @return [::String]
+              def materialized_view_path project:, instance:, materialized_view:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "instance cannot contain /" if instance.to_s.include? "/"
+
+                "projects/#{project}/instances/#{instance}/materializedViews/#{materialized_view}"
+              end
+
               ##
               # Create a fully-qualified Project resource string.
               #

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin/client.rb

@@ -703,7 +703,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
               #
-              # @overload update_table(table: nil, update_mask: nil)
+              # @overload update_table(table: nil, update_mask: nil, ignore_warnings: nil)
               #   Pass arguments to `update_table` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -721,9 +721,12 @@ module Google
               #     * `change_stream_config`
               #     * `change_stream_config.retention_period`
               #     * `deletion_protection`
+              #     * `row_key_schema`
               #
               #     If `column_families` is set in `update_mask`, it will return an
               #     UNIMPLEMENTED error.
+              #   @param ignore_warnings [::Boolean]
+              #     Optional. If true, ignore safety checks when updating the table.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Gapic::Operation]

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin/helpers.rb

@@ -14,6 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+require "gapic/common/polling_harness"
 
 module Google
   module Cloud
@@ -103,6 +104,56 @@ module Google
                    "To suppress this warning, explicitly clear GcRule##{last} to nil first."
             end
           end
+
+          module BigtableTableAdmin
+            class Client # rubocop:disable Style/Documentation
+              ##
+              # Wait until the given table consistently reflects mutations up
+              # to this point.
+              #
+              # @param name [String] The table name, in the form
+              #     `projects/{project}/instances/{instance}/tables/{table}`.
+              # @param consistency_token [String] A consistency token
+              #     identifying the mutations to be checked. If not provided,
+              #     one is generated automatically.
+              # @param retry_policy [Gapic::Common::RetryPolicy] A retry policy.
+              #     If not provided, uses the given initial_delay, max_delay,
+              #     multipler, timeout, and retry_codes.
+              # @param initial_delay [Numeric] Initial delay in seconds.
+              #     Defaults to 1.
+              # @param max_delay [Numeric] Maximum delay in seconds.
+              #     Defaults to 15.
+              # @param multiplier [Numeric] The delay scaling factor for each
+              #     subsequent retry attempt. Defaults to 1.3.
+              # @param retry_codes [Array<String|Integer>] List of retry codes.
+              # @param timeout [Numeric] Timeout threshold value in seconds.
+              #     Defaults to 3600 (1 hour).
+              #
+              # @return [nil] If the table is now consistent.
+              # @return [String] The consistency token if the wait timed out.
+              #     The returned token can be passed into another call to wait
+              #     again for the same mutation set.
+              #
+              def wait_for_replication name, consistency_token: nil,
+                                       retry_policy: nil,
+                                       initial_delay: nil,
+                                       max_delay: nil,
+                                       multiplier: nil,
+                                       retry_codes: nil,
+                                       timeout: nil,
+                                       mock_delay: false
+                consistency_token ||= generate_consistency_token(name: name).consistency_token
+                poller = Gapic::Common::PollingHarness.new retry_policy: retry_policy,
+                                                           initial_delay: initial_delay, max_delay: max_delay,
+                                                           multiplier: multiplier, retry_codes: retry_codes,
+                                                           timeout: timeout
+                poller.wait timeout_result: consistency_token, wait_sentinel: :wait, mock_delay: mock_delay do
+                  response = check_consistency name: name, consistency_token: consistency_token
+                  response.consistent ? nil : :wait
+                end
+              end
+            end
+          end
         end
       end
     end

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

@@ -22,7 +22,7 @@ module Google
     module Bigtable
       module Admin
         module V2
-          VERSION = "1.6.0"
+          VERSION = "1.8.0"
         end
       end
     end

data/proto_docs/google/api/client.rb

@@ -221,6 +221,12 @@ module Google
       #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
       #     enabled by default 1 month after launching the feature in preview
       #     packages.
+      # @!attribute [rw] unversioned_package_disabled
+      #   @return [::Boolean]
+      #     Disables generation of an unversioned Python package for this client
+      #     library. This means that the module names will need to be versioned in
+      #     import statements. For example `import google.cloud.library_v2` instead
+      #     of `import google.cloud.library`.
       class ExperimentalFeatures
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -409,6 +415,14 @@ module Google
     #   @return [::Array<::String>]
     #     An allowlist of the fully qualified names of RPCs that should be included
     #     on public client surfaces.
+    # @!attribute [rw] generate_omitted_as_internal
+    #   @return [::Boolean]
+    #     Setting this to true indicates to the client generators that methods
+    #     that would be excluded from the generation should instead be generated
+    #     in a way that indicates these methods should not be consumed by
+    #     end users. How this is expressed is up to individual language
+    #     implementations to decide. Some examples may be: added annotations,
+    #     obfuscated identifiers, or other language idiomatic patterns.
     class SelectiveGapicGeneration
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/bigtable/admin/v2/bigtable_instance_admin.rb

@@ -42,7 +42,6 @@ module Google
           #     cluster ID, e.g., just `mycluster` rather than
           #     `projects/myproject/instances/myinstance/clusters/mycluster`.
           #     Fields marked `OutputOnly` must be left blank.
-          #     Currently, at most four clusters can be specified.
           class CreateInstanceRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -506,6 +505,261 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Request message for BigtableInstanceAdmin.CreateLogicalView.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The parent instance where this logical view will be created.
+          #     Format: `projects/{project}/instances/{instance}`.
+          # @!attribute [rw] logical_view_id
+          #   @return [::String]
+          #     Required. The ID to use for the logical view, which will become the final
+          #     component of the logical view's resource name.
+          # @!attribute [rw] logical_view
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::LogicalView]
+          #     Required. The logical view to create.
+          class CreateLogicalViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The metadata for the Operation returned by CreateLogicalView.
+          # @!attribute [rw] original_request
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::CreateLogicalViewRequest]
+          #     The request that prompted the initiation of this CreateLogicalView
+          #     operation.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this operation started.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation finished or was canceled.
+          class CreateLogicalViewMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.GetLogicalView.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The unique name of the requested logical view. Values are of the
+          #     form `projects/{project}/instances/{instance}/logicalViews/{logical_view}`.
+          class GetLogicalViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.ListLogicalViews.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The unique name of the instance for which the list of logical
+          #     views is requested. Values are of the form
+          #     `projects/{project}/instances/{instance}`.
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     Optional. The maximum number of logical views to return. The service may
+          #     return fewer than this value
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     Optional. A page token, received from a previous `ListLogicalViews` call.
+          #     Provide this to retrieve the subsequent page.
+          #
+          #     When paginating, all other parameters provided to `ListLogicalViews` must
+          #     match the call that provided the page token.
+          class ListLogicalViewsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for BigtableInstanceAdmin.ListLogicalViews.
+          # @!attribute [rw] logical_views
+          #   @return [::Array<::Google::Cloud::Bigtable::Admin::V2::LogicalView>]
+          #     The list of requested logical views.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     A token, which can be sent as `page_token` to retrieve the next page.
+          #     If this field is omitted, there are no subsequent pages.
+          class ListLogicalViewsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.UpdateLogicalView.
+          # @!attribute [rw] logical_view
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::LogicalView]
+          #     Required. The logical view to update.
+          #
+          #     The logical view's `name` field is used to identify the view to update.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/logicalViews/{logical_view}`.
+          # @!attribute [rw] update_mask
+          #   @return [::Google::Protobuf::FieldMask]
+          #     Optional. The list of fields to update.
+          class UpdateLogicalViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The metadata for the Operation returned by UpdateLogicalView.
+          # @!attribute [rw] original_request
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::UpdateLogicalViewRequest]
+          #     The request that prompted the initiation of this UpdateLogicalView
+          #     operation.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this operation was started.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation finished or was canceled.
+          class UpdateLogicalViewMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.DeleteLogicalView.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The unique name of the logical view to be deleted.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/logicalViews/{logical_view}`.
+          # @!attribute [rw] etag
+          #   @return [::String]
+          #     Optional. The current etag of the logical view.
+          #     If an etag is provided and does not match the current etag of the
+          #     logical view, deletion will be blocked and an ABORTED error will be
+          #     returned.
+          class DeleteLogicalViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.CreateMaterializedView.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The parent instance where this materialized view will be created.
+          #     Format: `projects/{project}/instances/{instance}`.
+          # @!attribute [rw] materialized_view_id
+          #   @return [::String]
+          #     Required. The ID to use for the materialized view, which will become the
+          #     final component of the materialized view's resource name.
+          # @!attribute [rw] materialized_view
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::MaterializedView]
+          #     Required. The materialized view to create.
+          class CreateMaterializedViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The metadata for the Operation returned by CreateMaterializedView.
+          # @!attribute [rw] original_request
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::CreateMaterializedViewRequest]
+          #     The request that prompted the initiation of this CreateMaterializedView
+          #     operation.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this operation started.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation finished or was canceled.
+          class CreateMaterializedViewMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.GetMaterializedView.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The unique name of the requested materialized view. Values are of
+          #     the form
+          #     `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`.
+          class GetMaterializedViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.ListMaterializedViews.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The unique name of the instance for which the list of
+          #     materialized views is requested. Values are of the form
+          #     `projects/{project}/instances/{instance}`.
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     Optional. The maximum number of materialized views to return. The service
+          #     may return fewer than this value
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     Optional. A page token, received from a previous `ListMaterializedViews`
+          #     call. Provide this to retrieve the subsequent page.
+          #
+          #     When paginating, all other parameters provided to `ListMaterializedViews`
+          #     must match the call that provided the page token.
+          class ListMaterializedViewsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for BigtableInstanceAdmin.ListMaterializedViews.
+          # @!attribute [rw] materialized_views
+          #   @return [::Array<::Google::Cloud::Bigtable::Admin::V2::MaterializedView>]
+          #     The list of requested materialized views.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     A token, which can be sent as `page_token` to retrieve the next page.
+          #     If this field is omitted, there are no subsequent pages.
+          class ListMaterializedViewsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.UpdateMaterializedView.
+          # @!attribute [rw] materialized_view
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::MaterializedView]
+          #     Required. The materialized view to update.
+          #
+          #     The materialized view's `name` field is used to identify the view to
+          #     update. Format:
+          #     `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`.
+          # @!attribute [rw] update_mask
+          #   @return [::Google::Protobuf::FieldMask]
+          #     Optional. The list of fields to update.
+          class UpdateMaterializedViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The metadata for the Operation returned by UpdateMaterializedView.
+          # @!attribute [rw] original_request
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::UpdateMaterializedViewRequest]
+          #     The request that prompted the initiation of this UpdateMaterializedView
+          #     operation.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this operation was started.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation finished or was canceled.
+          class UpdateMaterializedViewMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for BigtableInstanceAdmin.DeleteMaterializedView.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The unique name of the materialized view to be deleted.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`.
+          # @!attribute [rw] etag
+          #   @return [::String]
+          #     Optional. The current etag of the materialized view.
+          #     If an etag is provided and does not match the current etag of the
+          #     materialized view, deletion will be blocked and an ABORTED error will be
+          #     returned.
+          class DeleteMaterializedViewRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/bigtable/admin/v2/bigtable_table_admin.rb

@@ -261,9 +261,13 @@ module Google
           #     * `change_stream_config`
           #     * `change_stream_config.retention_period`
           #     * `deletion_protection`
+          #     * `row_key_schema`
           #
           #     If `column_families` is set in `update_mask`, it will return an
           #     UNIMPLEMENTED error.
+          # @!attribute [rw] ignore_warnings
+          #   @return [::Boolean]
+          #     Optional. If true, ignore safety checks when updating the table.
           class UpdateTableRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/bigtable/admin/v2/instance.rb

@@ -35,10 +35,9 @@ module Google
           #     Required. The descriptive name for this instance as it appears in UIs.
           #     Can be changed at any time, but should be kept globally unique
           #     to avoid confusion.
-          # @!attribute [rw] state
+          # @!attribute [r] state
           #   @return [::Google::Cloud::Bigtable::Admin::V2::Instance::State]
-          #     (`OutputOnly`)
-          #     The current state of the instance.
+          #     Output only. The current state of the instance.
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Bigtable::Admin::V2::Instance::Type]
           #     The type of the instance. Defaults to `PRODUCTION`.
@@ -57,12 +56,15 @@ module Google
           #     * Keys and values must both be under 128 bytes.
           # @!attribute [r] create_time
           #   @return [::Google::Protobuf::Timestamp]
-          #     Output only. A server-assigned timestamp representing when this Instance
-          #     was created. For instances created before this field was added (August
-          #     2021), this value is `seconds: 0, nanos: 1`.
+          #     Output only. A commit timestamp representing when this Instance was
+          #     created. For instances created before this field was added (August 2021),
+          #     this value is `seconds: 0, nanos: 1`.
           # @!attribute [r] satisfies_pzs
           #   @return [::Boolean]
           #     Output only. Reserved for future use.
+          # @!attribute [r] satisfies_pzi
+          #   @return [::Boolean]
+          #     Output only. Reserved for future use.
           class Instance
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -157,8 +159,9 @@ module Google
           #     Output only. The current state of the cluster.
           # @!attribute [rw] serve_nodes
           #   @return [::Integer]
-          #     The number of nodes allocated to this cluster. More nodes enable higher
-          #     throughput and more consistent performance.
+          #     The number of nodes in the cluster. If no value is set,
+          #     Cloud Bigtable automatically allocates nodes based on your data footprint
+          #     and optimized for 50% storage utilization.
           # @!attribute [rw] node_scaling_factor
           #   @return [::Google::Cloud::Bigtable::Admin::V2::Cluster::NodeScalingFactor]
           #     Immutable. The node scaling factor of this cluster.
@@ -208,7 +211,6 @@ module Google
             #      `cloudkms.cryptoKeyEncrypterDecrypter` role on the CMEK key.
             #      2) Only regional keys can be used and the region of the CMEK key must
             #      match the region of the cluster.
-            #      3) All clusters within an instance must use the same CMEK key.
             #     Values are of the form
             #     `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}`
             class EncryptionConfig
@@ -370,17 +372,10 @@ module Google
             end
 
             # Data Boost is a serverless compute capability that lets you run
-            # high-throughput read jobs on your Bigtable data, without impacting the
-            # performance of the clusters that handle your application traffic.
-            # Currently, Data Boost exclusively supports read-only use-cases with
-            # single-cluster routing.
-            #
-            # Data Boost reads are only guaranteed to see the results of writes that
-            # were written at least 30 minutes ago. This means newly written values may
-            # not become visible for up to 30m, and also means that old values may
-            # remain visible for up to 30m after being deleted or overwritten. To
-            # mitigate the staleness of the data, users may either wait 30m, or use
-            # CheckConsistency.
+            # high-throughput read jobs and queries on your Bigtable data, without
+            # impacting the performance of the clusters that handle your application
+            # traffic. Data Boost supports read-only use cases with single-cluster
+            # routing.
             # @!attribute [rw] compute_billing_owner
             #   @return [::Google::Cloud::Bigtable::Admin::V2::AppProfile::DataBoostIsolationReadOnly::ComputeBillingOwner]
             #     The Compute Billing Owner for this Data Boost App Profile.
@@ -451,6 +446,49 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # A SQL logical view object that can be referenced in SQL queries.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Identifier. The unique name of the logical view.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/logicalViews/{logical_view}`
+          # @!attribute [rw] query
+          #   @return [::String]
+          #     Required. The logical view's select query.
+          # @!attribute [rw] etag
+          #   @return [::String]
+          #     Optional. The etag for this logical view.
+          #     This may be sent on update requests to ensure that the client has an
+          #     up-to-date value before proceeding. The server returns an ABORTED error on
+          #     a mismatched etag.
+          class LogicalView
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A materialized view object that can be referenced in SQL queries.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Identifier. The unique name of the materialized view.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`
+          # @!attribute [rw] query
+          #   @return [::String]
+          #     Required. Immutable. The materialized view's select query.
+          # @!attribute [rw] etag
+          #   @return [::String]
+          #     Optional. The etag for this materialized view.
+          #     This may be sent on update requests to ensure that the client has an
+          #     up-to-date value before proceeding. The server returns an ABORTED error on
+          #     a mismatched etag.
+          # @!attribute [rw] deletion_protection
+          #   @return [::Boolean]
+          #     Set to true to make the MaterializedView protected against deletion.
+          class MaterializedView
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/bigtable/admin/v2/table.rb

@@ -95,6 +95,64 @@ module Google
           #   @return [::Google::Cloud::Bigtable::Admin::V2::Table::AutomatedBackupPolicy]
           #     If specified, automated backups are enabled for this table.
           #     Otherwise, automated backups are disabled.
+          # @!attribute [rw] row_key_schema
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Type::Struct]
+          #     The row key schema for this table. The schema is used to decode the raw row
+          #     key bytes into a structured format. The order of field declarations in this
+          #     schema is important, as it reflects how the raw row key bytes are
+          #     structured. Currently, this only affects how the key is read via a
+          #     GoogleSQL query from the ExecuteQuery API.
+          #
+          #     For a SQL query, the _key column is still read as raw bytes. But queries
+          #     can reference the key fields by name, which will be decoded from _key using
+          #     provided type and encoding. Queries that reference key fields will fail if
+          #     they encounter an invalid row key.
+          #
+          #     For example, if _key = "some_id#2024-04-30#\x00\x13\x00\xf3" with the
+          #     following schema:
+          #     {
+          #       fields {
+          #         field_name: "id"
+          #         type { string { encoding: utf8_bytes \\{} } }
+          #       }
+          #       fields {
+          #         field_name: "date"
+          #         type { string { encoding: utf8_bytes \\{} } }
+          #       }
+          #       fields {
+          #         field_name: "product_code"
+          #         type { int64 { encoding: big_endian_bytes \\{} } }
+          #       }
+          #       encoding { delimited_bytes { delimiter: "#" } }
+          #     }
+          #
+          #     The decoded key parts would be:
+          #       id = "some_id", date = "2024-04-30", product_code = 1245427
+          #     The query "SELECT _key, product_code FROM table" will return two columns:
+          #     /------------------------------------------------------\
+          #     |              _key                     | product_code |
+          #     | --------------------------------------|--------------|
+          #     | "some_id#2024-04-30#\x00\x13\x00\xf3" |   1245427    |
+          #     \------------------------------------------------------/
+          #
+          #     The schema has the following invariants:
+          #     (1) The decoded field values are order-preserved. For read, the field
+          #     values will be decoded in sorted mode from the raw bytes.
+          #     (2) Every field in the schema must specify a non-empty name.
+          #     (3) Every field must specify a type with an associated encoding. The type
+          #     is limited to scalar types only: Array, Map, Aggregate, and Struct are not
+          #     allowed.
+          #     (4) The field names must not collide with existing column family
+          #     names and reserved keywords "_key" and "_timestamp".
+          #
+          #     The following update operations are allowed for row_key_schema:
+          #     - Update from an empty schema to a new schema.
+          #     - Remove the existing schema. This operation requires setting the
+          #       `ignore_warnings` flag to `true`, since it might be a backward
+          #       incompatible change. Without the flag, the update request will fail with
+          #       an INVALID_ARGUMENT error.
+          #     Any other row key schema update operation (e.g. update existing schema
+          #     columns names or types) is currently unsupported.
           class Table
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods