gcloud: Thu Jan 19 00:56:33 UTC 2023

gcloud/beta/bigtable/instances/tables/create

@@ -0,0 +1,112 @@
+NAME
+    gcloud beta bigtable instances tables create - create a new Cloud Bigtable
+        table
+
+SYNOPSIS
+    gcloud beta bigtable instances tables create (TABLE : --instance=INSTANCE)
+        --column-families=[COLUMN_FAMILIES,...] [--deletion-protection]
+        [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Create a new Cloud Bigtable table.
+
+EXAMPLES
+    To create a table my-table in instance my-instance with a column family
+    my-family, run:
+
+        $ gcloud beta bigtable instances tables create my-table \
+            --instance=my-instance --column-families="my-family"
+
+    To create a table that has a column family named my-instance, a garbage
+    collection policy that lets data expire after 864,000 seconds, and initial
+    table splits on row keys car and key, run:
+
+        $ gcloud beta bigtable instances tables create my-table \
+            --instance=my-instance \
+            --column-families="my-family:maxage=864000s" --splits=car,key
+
+    To create a table my-table in instance my-instance that lets data in column
+    family my-family1 expire after 10 days and keeps a maximum of 5 cells per
+    column in column family my-family-2 if the data is less than 5 days old,
+    run:
+
+        $ gcloud beta bigtable instances tables create my-table \
+            --instance=my-instance \
+            --column-families="my-family-1:maxage=10d,my-family-2:maxversion\
+        s=5||maxage=5d"
+
+    To create a deletion-protected table my-table in instance my-instance with
+    a column family my-family, run:
+
+        $ gcloud beta bigtable instances tables create my-table \
+            --instance=my-instance --column-families="my-family" \
+            --deletion-protection
+
+    To create a table my-table without deletion protection in instance
+    my-instance with a column family my-family, run:
+
+        $ gcloud beta bigtable instances tables create my-table \
+            --instance=my-instance --column-families="my-family" \
+            --no-deletion-protection
+
+POSITIONAL ARGUMENTS
+     Table resource - Cloud Bigtable table to create. The arguments in this
+     group can be used to specify the attributes of this resource. (NOTE) Some
+     attributes are not given arguments in this group but can be set in other
+     ways. To set the project attribute:
+      ◆ provide the argument table on the command line with a fully specified
+        name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       TABLE
+          ID of the table or fully qualified identifier for the table. To set
+          the table attribute:
+          ▸ provide the argument table on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --instance=INSTANCE
+          Name of the Cloud Bigtable instance. To set the instance attribute:
+          ▸ provide the argument table on the command line with a fully
+            specified name;
+          ▸ provide the argument --instance on the command line.
+
+REQUIRED FLAGS
+     --column-families=[COLUMN_FAMILIES,...]
+        A double-quote (") wrapped list of family name and corresponding
+        garbage collection rules concatenated by :, where the rules are
+        optional. For example: \
+        "family_1,family_2:maxage=5d&&maxversions=2,family_3:maxage=10d||maxversions=5"
+
+OPTIONAL FLAGS
+     --deletion-protection
+        Once specified, the table is deletion protected.
+
+     --splits=[SPLITS,...]
+        Row keys where the table should initially be split. For example:
+        car,key
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+API REFERENCE
+    This command uses the bigtableadmin/v2 API. The full documentation for this
+    API can be found at: https://cloud.google.com/bigtable/
+
+NOTES
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud bigtable instances tables create
+
+        $ gcloud alpha bigtable instances tables create
+

gcloud/beta/bigtable/instances/tables/delete

@@ -0,0 +1,63 @@
+NAME
+    gcloud beta bigtable instances tables delete - delete a Cloud Bigtable
+        table
+
+SYNOPSIS
+    gcloud beta bigtable instances tables delete (TABLE : --instance=INSTANCE)
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Delete a Cloud Bigtable table.
+
+EXAMPLES
+    To delete the table my-table in instance my-instance, run:
+
+        $ gcloud beta bigtable instances tables delete my-table \
+            --instance=my-instance
+
+POSITIONAL ARGUMENTS
+     Table resource - Cloud Bigtable table to delete. The arguments in this
+     group can be used to specify the attributes of this resource. (NOTE) Some
+     attributes are not given arguments in this group but can be set in other
+     ways. To set the project attribute:
+      ◆ provide the argument table on the command line with a fully specified
+        name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       TABLE
+          ID of the table or fully qualified identifier for the table. To set
+          the table attribute:
+          ▸ provide the argument table on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --instance=INSTANCE
+          Name of the Cloud Bigtable instance. To set the instance attribute:
+          ▸ provide the argument table on the command line with a fully
+            specified name;
+          ▸ provide the argument --instance on the command line.
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+API REFERENCE
+    This command uses the bigtableadmin/v2 API. The full documentation for this
+    API can be found at: https://cloud.google.com/bigtable/
+
+NOTES
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud bigtable instances tables delete
+
+        $ gcloud alpha bigtable instances tables delete
+

gcloud/beta/bigtable/instances/tables/describe

@@ -58,6 +58,9 @@ FLAGS
             Only populates name and fields related to the table's replication.
          schema
             Only populates name and fields related to the table's schema.
+         stats
+            Only populates name and fields related to the table's statistics
+            (e.g. TableStats and ColumnFamilyStats).
 
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,

gcloud/beta/bigtable/instances/tables/help

@@ -18,6 +18,12 @@ COMMANDS
      add-iam-policy-binding
         (BETA) Add an IAM policy binding to a Cloud Bigtable table.
 
+     create
+        (BETA) Create a new Cloud Bigtable table.
+
+     delete
+        (BETA) Delete a Cloud Bigtable table.
+
      describe
         (BETA) Retrieve information about a table.
 
@@ -39,6 +45,9 @@ COMMANDS
      undelete
         (BETA) Undelete a previously deleted Cloud Bigtable table.
 
+     update
+        (BETA) Update an existing Cloud Bigtable table.
+
 NOTES
     This command is currently in beta and might change without notice. These
     variants are also available:

gcloud/beta/bigtable/instances/tables/restore

@@ -21,12 +21,13 @@ EXAMPLES
             --source=backup1 --destination-instance=instance1 \
             --destination=table2
 
-    To restore table 'table2' from backup 'backup1' using relative names, run:
+    To restore table 'table2' from backup 'backup1' in a different project,
+    run:
 
         $ gcloud beta bigtable instances tables restore \
             --source=projects/project1/instances/instance1/clusters/\
         cluster1/backups/backup1 \
-            --destination=projects/project1/instances/instance1/tables/\
+            --destination=projects/project2/instances/instance2/tables/\
         table2
 
 REQUIRED FLAGS

gcloud/beta/bigtable/instances/tables/update

@@ -0,0 +1,77 @@
+NAME
+    gcloud beta bigtable instances tables update - update an existing Cloud
+        Bigtable table
+
+SYNOPSIS
+    gcloud beta bigtable instances tables update (TABLE : --instance=INSTANCE)
+        [--async] [--deletion-protection] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Update an existing new Cloud Bigtable table with the specified
+    configuration.
+
+EXAMPLES
+    To enable deletion protection, run:
+
+        $ gcloud beta bigtable instances tables update my-table \
+            --instance=my-instance --deletion-protection
+
+    To disable deletion protection, run:
+
+        $ gcloud beta bigtable instances tables update my-table \
+            --instance=my-instance --no-deletion-protection
+
+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
+     attributes are not given arguments in this group but can be set in other
+     ways. To set the project attribute:
+      ◆ provide the argument table on the command line with a fully specified
+        name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       TABLE
+          ID of the table or fully qualified identifier for the table. To set
+          the table attribute:
+          ▸ provide the argument table on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --instance=INSTANCE
+          Name of the Cloud Bigtable instance. To set the instance attribute:
+          ▸ provide the argument table on the command line with a fully
+            specified name;
+          ▸ provide the argument --instance on the command line.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+     --deletion-protection
+        Once specified, the table is deletion protected.
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+API REFERENCE
+    This command uses the bigtableadmin/v2 API. The full documentation for this
+    API can be found at: https://cloud.google.com/bigtable/
+
+NOTES
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud bigtable instances tables update
+
+        $ gcloud alpha bigtable instances tables update
+