Using backup sets
Backup sets can ease the administration of HBase data backups and restores by reducing the amount of repetitive input of table names.
You can group tables into a named backup set with the hbase backup set
add command. You can then use the -set
option to
invoke the name of a backup set in the hbase backup create or
hbase backup restore rather than list individually every
table in the group. You can have multiple backup sets.
Note | |
---|---|
Note the differentiation between the hbase backup set add
command and the |
If you run the hbase backup set add command and specify a backup set name that does not yet exist on your system, a new set is created. If you run the command with the name of an existing backup set name, then the tables that you specify are added to the set.
In the command, the backup set name is case-sensitive.
Note | |
---|---|
The metadata of backup sets are stored within HBase. If you do not have access to the original HBase cluster with the backup set metadata, then you must specify individual table names to restore the data. |
Backup set subcommands
hbase backup set COMMAND [name] [tables]
COMMAND is one of the following:
add
remove
list
describe
delete
backup_set_name
tables
Following list details subcommands of the hbase backup set command.
Note | |
---|---|
You must enter one (and no more than one) of the following subcommands after hbase backup set to complete an operation. Also, the backup set name is case-sensitive in the command-line utility. |
- add
-
Use this subcommand to add tables to a backup set. Specify a
value after this argument to create a backup set.backup_set_name
Example of backup set addExample
- hbase backup set add Q1Data TEAM_3,TEAM_4
-
Depending on the environment, this command results in one of the following actions:
-
If the
Q1Data
backup set does not exist, a backup set containing tablesTEAM_3
andTEAM_4
is created. -
If the
Q1Data
backup set exists already, the tablesTEAM_3
andTEAM_4
are added to theQ1Data
backup set.
-
- remove
-
Use this subcommand to remove tables from a set. Specify the tables to remove in the
argument.tables
- list
-
Use this subcommand to list all backup sets.
- describe
-
Use this subcommand to display on the screen a description of a backup set. The information includes whether the set has full or incremental backups, start and end times of the backups, and a list of the tables in the set. This subcommand must precede a valid value for the
value.backup_set_name
- delete
-
Use this subcommand to delete a backup set. Enter the value for the
option directly after the hbase backup set delete command.backup_set_name
Optional command-line arguments
backup_set_name
-
Use this argument to assign or invoke a backup set name. The backup set name must contain only printable characters and cannot have any spaces.
tables
-
List of tables (or a single table) to include in the backup set. Enter the table names as a comma-separated list. If no tables are specified, all tables are included in the set.
Note | |
---|---|
Maintain a log or other record of the case-sensitive backup set names and the corresponding tables in each set on a separate or remote cluster, mirroring your backup strategy. This information can help you in case of failure on the primary cluster. |