Using Apache HBase to store and access data
Also available as:
loading table of contents...

Restore a backup image

You can perform restore operation to restore a backup image. You can only restore on a live HBase cluster because the data must be redistributed to the RegionServers to complete the restore operation successfully.

  • Run the hbase restore command as hbase superuser to restore a backup image.
hbase restore /tmp/backup_incremental backupId_1467823988425 -t mytable1,mytable2
This command restores two tables of an incremental backup image. In this example:
  • /tmp/backup_incremental is the path to the directory containing the backup image.
  • backupId_1467823988425 is the backup ID.
  • mytable1 and mytable2 are the names of the tables in the backup image to be restored.

Command for restoring backup image

Use hbase restore command as hbase superuser to restore a backup image.
hbase restore <backup_path> <backup_id> [options]

Required command-line arguments


It specifies the path to a backup destination root, which is the full filesystem URI of where to store the backup image. Valid prefixes are hdfs:, webhdfs:, gpfs:, and s3fs:.


The backup ID that uniquely identifies the backup image to be restored.

Optional command-line arguments


It checks the restore sequence and dependencies only, however it is not executed. It performs a dry-run of the restore.


It enables debug loggings.

-m <arg>

A comma-separated list of target tables to restore into.


Overwrite the data, if any of the restore target tables exists.

-q <arg>

It allows you to specify the Yarn queue name to run the backup restore command on.

-t <arg>

A comma-separated list of tables to restore. The values for this argument must be entered directly after the backupId argument.

-s <arg>

It specifies Backup set to restore. It is mutually exclusive with the -t (table list) option.


It shows the usage of the restore command.