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

backup_path: 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:.
backupId: The backup ID that uniquely identifies the backup image to be restored.

Optional command-line arguments

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

-d: It enables debug loggings.

-m <arg>: A comma-separated list of target tables to restore into.

-o: 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.

-h,--help: It shows the usage of the restore command.