gcloud: Fri Jun 2 10:25:45 UTC 2023

gcloud/alpha/bigtable/instances/tables/update

@@ -4,7 +4,9 @@ NAME
 
 SYNOPSIS
     gcloud alpha bigtable instances tables update (TABLE : --instance=INSTANCE)
-        [--async] [--deletion-protection] [GCLOUD_WIDE_FLAG ...]
+        [--async] [--deletion-protection]
+        [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
+          | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Update an existing new Cloud Bigtable table with the specified
@@ -21,6 +23,17 @@ EXAMPLES
         $ gcloud alpha bigtable instances tables update my-table \
             --instance=my-instance --no-deletion-protection
 
+    To enable a change stream with a retention period of 1 day, or to update
+    your table's change stream retention period to 1 day, run:
+
+        $ gcloud alpha bigtable instances tables update my-table \
+            --instance=my-instance --change-stream-retention-period=1d
+
+    To disable a change stream, run:
+
+        $ gcloud alpha bigtable instances tables update my-table \
+            --instance=my-instance --clear-change-stream-retention-period
+
 POSITIONAL ARGUMENTS
      Table resource - Cloud Bigtable table to update. The arguments in this
      group can be used to specify the attributes of this resource. (NOTE) Some
@@ -60,6 +73,18 @@ FLAGS
      --deletion-protection
         Once specified, the table is deletion protected.
 
+     At most one of these can be specified:
+
+       --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
+          The length of time to retain change stream data for the table, in the
+          range of [1 day, 7 days]. Acceptable units are days (d), hours (h),
+          minutes (m), and seconds (s). If not already specified, enables a
+          change stream for the table. Examples: 5d or 48h.
+
+       --clear-change-stream-retention-period
+          This disables the change stream and eventually removes the change
+          stream data within your retention period.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,