gcloud: Thu Sep 8 09:21:50 UTC 2022

gcloud/alpha/bigtable/instances/tables/create

@@ -0,0 +1,109 @@
+NAME
+    gcloud alpha bigtable instances tables create - create a new Cloud Bigtable
+        table
+
+SYNOPSIS
+    gcloud alpha bigtable instances tables create (TABLE : --instance=INSTANCE)
+        --column-families=[COLUMN_FAMILIES,...]
+        [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD]
+        [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) 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 alpha 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 alpha 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 alpha 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 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 alpha bigtable instances tables create my-table \
+            --instance=my-instance \
+            --column-families="my-family:maxage=10d" \
+            --change-stream-retention-period=7d
+
+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
+     --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
+        Once a value is passed in, the Bigtable table is created with a change
+        stream enabled; the value indicates how long the replication logs are
+        kept and should be in the range of [1 day, 7 days]. For example: 5d or
+        48h
+
+     --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 alpha and might change without notice. If this
+    command fails with API permission errors despite specifying the correct
+    project, you might be trying to access an API with an invitation-only early
+    access allowlist.
+