org.apache.hadoop.hbase.client

Class HBaseBackupAdmin

java.lang.Object

org.apache.hadoop.hbase.client.HBaseBackupAdmin

All Implemented Interfaces:

Closeable, AutoCloseable, BackupAdmin

@InterfaceAudience.Private
 @InterfaceStability.Evolving
public class HBaseBackupAdmin
extends Object
implements BackupAdmin

The administrative API implementation for HBase Backup . Obtain an instance from an Admin.getBackupAdmin() and call close() afterwards.

BackupAdmin can be used to create backups, restore data from backups and for other backup-related operations.

Since:

2.0

See Also:

Admin

Method Summary

Modifier and Type	Method and Description
void	addToBackupSet(String name, TableName[] tables) Add tables to backup set command
String	backupTables(BackupRequest userRequest) Backs up given list of tables fully.
Future<String>	backupTablesAsync(BackupRequest userRequest) Backs up given list of tables fully.
void	close()
int	deleteBackups(String[] backupIds) Delete backup image command
boolean	deleteBackupSet(String name) Delete backup set command
BackupInfo	getBackupInfo(String backupId) Describe backup image command
BackupSet	getBackupSet(String name) Backup set describe command.
List<BackupInfo>	getHistory(int n) Show backup history command
int	getProgress(String backupId) Show backup progress command
List<BackupSet>	listBackupSets() Backup sets list command - list all backup sets.
void	removeFromBackupSet(String name, String[] tables) Remove tables from backup set
void	restore(RestoreRequest request) Restore backup

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getBackupInfo

public BackupInfo getBackupInfo(String backupId)
                         throws IOException

Description copied from interface: BackupAdmin

Describe backup image command

Specified by:

getBackupInfo in interface BackupAdmin

Parameters:

backupId - - backup id

Returns:

backup info

Throws:

IOException - exception

getProgress

public int getProgress(String backupId)
                throws IOException

Description copied from interface: BackupAdmin

Show backup progress command

Specified by:

getProgress in interface BackupAdmin

Parameters:

backupId - - backup id (may be null)

Returns:

backup progress (0-100%), -1 if no active sessions or session not found

Throws:

IOException - exception

deleteBackups

public int deleteBackups(String[] backupIds)
                  throws IOException

Description copied from interface: BackupAdmin

Delete backup image command

Specified by:

deleteBackups in interface BackupAdmin

Parameters:

backupIds - - backup id

Returns:

total number of deleted sessions

Throws:

IOException - exception

getHistory

public List<BackupInfo> getHistory(int n)
                            throws IOException

Description copied from interface: BackupAdmin

Show backup history command

Specified by:

getHistory in interface BackupAdmin

Parameters:

n - - last n backup sessions

Returns:

list of backup infos

Throws:

IOException - exception

listBackupSets

public List<BackupSet> listBackupSets()
                               throws IOException

Description copied from interface: BackupAdmin

Backup sets list command - list all backup sets. Backup set is a named group of tables.

Specified by:

listBackupSets in interface BackupAdmin

Returns:

all registered backup sets

Throws:

IOException - exception

getBackupSet

public BackupSet getBackupSet(String name)
                       throws IOException

Description copied from interface: BackupAdmin

Backup set describe command. Shows list of tables in this particular backup set.

Specified by:

getBackupSet in interface BackupAdmin

Parameters:

name - set name

Returns:

backup set description or null

Throws:

IOException - exception

deleteBackupSet

public boolean deleteBackupSet(String name)
                        throws IOException

Description copied from interface: BackupAdmin

Delete backup set command

Specified by:

deleteBackupSet in interface BackupAdmin

Parameters:

name - - backup set name

Returns:

true, if success, false - otherwise

Throws:

IOException - exception

addToBackupSet

public void addToBackupSet(String name,
                           TableName[] tables)
                    throws IOException

Description copied from interface: BackupAdmin

Add tables to backup set command

Specified by:

addToBackupSet in interface BackupAdmin

Parameters:

name - - name of backup set.

tables - - list of tables to be added to this set.

Throws:

IOException - exception

removeFromBackupSet

public void removeFromBackupSet(String name,
                                String[] tables)
                         throws IOException

Description copied from interface: BackupAdmin

Remove tables from backup set

Specified by:

removeFromBackupSet in interface BackupAdmin

Parameters:

name - - name of backup set.

tables - - list of tables to be removed from this set.

Throws:

IOException - exception

restore

public void restore(RestoreRequest request)
             throws IOException

Description copied from interface: BackupAdmin

Restore backup

Specified by:

restore in interface BackupAdmin

Parameters:

request - - restore request

Throws:

IOException - exception

backupTables

public String backupTables(BackupRequest userRequest)
                    throws IOException

Description copied from interface: BackupAdmin

Backs up given list of tables fully. Synchronous operation.

Specified by:

backupTables in interface BackupAdmin

Returns:

the backup Id

Throws:

IOException

backupTablesAsync

public Future<String> backupTablesAsync(BackupRequest userRequest)
                                 throws IOException

Description copied from interface: BackupAdmin

Backs up given list of tables fully. Asynchronous operation.

Specified by:

backupTablesAsync in interface BackupAdmin

Returns:

the backup Id future

Throws:

IOException