- NAME
-
- gcloud bigtable instances tables create - create a new Cloud Bigtable table
- SYNOPSIS
-
-
gcloud bigtable instances tables create
(TABLE
:--instance
=INSTANCE
)--column-families
=[COLUMN_FAMILIES
,…] [--change-stream-retention-period
=CHANGE_STREAM_RETENTION_PERIOD
] [--deletion-protection
] [--splits
=[SPLITS
,…]] [--automated-backup-retention-period
=AUTOMATED_BACKUP_RETENTION_PERIOD
|--enable-automated-backup
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
- Create a new Cloud Bigtable table.
- EXAMPLES
-
To create a table
my-table
in instancemy-instance
with a column familymy-family
, run:gcloud 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 keyscar
andkey
, run:gcloud 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 instancemy-instance
that lets data in column familymy-family1
expire after 10 days and keeps a maximum of 5 cells per column in column familymy-family-2
if the data is less than 5 days old, run:gcloud bigtable instances tables create my-table --instance=my-instance --column-families="my-family-1:maxage=10d,my-family-2:maxversions=5||maxage=5d"
To create a table
my-table
that has one column familymy-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 instancemy-instance
with a column familymy-family
, run:gcloud 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 instancemy-instance
with a column familymy-family
, run:gcloud bigtable instances tables create my-table --instance=my-instance --column-families="my-family" --no-deletion-protection
To create a table
my-table
with the default automated backup policy (retention_period=7d, frequency=1d) enabled in instancemy-instance
with a column familymy-family
, run:gcloud bigtable instances tables create my-table --instance=my-instance --column-families="my-family" --enable-automated-backup
To create a table
my-table
with a custom automated backup policy configured to retain backups for 30 days in instancemy-instance
with a column familymy-family
, run:gcloud bigtable instances tables create my-table --instance=my-instance --column-families="my-family" --automated-backup-retention_period=30d
- 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.
-
provide the argument
--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.
-
provide the argument
-
provide the argument
-
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.
- 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
-
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
or48h
. --deletion-protection
- Once specified, the table is deletion protected.
--splits
=[SPLITS
,…]-
Row keys where the table should initially be split. For example:
car,key
-
At most one of these can be specified:
--automated-backup-retention-period
=AUTOMATED_BACKUP_RETENTION_PERIOD
-
The retention period of automated backup in the format of
30d
for 30 days. Min retention period is3d
and max is90d
. Setting this flag will enable automated backup for the table. --enable-automated-backup
- Once set, enables the default automated backup policy (retention_period=7d, frequency=1d) for the table.
- 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
-
These variants are also available:
gcloud alpha bigtable instances tables create
gcloud beta bigtable instances tables create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-17 UTC.