gcloud bigtable tables restore

NAME
gcloud bigtable tables restore - restore a Cloud Bigtable backup to a new table
SYNOPSIS
gcloud bigtable tables restore(--destination=DESTINATION :--destination-instance=DESTINATION_INSTANCE)(--source=SOURCE :--source-cluster=SOURCE_CLUSTER--source-instance=SOURCE_INSTANCE)[--async][GCLOUD_WIDE_FLAG]
DESCRIPTION
This command restores a Cloud Bigtable backup to a new table.
EXAMPLES
To restore table 'table2' from backup 'backup1', run:
gcloudbigtabletablesrestore--source-instance=instance1--source-cluster=cluster1--source=backup1--destination-instance=instance1--destination=table2

To restore table 'table2' from backup 'backup1' in a different project, run:

gcloudbigtabletablesrestore--source=projects/project1/instances/instance1/clusters/cluster1/backups/backup1--destination=projects/project2/instances/instance2/tables/table2
REQUIRED FLAGS
Table resource - The destination to restore to. The arguments in this group canbe used to specify the attributes of this resource. (NOTE) Some attributes arenot given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--destination on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

--destination=DESTINATION
ID of the table or fully qualified identifier for the table.

To set thedestination attribute:

  • provide the argument--destination on the command line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--destination-instance=DESTINATION_INSTANCE
Name of the Bigtable instance.

To set theinstance attribute:

  • provide the argument--destination on the command line with a fullyspecified name;
  • provide the argument--destination-instance on the command line;
  • provide the argument--source-instance on the command line.
Backup resource - The source to restore from. The arguments in this group can beused to specify the attributes of this resource. (NOTE) Some attributes are notgiven arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--source on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

--source=SOURCE
ID of the backup or fully qualified identifier for the backup.

To set thesource attribute:

  • provide the argument--source on the command line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--source-cluster=SOURCE_CLUSTER
Name of the Bigtable cluster.

To set thecluster attribute:

  • provide the argument--source on the command line with a fullyspecified name;
  • provide the argument--source-cluster on the command line.
--source-instance=SOURCE_INSTANCE
Name of the Bigtable instance.

To set theinstance attribute:

  • provide the argument--source on the command line with a fullyspecified name;
  • provide the argument--source-instance on the command line;
  • provide the argument--destination-instance on the command line.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
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.

NOTES
These variants are also available:
gcloudalphabigtabletablesrestore
gcloudbetabigtabletablesrestore

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-15 UTC.