gcloud: Thu Jul 20 11:47:24 UTC 2023

gcloud/bigtable/instances/tables/create

@@ -3,8 +3,9 @@ NAME
 
 SYNOPSIS
     gcloud bigtable instances tables create (TABLE : --instance=INSTANCE)
-        --column-families=[COLUMN_FAMILIES,...] [--deletion-protection]
-        [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...]
+        --column-families=[COLUMN_FAMILIES,...]
+        [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD]
+        [--deletion-protection] [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Create a new Cloud Bigtable table.
@@ -34,6 +35,15 @@ EXAMPLES
             --column-families="my-family-1:maxage=10d,my-family-2:maxversion\
         s=5||maxage=5d"
 
+    To create a table my-table that has one column family my-family that lets
+    data expire after 10 days, and to enable a change stream for the table to
+    be kept for 7 days, run:
+
+        $ gcloud bigtable instances tables create my-table \
+            --instance=my-instance \
+            --column-families="my-family:maxage=10d" \
+            --change-stream-retention-period=7d
+
     To create a deletion-protected table my-table in instance my-instance with
     a column family my-family, run:
 
@@ -87,6 +97,12 @@ REQUIRED FLAGS
         "family_1,family_2:maxage=5d&&maxversions=2,family_3:maxage=10d||maxversions=5"
 
 OPTIONAL FLAGS
+     --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). Passing in a value for this option
+        enables a change stream for the table. Examples: 5d or 48h.
+
      --deletion-protection
         Once specified, the table is deletion protected.
 

gcloud/bigtable/instances/tables/update

@@ -4,7 +4,9 @@ NAME
 
 SYNOPSIS
     gcloud 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
     Update an existing new Cloud Bigtable table with the specified
@@ -21,6 +23,17 @@ EXAMPLES
         $ gcloud 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 bigtable instances tables update my-table \
+            --instance=my-instance --change-stream-retention-period=1d
+
+    To disable a change stream, run:
+
+        $ gcloud 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.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,