@InterfaceAudience.Private @InterfaceStability.Evolving public class HBaseAdmin extends Object implements Admin
Connection.getAdmin() to obtain an instance of Admin instead of constructing
an HBaseAdmin directly.
Connection should be an unmanaged connection obtained via
ConnectionFactory.createConnection(Configuration)
ConnectionFactory,
Connection,
Admin| 限定符和类型 | 类和说明 |
|---|---|
protected static class |
HBaseAdmin.ProcedureFuture<V>
Future that waits on a procedure result.
|
Admin.MasterSwitchType| 构造器和说明 |
|---|
HBaseAdmin(org.apache.hadoop.conf.Configuration c)
已过时。
Constructing HBaseAdmin objects manually has been deprecated.
Use
Connection.getAdmin() to obtain an instance of Admin instead. |
HBaseAdmin(Connection connection)
已过时。
Constructing HBaseAdmin objects manually has been deprecated.
Use
Connection.getAdmin() to obtain an instance of Admin instead. |
| 限定符和类型 | 方法和说明 |
|---|---|
void |
abort(String why,
Throwable e)
Abort the server or client.
|
boolean |
abortProcedure(long procId,
boolean mayInterruptIfRunning)
Abort a procedure
|
Future<Boolean> |
abortProcedureAsync(long procId,
boolean mayInterruptIfRunning)
Abort a procedure but does not block and wait for it be completely removed.
|
void |
addColumn(byte[] tableName,
HColumnDescriptor column)
Add a column to an existing table.
|
void |
addColumn(String tableName,
HColumnDescriptor column)
Add a column to an existing table.
|
void |
addColumn(TableName tableName,
HColumnDescriptor column)
Add a column to an existing table.
|
void |
assign(byte[] regionName) |
boolean |
balancer()
Invoke the balancer.
|
boolean |
balancer(boolean force)
Invoke the balancer.
|
static void |
checkHBaseAvailable(org.apache.hadoop.conf.Configuration conf)
Check to see if HBase is running.
|
List<ServerName> |
clearDeadServers(List<ServerName> servers)
Clear dead region servers from master.
|
void |
cloneSnapshot(byte[] snapshotName,
byte[] tableName)
Create a new table by cloning the snapshot content.
|
void |
cloneSnapshot(byte[] snapshotName,
TableName tableName)
Create a new table by cloning the snapshot content.
|
void |
cloneSnapshot(String snapshotName,
String tableName)
Create a new table by cloning the snapshot content.
|
void |
cloneSnapshot(String snapshotName,
TableName tableName)
Create a new table by cloning the snapshot content.
|
void |
cloneSnapshot(String snapshotName,
TableName tableName,
boolean restoreAcl)
Create a new table by cloning the snapshot content.
|
void |
close() |
void |
closeRegion(byte[] regionname,
String serverName)
Close a region.
|
void |
closeRegion(ServerName sn,
HRegionInfo hri)
Close a region.
|
void |
closeRegion(String regionname,
String serverName)
Close a region.
|
boolean |
closeRegionWithEncodedRegionName(String encodedRegionName,
String serverName)
For expert-admins.
|
void |
compact(byte[] tableNameOrRegionName)
已过时。
Use
compact(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
compact(byte[] tableNameOrRegionName,
byte[] columnFamily)
已过时。
Use
compact(org.apache.hadoop.hbase.TableName) or (byte[], byte[]) instead. |
void |
compact(String tableNameOrRegionName)
已过时。
Use
compact(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
compact(String tableOrRegionName,
String columnFamily)
已过时。
Use
compact(org.apache.hadoop.hbase.TableName) or (byte[], byte[]) instead. |
void |
compact(TableName tableName)
Compact a table.
|
void |
compact(TableName tableName,
byte[] columnFamily)
Compact a column family within a table.
|
void |
compactRegion(byte[] regionName)
Compact an individual region.
|
void |
compactRegion(byte[] regionName,
byte[] columnFamily)
Compact a column family within a region.
|
void |
compactRegionServer(ServerName sn,
boolean major)
Compact all regions on the region server
|
CoprocessorRpcChannel |
coprocessorService()
Creates and returns a
RpcChannel instance
connected to the active master. |
CoprocessorRpcChannel |
coprocessorService(ServerName sn)
Creates and returns a
RpcChannel instance
connected to the passed region server. |
void |
createNamespace(NamespaceDescriptor descriptor)
Create a new namespace
|
void |
createTable(HTableDescriptor desc)
Creates a new table.
|
void |
createTable(HTableDescriptor desc,
byte[][] splitKeys)
Creates a new table with an initial set of empty regions defined by the
specified split keys.
|
void |
createTable(HTableDescriptor desc,
byte[] startKey,
byte[] endKey,
int numRegions)
Creates a new table with the specified number of regions.
|
void |
createTableAsync(HTableDescriptor desc,
byte[][] splitKeys)
Creates a new table but does not block and wait for it to come online.
|
void |
deleteColumn(byte[] tableName,
String columnName)
Delete a column from a table.
|
void |
deleteColumn(String tableName,
String columnName)
Delete a column from a table.
|
void |
deleteColumn(TableName tableName,
byte[] columnName)
Delete a column from a table.
|
void |
deleteNamespace(String name)
Delete an existing namespace.
|
void |
deleteSnapshot(byte[] snapshotName)
Delete an existing snapshot.
|
void |
deleteSnapshot(String snapshotName)
Delete an existing snapshot.
|
void |
deleteSnapshots(Pattern pattern)
Delete existing snapshots whose names match the pattern passed.
|
void |
deleteSnapshots(String regex)
Delete existing snapshots whose names match the pattern passed.
|
void |
deleteTable(byte[] tableName) |
void |
deleteTable(String tableName) |
void |
deleteTable(TableName tableName)
Deletes a table.
|
HTableDescriptor[] |
deleteTables(Pattern pattern)
Delete tables matching the passed in pattern and wait on completion.
|
HTableDescriptor[] |
deleteTables(String regex)
Deletes tables matching the passed in pattern and wait on completion.
|
void |
deleteTableSnapshots(Pattern tableNamePattern,
Pattern snapshotNamePattern)
Delete all existing snapshots matching the given table name regular expression and snapshot
name regular expression.
|
void |
deleteTableSnapshots(String tableNameRegex,
String snapshotNameRegex)
Delete all existing snapshots matching the given table name regular expression and snapshot
name regular expression.
|
void |
disableTable(byte[] tableName) |
void |
disableTable(String tableName) |
void |
disableTable(TableName tableName)
Disable table and wait on completion.
|
void |
disableTableAsync(byte[] tableName) |
void |
disableTableAsync(String tableName) |
void |
disableTableAsync(TableName tableName)
Starts the disable of a table.
|
HTableDescriptor[] |
disableTables(Pattern pattern)
Disable tables matching the passed in pattern and wait on completion.
|
HTableDescriptor[] |
disableTables(String regex)
Disable tables matching the passed in pattern and wait on completion.
|
boolean |
enableCatalogJanitor(boolean enable)
Enable/Disable the catalog janitor
|
void |
enableTable(byte[] tableName) |
void |
enableTable(String tableName) |
void |
enableTable(TableName tableName)
Enable a table.
|
void |
enableTableAsync(byte[] tableName) |
void |
enableTableAsync(String tableName) |
void |
enableTableAsync(TableName tableName)
Brings a table on-line (enables it).
|
HTableDescriptor[] |
enableTables(Pattern pattern)
Enable tables matching the passed in pattern and wait on completion.
|
HTableDescriptor[] |
enableTables(String regex)
Enable tables matching the passed in pattern and wait on completion.
|
void |
execProcedure(String signature,
String instance,
Map<String,String> props)
Execute a distributed procedure on a cluster.
|
byte[] |
execProcedureWithRet(String signature,
String instance,
Map<String,String> props)
Execute a distributed procedure on a cluster synchronously with return data
|
void |
flush(byte[] tableNameOrRegionName)
已过时。
Use
flush(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
flush(String tableNameOrRegionName)
已过时。
Use
flush(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
flush(TableName tableName)
Flush a table.
|
void |
flushRegion(byte[] regionName)
Flush an individual region.
|
Pair<Integer,Integer> |
getAlterStatus(byte[] tableName)
Get the status of alter command - indicates how many regions have received
the updated schema Asynchronous operation.
|
Pair<Integer,Integer> |
getAlterStatus(TableName tableName)
Get the status of alter command - indicates how many regions have received
the updated schema Asynchronous operation.
|
ClusterStatus |
getClusterStatus() |
org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState |
getCompactionState(byte[] tableNameOrRegionName)
已过时。
|
org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState |
getCompactionState(String tableNameOrRegionName)
已过时。
|
org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState |
getCompactionState(TableName tableName)
Get the current compaction state of a table.
|
org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState |
getCompactionStateForRegion(byte[] regionName)
Get the current compaction state of region.
|
org.apache.hadoop.conf.Configuration |
getConfiguration() |
HConnection |
getConnection() |
long |
getLastMajorCompactionTimestamp(TableName tableName)
Get the timestamp of the last major compaction for the passed table
The timestamp of the oldest HFile resulting from a major compaction of that table,
or 0 if no such HFile could be found.
|
long |
getLastMajorCompactionTimestampForRegion(byte[] regionName)
Get the timestamp of the last major compaction for the passed region.
|
String[] |
getMasterCoprocessors()
Helper delegage to getClusterStatus().getMasterCoprocessors().
|
int |
getMasterInfoPort()
Get the info port of the current master if one is available.
|
NamespaceDescriptor |
getNamespaceDescriptor(String name)
Get a namespace descriptor by name
|
List<HRegionInfo> |
getOnlineRegions(ServerName sn)
Get all the online regions on a region server.
|
int |
getOperationTimeout() |
QuotaRetriever |
getQuotaRetriever(QuotaFilter filter)
Return a Quota Scanner to list the quotas based on the filter.
|
List<SecurityCapability> |
getSecurityCapabilities()
Return the set of supported security capabilities.
|
HTableDescriptor |
getTableDescriptor(byte[] tableName) |
HTableDescriptor |
getTableDescriptor(TableName tableName)
Method for getting the tableDescriptor
|
HTableDescriptor[] |
getTableDescriptors(List<String> names)
Get tableDescriptors
|
HTableDescriptor[] |
getTableDescriptorsByTableName(List<TableName> tableNames)
Get tableDescriptors
|
String[] |
getTableNames()
已过时。
Use
Admin.listTableNames() instead |
String[] |
getTableNames(Pattern pattern)
已过时。
Use
Admin.listTableNames(Pattern) instead. |
String[] |
getTableNames(String regex)
已过时。
Use
Admin.listTableNames(Pattern) instead. |
List<HRegionInfo> |
getTableRegions(byte[] tableName) |
List<HRegionInfo> |
getTableRegions(TableName tableName)
get the regions of a given table.
|
boolean |
isAborted()
Check if the server or client was aborted.
|
boolean |
isBalancerEnabled()
Query the state of the balancer from the Master.
|
boolean |
isCatalogJanitorEnabled()
Query on the catalog janitor state (Enabled/Disabled?)
|
boolean |
isCleanerChoreEnabled()
Query on the cleaner chore state (Enabled/Disabled?)
|
boolean |
isMasterInMaintenanceMode()
Check whether Master is in maintenance mode
|
boolean |
isMasterRunning()
已过时。
this has been deprecated without a replacement
|
boolean |
isNormalizerEnabled()
Query the current state of the region normalizer
|
boolean |
isProcedureFinished(String signature,
String instance,
Map<String,String> props)
Check the current state of the specified procedure.
|
boolean |
isSnapshotFinished(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot)
Check the current state of the passed snapshot.
|
boolean |
isSplitOrMergeEnabled(Admin.MasterSwitchType switchType)
Query the current state of the switch
|
boolean |
isTableAvailable(byte[] tableName) |
boolean |
isTableAvailable(byte[] tableName,
byte[][] splitKeys) |
boolean |
isTableAvailable(String tableName) |
boolean |
isTableAvailable(String tableName,
byte[][] splitKeys) |
boolean |
isTableAvailable(TableName tableName) |
boolean |
isTableAvailable(TableName tableName,
byte[][] splitKeys)
Use this api to check if the table has been created with the specified number of
splitkeys which was used while creating the given table.
|
boolean |
isTableDisabled(byte[] tableName) |
boolean |
isTableDisabled(String tableName) |
boolean |
isTableDisabled(TableName tableName) |
boolean |
isTableEnabled(byte[] tableName) |
boolean |
isTableEnabled(String tableName) |
boolean |
isTableEnabled(TableName tableName) |
List<ServerName> |
listDeadServers()
List dead region servers.
|
NamespaceDescriptor[] |
listNamespaceDescriptors()
List available namespace descriptors
|
ProcedureInfo[] |
listProcedures()
List procedures
|
List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> |
listSnapshots()
List completed snapshots.
|
List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> |
listSnapshots(Pattern pattern)
List all the completed snapshots matching the given pattern.
|
List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> |
listSnapshots(String regex)
List all the completed snapshots matching the given regular expression.
|
HTableDescriptor[] |
listTableDescriptorsByNamespace(String name)
Get list of table descriptors by namespace
|
TableName[] |
listTableNames()
List all of the names of userspace tables.
|
TableName[] |
listTableNames(Pattern pattern)
List all of the names of userspace tables.
|
TableName[] |
listTableNames(Pattern pattern,
boolean includeSysTables)
List all of the names of userspace tables.
|
TableName[] |
listTableNames(String regex)
List all of the names of userspace tables.
|
TableName[] |
listTableNames(String regex,
boolean includeSysTables)
List all of the names of userspace tables.
|
TableName[] |
listTableNamesByNamespace(String name)
Get list of table names by namespace
|
HTableDescriptor[] |
listTables()
List all the userspace tables.
|
HTableDescriptor[] |
listTables(Pattern pattern)
List all the userspace tables matching the given pattern.
|
HTableDescriptor[] |
listTables(Pattern pattern,
boolean includeSysTables)
List all the tables matching the given pattern.
|
HTableDescriptor[] |
listTables(String regex)
List all the userspace tables matching the given regular expression.
|
HTableDescriptor[] |
listTables(String regex,
boolean includeSysTables)
List all the tables matching the given pattern.
|
List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> |
listTableSnapshots(Pattern tableNamePattern,
Pattern snapshotNamePattern)
List all the completed snapshots matching the given table name regular expression and snapshot
name regular expression.
|
List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> |
listTableSnapshots(String tableNameRegex,
String snapshotNameRegex)
List all the completed snapshots matching the given table name regular expression and snapshot
name regular expression.
|
void |
majorCompact(byte[] tableNameOrRegionName)
已过时。
|
void |
majorCompact(byte[] tableNameOrRegionName,
byte[] columnFamily)
|
void |
majorCompact(String tableNameOrRegionName)
已过时。
|
void |
majorCompact(String tableNameOrRegionName,
String columnFamily)
|
void |
majorCompact(TableName tableName)
Major compact a table.
|
void |
majorCompact(TableName tableName,
byte[] columnFamily)
Major compact a column family within a table.
|
void |
majorCompactRegion(byte[] regionName)
Major compact a table or an individual region.
|
void |
majorCompactRegion(byte[] regionName,
byte[] columnFamily)
Major compact a column family within region.
|
void |
mergeRegions(byte[] nameOfRegionA,
byte[] nameOfRegionB,
boolean forcible)
Merge two regions.
|
void |
modifyColumn(byte[] tableName,
HColumnDescriptor descriptor)
Modify an existing column family on a table.
|
void |
modifyColumn(String tableName,
HColumnDescriptor descriptor)
Modify an existing column family on a table.
|
void |
modifyColumn(TableName tableName,
HColumnDescriptor descriptor)
Modify an existing column family on a table.
|
void |
modifyNamespace(NamespaceDescriptor descriptor)
Modify an existing namespace
|
void |
modifyTable(byte[] tableName,
HTableDescriptor htd) |
void |
modifyTable(String tableName,
HTableDescriptor htd) |
void |
modifyTable(TableName tableName,
HTableDescriptor htd)
Modify an existing table, more IRB friendly version.
|
void |
move(byte[] encodedRegionName,
byte[] destServerName)
Move the region
r to dest. |
boolean |
normalize()
Invoke region normalizer.
|
void |
offline(byte[] regionName)
Offline specified region from master's in-memory state.
|
void |
restoreSnapshot(byte[] snapshotName)
Restore the specified snapshot on the original table.
|
void |
restoreSnapshot(byte[] snapshotName,
boolean takeFailSafeSnapshot)
Restore the specified snapshot on the original table.
|
void |
restoreSnapshot(String snapshotName)
Restore the specified snapshot on the original table.
|
void |
restoreSnapshot(String snapshotName,
boolean takeFailSafeSnapshot)
Restore the specified snapshot on the original table.
|
void |
restoreSnapshot(String snapshotName,
boolean takeFailSafeSnapshot,
boolean restoreAcl)
Restore the specified snapshot on the original table.
|
byte[][] |
rollHLogWriter(String serverName)
已过时。
|
void |
rollWALWriter(ServerName serverName)
Roll the log writer.
|
int |
runCatalogScan()
Ask for a scan of the catalog table
|
boolean |
runCleanerChore()
Ask for cleaner chore to run
|
boolean |
setBalancerRunning(boolean on,
boolean synchronous)
Turn the load balancer on or off.
|
boolean |
setCleanerChoreRunning(boolean on)
Enable/Disable the cleaner chore
|
boolean |
setNormalizerRunning(boolean on)
Turn region normalizer on or off.
|
void |
setQuota(QuotaSettings quota)
Apply the new quota settings.
|
boolean[] |
setSplitOrMergeEnabled(boolean enabled,
boolean synchronous,
Admin.MasterSwitchType... switchTypes)
Turn the Split or Merge switches on or off.
|
void |
shutdown()
Shuts down the HBase cluster
|
void |
snapshot(byte[] snapshotName,
byte[] tableName) |
void |
snapshot(byte[] snapshotName,
byte[] tableName,
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type flushType)
Create snapshot for the given table of given flush type.
|
void |
snapshot(byte[] snapshotName,
TableName tableName)
public void snapshot(final String snapshotName,
Create a timestamp consistent snapshot for the given table.
|
void |
snapshot(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot)
Take a snapshot and wait for the server to complete that snapshot (blocking).
|
void |
snapshot(String snapshotName,
byte[] tableName,
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type) |
void |
snapshot(String snapshotName,
String tableName) |
void |
snapshot(String snapshotName,
String tableName,
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type) |
void |
snapshot(String snapshotName,
TableName tableName)
Take a snapshot for the given table.
|
void |
snapshot(String snapshotName,
TableName tableName,
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type)
Create typed snapshot of the table.
|
void |
split(byte[] tableNameOrRegionName)
已过时。
Use
split(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
split(byte[] tableNameOrRegionName,
byte[] splitPoint)
已过时。
|
void |
split(ServerName sn,
HRegionInfo hri,
byte[] splitPoint) |
void |
split(String tableNameOrRegionName)
已过时。
Use
split(org.apache.hadoop.hbase.TableName) or (byte[]) instead. |
void |
split(String tableNameOrRegionName,
String splitPoint)
已过时。
|
void |
split(TableName tableName)
Split a table.
|
void |
split(TableName tableName,
byte[] splitPoint)
Split a table.
|
void |
splitRegion(byte[] regionName)
Split an individual region.
|
void |
splitRegion(byte[] regionName,
byte[] splitPoint)
Split an individual region.
|
void |
stopMaster()
Shuts down the current HBase master only.
|
void |
stopRegionServer(String hostnamePort)
Stop the designated regionserver
|
boolean |
tableExists(byte[] tableName) |
boolean |
tableExists(String tableName) |
boolean |
tableExists(TableName tableName) |
org.apache.hadoop.hbase.protobuf.generated.MasterProtos.SnapshotResponse |
takeSnapshotAsync(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot)
Take a snapshot without waiting for the server to complete that snapshot (asynchronous)
Only a single snapshot should be taken at a time, or results may be undefined.
|
void |
truncateTable(TableName tableName,
boolean preserveSplits)
Truncate a table.
|
void |
unassign(byte[] regionName,
boolean force)
Unassign a region from current hosting regionserver.
|
void |
updateConfiguration()
Update the configuration and trigger an online config change
on all the regionservers
|
void |
updateConfiguration(ServerName server)
Update the configuration and trigger an online config change
on the regionserver
|
@Deprecated public HBaseAdmin(org.apache.hadoop.conf.Configuration c) throws MasterNotRunningException, ZooKeeperConnectionException, IOException
Connection.getAdmin() to obtain an instance of Admin instead.HBaseAdmin(Connection connection)c - Configuration object. Copied internally.MasterNotRunningExceptionZooKeeperConnectionExceptionIOException@Deprecated public HBaseAdmin(Connection connection) throws MasterNotRunningException, ZooKeeperConnectionException
Connection.getAdmin() to obtain an instance of Admin instead.connection - The Connection instance to useMasterNotRunningExceptionZooKeeperConnectionException - are not
thrown anymore but kept into the interface for backward api compatibilitypublic int getOperationTimeout()
getOperationTimeout 在接口中 Adminpublic boolean isAborted()
Abortablepublic boolean abortProcedure(long procId,
boolean mayInterruptIfRunning)
throws IOException
abortProcedure 在接口中 AdminprocId - ID of the procedure to abortmayInterruptIfRunning - if the proc completed at least one step, should it be aborted?IOExceptionpublic Future<Boolean> abortProcedureAsync(long procId, boolean mayInterruptIfRunning) throws IOException
abortProcedureAsync 在接口中 AdminprocId - ID of the procedure to abortmayInterruptIfRunning - if the proc completed at least one step, should it be aborted?IOExceptionpublic HConnection getConnection()
getConnection 在接口中 Admin@Deprecated public boolean isMasterRunning() throws MasterNotRunningException, ZooKeeperConnectionException
ZooKeeperConnectionExceptionMasterNotRunningExceptionpublic boolean tableExists(TableName tableName) throws IOException
tableExists 在接口中 AdmintableName - Table to check.IOExceptionpublic boolean tableExists(byte[] tableName)
throws IOException
IOExceptionpublic boolean tableExists(String tableName) throws IOException
IOExceptionpublic HTableDescriptor[] listTables() throws IOException
AdminlistTables 在接口中 AdminIOException - if a remote or network exception occurspublic HTableDescriptor[] listTables(Pattern pattern) throws IOException
AdminlistTables 在接口中 Adminpattern - The compiled regular expression to match againstIOException - if a remote or network exception occursAdmin.listTables()public HTableDescriptor[] listTables(String regex) throws IOException
AdminlistTables 在接口中 Adminregex - The regular expression to match againstIOException - if a remote or network exception occursAdmin.listTables(java.util.regex.Pattern)public HTableDescriptor[] listTables(Pattern pattern, boolean includeSysTables) throws IOException
AdminlistTables 在接口中 Adminpattern - The compiled regular expression to match againstincludeSysTables - False to match only against userspace tablesIOException - if a remote or network exception occursAdmin.listTables()public HTableDescriptor[] listTables(String regex, boolean includeSysTables) throws IOException
AdminlistTables 在接口中 Adminregex - The regular expression to match againstincludeSysTables - False to match only against userspace tablesIOException - if a remote or network exception occursAdmin.listTables(java.util.regex.Pattern, boolean)@Deprecated public String[] getTableNames() throws IOException
Admin.listTableNames() insteadIOException - if a remote or network exception occurs@Deprecated public String[] getTableNames(Pattern pattern) throws IOException
Admin.listTableNames(Pattern) instead.pattern - The regular expression to match againstIOException - if a remote or network exception occurs@Deprecated public String[] getTableNames(String regex) throws IOException
Admin.listTableNames(Pattern) instead.regex - The regular expression to match againstIOException - if a remote or network exception occurspublic TableName[] listTableNames() throws IOException
AdminlistTableNames 在接口中 AdminIOException - if a remote or network exception occurspublic TableName[] listTableNames(Pattern pattern) throws IOException
AdminlistTableNames 在接口中 Adminpattern - The regular expression to match againstIOException - if a remote or network exception occurspublic TableName[] listTableNames(String regex) throws IOException
AdminlistTableNames 在接口中 Adminregex - The regular expression to match againstIOException - if a remote or network exception occurspublic TableName[] listTableNames(Pattern pattern, boolean includeSysTables) throws IOException
AdminlistTableNames 在接口中 Adminpattern - The regular expression to match againstincludeSysTables - False to match only against userspace tablesIOException - if a remote or network exception occurspublic TableName[] listTableNames(String regex, boolean includeSysTables) throws IOException
AdminlistTableNames 在接口中 Adminregex - The regular expression to match againstincludeSysTables - False to match only against userspace tablesIOException - if a remote or network exception occurspublic HTableDescriptor getTableDescriptor(TableName tableName) throws TableNotFoundException, IOException
getTableDescriptor 在接口中 AdmintableName - as a byte []TableNotFoundExceptionIOException - if a remote or network exception occurspublic HTableDescriptor getTableDescriptor(byte[] tableName) throws TableNotFoundException, IOException
public void createTable(HTableDescriptor desc) throws IOException
createTable 在接口中 Admindesc - table descriptor for tableIllegalArgumentException - if the table name is reservedMasterNotRunningException - if master is not runningTableExistsException - if table already exists (If concurrent
threads, the table may have been created between test-for-existence
and attempt-at-creation).IOException - if a remote or network exception occurspublic void createTable(HTableDescriptor desc, byte[] startKey, byte[] endKey, int numRegions) throws IOException
createTable 在接口中 Admindesc - table descriptor for tablestartKey - beginning of key rangeendKey - end of key rangenumRegions - the total number of regions to createIllegalArgumentException - if the table name is reservedMasterNotRunningException - if master is not runningTableExistsException - if table already exists (If concurrent
threads, the table may have been created between test-for-existence
and attempt-at-creation).IOExceptionpublic void createTable(HTableDescriptor desc, byte[][] splitKeys) throws IOException
createTable 在接口中 Admindesc - table descriptor for tablesplitKeys - array of split keys for the initial regions of the tableIllegalArgumentException - if the table name is reserved, if the split keys
are repeated and if the split key has empty byte array.MasterNotRunningException - if master is not runningTableExistsException - if table already exists (If concurrent
threads, the table may have been created between test-for-existence
and attempt-at-creation).IOExceptionpublic void createTableAsync(HTableDescriptor desc, byte[][] splitKeys) throws IOException
isTableAvailable(org.apache.hadoop.hbase.TableName) -- it is not safe to create an HTable
instance to this table before it is available.
Note : Avoid passing empty split key.createTableAsync 在接口中 Admindesc - table descriptor for tableIllegalArgumentException - Bad table name, if the split keys
are repeated and if the split key has empty byte array.MasterNotRunningException - if master is not runningTableExistsException - if table already exists (If concurrent
threads, the table may have been created between test-for-existence
and attempt-at-creation).IOExceptionpublic void deleteTable(String tableName) throws IOException
IOExceptionpublic void deleteTable(byte[] tableName)
throws IOException
IOExceptionpublic void deleteTable(TableName tableName) throws IOException
deleteTable 在接口中 AdmintableName - name of table to deleteIOException - if a remote or network exception occurspublic HTableDescriptor[] deleteTables(String regex) throws IOException
listTables(java.lang.String) and
deleteTable(byte[])deleteTables 在接口中 Adminregex - The regular expression to match table names againstIOExceptiondeleteTables(java.util.regex.Pattern),
deleteTable(java.lang.String)public HTableDescriptor[] deleteTables(Pattern pattern) throws IOException
listTables(java.util.regex.Pattern) and
deleteTable(byte[])deleteTables 在接口中 Adminpattern - The pattern to match table names againstIOExceptionpublic void truncateTable(TableName tableName, boolean preserveSplits) throws IOException
truncateTable 在接口中 AdmintableName - name of table to truncatepreserveSplits - True if the splits should be preservedIOException - if a remote or network exception occurspublic void enableTable(TableName tableName) throws IOException
enableTableAsync(byte[])
and isTableEnabled(byte[]) instead.
The table has to be in disabled state for it to be enabled.enableTable 在接口中 AdmintableName - name of the tableIOException - if a remote or network exception occurs
There could be couple types of IOException
TableNotFoundException means the table doesn't exist.
TableNotDisabledException means the table isn't in disabled state.isTableEnabled(byte[]),
disableTable(byte[]),
enableTableAsync(byte[])public void enableTable(byte[] tableName)
throws IOException
IOExceptionpublic void enableTable(String tableName) throws IOException
IOExceptionpublic void enableTableAsync(TableName tableName) throws IOException
isTableEnabled(byte[]) to learn when table is fully online. If
table is taking too long to online, check server logs.enableTableAsync 在接口中 AdmintableName - IOExceptionpublic void enableTableAsync(byte[] tableName)
throws IOException
IOExceptionpublic void enableTableAsync(String tableName) throws IOException
IOExceptionpublic HTableDescriptor[] enableTables(String regex) throws IOException
listTables(java.lang.String) and
enableTable(byte[])enableTables 在接口中 Adminregex - The regular expression to match table names againstIOExceptionenableTables(java.util.regex.Pattern),
enableTable(java.lang.String)public HTableDescriptor[] enableTables(Pattern pattern) throws IOException
listTables(java.util.regex.Pattern) and
enableTable(byte[])enableTables 在接口中 Adminpattern - The pattern to match table names againstIOExceptionpublic void disableTableAsync(TableName tableName) throws IOException
isTableDisabled(byte[]) to check for when disable completes.
If table is taking too long to online, check server logs.disableTableAsync 在接口中 AdmintableName - name of tableIOException - if a remote or network exception occursisTableDisabled(byte[]),
isTableEnabled(byte[])public void disableTableAsync(byte[] tableName)
throws IOException
IOExceptionpublic void disableTableAsync(String tableName) throws IOException
IOExceptionpublic void disableTable(TableName tableName) throws IOException
disableTableAsync(byte[]) and isTableDisabled(String)
instead.
The table has to be in enabled state for it to be disabled.disableTable 在接口中 AdmintableName - IOException - There could be couple types of IOException
TableNotFoundException means the table doesn't exist.
TableNotEnabledException means the table isn't in enabled state.public void disableTable(byte[] tableName)
throws IOException
IOExceptionpublic void disableTable(String tableName) throws IOException
IOExceptionpublic HTableDescriptor[] disableTables(String regex) throws IOException
listTables(java.lang.String) and
disableTable(byte[])disableTables 在接口中 Adminregex - The regular expression to match table names againstIOExceptiondisableTables(java.util.regex.Pattern),
disableTable(java.lang.String)public HTableDescriptor[] disableTables(Pattern pattern) throws IOException
listTables(java.util.regex.Pattern) and
disableTable(byte[])disableTables 在接口中 Adminpattern - The pattern to match table names againstIOExceptionpublic boolean isTableEnabled(TableName tableName) throws IOException
isTableEnabled 在接口中 AdmintableName - name of table to checkIOException - if a remote or network exception occurspublic boolean isTableEnabled(byte[] tableName)
throws IOException
IOExceptionpublic boolean isTableEnabled(String tableName) throws IOException
IOExceptionpublic boolean isTableDisabled(TableName tableName) throws IOException
isTableDisabled 在接口中 AdmintableName - name of table to checkIOException - if a remote or network exception occurspublic boolean isTableDisabled(byte[] tableName)
throws IOException
IOExceptionpublic boolean isTableDisabled(String tableName) throws IOException
IOExceptionpublic boolean isTableAvailable(TableName tableName) throws IOException
isTableAvailable 在接口中 AdmintableName - name of table to checkIOException - if a remote or network exception occurspublic boolean isTableAvailable(byte[] tableName)
throws IOException
IOExceptionpublic boolean isTableAvailable(String tableName) throws IOException
IOExceptionpublic boolean isTableAvailable(TableName tableName, byte[][] splitKeys) throws IOException
isTableAvailable 在接口中 AdmintableName - name of table to checksplitKeys - keys to check if the table has been created with all split keysIOException - if a remote or network excpetion occurspublic boolean isTableAvailable(byte[] tableName,
byte[][] splitKeys)
throws IOException
IOExceptionpublic boolean isTableAvailable(String tableName, byte[][] splitKeys) throws IOException
IOExceptionpublic Pair<Integer,Integer> getAlterStatus(TableName tableName) throws IOException
getAlterStatus 在接口中 AdmintableName - TableName instanceIOException - if a remote or network exception occurspublic Pair<Integer,Integer> getAlterStatus(byte[] tableName) throws IOException
getAlterStatus 在接口中 AdmintableName - name of the table to get the status ofIOException - if a remote or network exception occurspublic void addColumn(byte[] tableName,
HColumnDescriptor column)
throws IOException
tableName - name of the table to add column tocolumn - column descriptor of column to be addedIOException - if a remote or network exception occurspublic void addColumn(String tableName, HColumnDescriptor column) throws IOException
tableName - name of the table to add column tocolumn - column descriptor of column to be addedIOException - if a remote or network exception occurspublic void addColumn(TableName tableName, HColumnDescriptor column) throws IOException
addColumn 在接口中 AdmintableName - name of the table to add column tocolumn - column descriptor of column to be addedIOException - if a remote or network exception occurspublic void deleteColumn(byte[] tableName,
String columnName)
throws IOException
tableName - name of tablecolumnName - name of column to be deletedIOException - if a remote or network exception occurspublic void deleteColumn(String tableName, String columnName) throws IOException
tableName - name of tablecolumnName - name of column to be deletedIOException - if a remote or network exception occurspublic void deleteColumn(TableName tableName, byte[] columnName) throws IOException
deleteColumn 在接口中 AdmintableName - name of tablecolumnName - name of column to be deletedIOException - if a remote or network exception occurspublic void modifyColumn(String tableName, HColumnDescriptor descriptor) throws IOException
tableName - name of tabledescriptor - new column descriptor to useIOException - if a remote or network exception occurspublic void modifyColumn(byte[] tableName,
HColumnDescriptor descriptor)
throws IOException
tableName - name of tabledescriptor - new column descriptor to useIOException - if a remote or network exception occurspublic void modifyColumn(TableName tableName, HColumnDescriptor descriptor) throws IOException
modifyColumn 在接口中 AdmintableName - name of tabledescriptor - new column descriptor to useIOException - if a remote or network exception occurspublic void closeRegion(String regionname, String serverName) throws IOException
closeRegion 在接口中 Adminregionname - region name to closeserverName - If supplied, we'll use this location rather than
the one currently in hbase:metaIOException - if a remote or network exception occurspublic void closeRegion(byte[] regionname,
String serverName)
throws IOException
closeRegion 在接口中 Adminregionname - region name to closeserverName - The servername of the regionserver. If passed null we
will use servername found in the hbase:meta table. A server name
is made of host, port and startcode. Here is an example:
host187.example.com,60020,1289493121758IOException - if a remote or network exception occurspublic boolean closeRegionWithEncodedRegionName(String encodedRegionName, String serverName) throws IOException
closeRegionWithEncodedRegionName 在接口中 AdminencodedRegionName - The encoded region name; i.e. the hash that makes up the region
name suffix: e.g. if regionname is
TestTable,0094429456,1289497600452.527db22f95c8a9e0116f0cc13c680396.
, then the encoded region name is:
527db22f95c8a9e0116f0cc13c680396.serverName - The servername of the regionserver. A server name is made of host,
port and startcode. This is mandatory. Here is an example:
host187.example.com,60020,1289493121758IOException - if a remote or network exception occurspublic void closeRegion(ServerName sn, HRegionInfo hri) throws IOException
closeRegion 在接口中 Adminsn - hri - IOExceptionpublic List<HRegionInfo> getOnlineRegions(ServerName sn) throws IOException
getOnlineRegions 在接口中 AdminIOExceptionpublic void flush(TableName tableName) throws IOException
flush 在接口中 AdmintableName - table to flushIOException - if a remote or network exception occurspublic void flushRegion(byte[] regionName)
throws IOException
flushRegion 在接口中 AdminregionName - region to flushIOException - if a remote or network exception occurs@Deprecated public void flush(String tableNameOrRegionName) throws IOException, InterruptedException
@Deprecated public void flush(byte[] tableNameOrRegionName) throws IOException, InterruptedException
public void compact(TableName tableName) throws IOException
compact 在接口中 AdmintableName - table to compactIOException - if a remote or network exception occurspublic void compactRegion(byte[] regionName)
throws IOException
compactRegion 在接口中 AdminregionName - region to compactIOException - if a remote or network exception occurs@Deprecated public void compact(String tableNameOrRegionName) throws IOException
IOException@Deprecated public void compact(byte[] tableNameOrRegionName) throws IOException
IOExceptionpublic void compact(TableName tableName, byte[] columnFamily) throws IOException
compact 在接口中 AdmintableName - table to compactcolumnFamily - column family within a tableIOException - if a remote or network exception occurspublic void compactRegion(byte[] regionName,
byte[] columnFamily)
throws IOException
compactRegion 在接口中 AdminregionName - region to compactcolumnFamily - column family within a regionIOException - if a remote or network exception occurs@Deprecated public void compact(String tableOrRegionName, String columnFamily) throws IOException
IOException@Deprecated public void compact(byte[] tableNameOrRegionName, byte[] columnFamily) throws IOException
IOExceptionpublic void compactRegionServer(ServerName sn, boolean major) throws IOException, InterruptedException
compactRegionServer 在接口中 Adminsn - the region server namemajor - if it's major compactionIOExceptionInterruptedExceptionpublic void majorCompact(TableName tableName) throws IOException
majorCompact 在接口中 AdmintableName - table to major compactIOException - if a remote or network exception occurspublic void majorCompactRegion(byte[] regionName)
throws IOException
majorCompactRegion 在接口中 AdminregionName - region to major compactIOException - if a remote or network exception occurs@Deprecated public void majorCompact(String tableNameOrRegionName) throws IOException
IOException@Deprecated public void majorCompact(byte[] tableNameOrRegionName) throws IOException
IOExceptionpublic void majorCompact(TableName tableName, byte[] columnFamily) throws IOException
majorCompact 在接口中 AdmintableName - table to major compactcolumnFamily - column family within a tableIOException - if a remote or network exception occurspublic void majorCompactRegion(byte[] regionName,
byte[] columnFamily)
throws IOException
majorCompactRegion 在接口中 AdminregionName - egion to major compactcolumnFamily - column family within a regionIOException - if a remote or network exception occurs@Deprecated public void majorCompact(String tableNameOrRegionName, String columnFamily) throws IOException
majorCompact(org.apache.hadoop.hbase.TableName,
byte[]) or majorCompactRegion(byte[], byte[]) instead.IOException@Deprecated public void majorCompact(byte[] tableNameOrRegionName, byte[] columnFamily) throws IOException
majorCompact(org.apache.hadoop.hbase.TableName,
byte[]) or majorCompactRegion(byte[], byte[]) instead.IOExceptionpublic void move(byte[] encodedRegionName,
byte[] destServerName)
throws IOException
r to dest.move 在接口中 AdminencodedRegionName - The encoded region name; i.e. the hash that makes
up the region name suffix: e.g. if regionname is
TestTable,0094429456,1289497600452.527db22f95c8a9e0116f0cc13c680396.,
then the encoded region name is: 527db22f95c8a9e0116f0cc13c680396.destServerName - The servername of the destination regionserver. If
passed the empty byte array we'll assign to a random server. A server name
is made of host, port and startcode. Here is an example:
host187.example.com,60020,1289493121758UnknownRegionException - Thrown if we can't find a region named
encodedRegionNameIOException - if we can't find a region named
encodedRegionNamepublic void assign(byte[] regionName)
throws MasterNotRunningException,
ZooKeeperConnectionException,
IOException
assign 在接口中 AdminregionName - Region name to assign.MasterNotRunningExceptionZooKeeperConnectionExceptionIOExceptionpublic void unassign(byte[] regionName,
boolean force)
throws MasterNotRunningException,
ZooKeeperConnectionException,
IOException
move(byte[], byte[]) if you want
to control the region movement.unassign 在接口中 AdminregionName - Region to unassign. Will clear any existing RegionPlan
if one found.force - If true, force unassign (Will remove region from
regions-in-transition too if present. If results in double assignment
use hbck -fix to resolve. To be used by experts).MasterNotRunningExceptionZooKeeperConnectionExceptionIOExceptionpublic void offline(byte[] regionName)
throws IOException
offline 在接口中 AdminregionName - Region to offline.IOExceptionpublic boolean setBalancerRunning(boolean on,
boolean synchronous)
throws IOException
setBalancerRunning 在接口中 Adminon - If true, enable balancer. If false, disable balancer.synchronous - If true, it waits until current balance() call, if outstanding, to return.IOExceptionpublic boolean balancer()
throws IOException
balancer 在接口中 AdminIOExceptionpublic boolean balancer(boolean force)
throws IOException
Adminbalancer 在接口中 Adminforce - whether we should force balance even if there is region in transitionIOExceptionpublic boolean isBalancerEnabled()
throws IOException
isBalancerEnabled 在接口中 AdminIOExceptionpublic boolean normalize()
throws IOException
normalize 在接口中 AdminIOExceptionpublic boolean isNormalizerEnabled()
throws IOException
isNormalizerEnabled 在接口中 AdminIOExceptionpublic boolean setNormalizerRunning(boolean on)
throws IOException
setNormalizerRunning 在接口中 AdminIOExceptionpublic boolean enableCatalogJanitor(boolean enable)
throws IOException
enableCatalogJanitor 在接口中 Adminenable - if true enables the catalog janitorMasterNotRunningExceptionIOExceptionpublic int runCatalogScan()
throws IOException
runCatalogScan 在接口中 AdminMasterNotRunningExceptionIOExceptionpublic boolean isCatalogJanitorEnabled()
throws IOException
isCatalogJanitorEnabled 在接口中 AdminMasterNotRunningExceptionIOExceptionpublic boolean setCleanerChoreRunning(boolean on)
throws IOException
AdminsetCleanerChoreRunning 在接口中 Adminon - if true enables the cleaner choreIOExceptionpublic boolean runCleanerChore()
throws IOException
AdminrunCleanerChore 在接口中 AdminIOExceptionpublic boolean isCleanerChoreEnabled()
throws IOException
AdminisCleanerChoreEnabled 在接口中 AdminIOExceptionpublic void mergeRegions(byte[] nameOfRegionA,
byte[] nameOfRegionB,
boolean forcible)
throws IOException
mergeRegions 在接口中 AdminnameOfRegionA - encoded or full name of region anameOfRegionB - encoded or full name of region bforcible - true if do a compulsory merge, otherwise we will only merge
two adjacent regionsIOExceptionpublic void split(TableName tableName) throws IOException
split 在接口中 AdmintableName - table to splitIOException - if a remote or network exception occurspublic void splitRegion(byte[] regionName)
throws IOException
splitRegion 在接口中 AdminregionName - region to splitIOException - if a remote or network exception occurs@Deprecated public void split(String tableNameOrRegionName) throws IOException, InterruptedException
@Deprecated public void split(byte[] tableNameOrRegionName) throws IOException, InterruptedException
public void split(TableName tableName, byte[] splitPoint) throws IOException
split 在接口中 AdmintableName - table to splitsplitPoint - the explicit position to split onIOException - if a remote or network exception occurspublic void splitRegion(byte[] regionName,
byte[] splitPoint)
throws IOException
splitRegion 在接口中 AdminregionName - region to splitsplitPoint - the explicit position to split onIOException - if a remote or network exception occurs@Deprecated public void split(String tableNameOrRegionName, String splitPoint) throws IOException
IOException@Deprecated public void split(byte[] tableNameOrRegionName, byte[] splitPoint) throws IOException
IOExceptionpublic void split(ServerName sn, HRegionInfo hri, byte[] splitPoint) throws IOException
IOExceptionpublic void modifyTable(TableName tableName, HTableDescriptor htd) throws IOException
modifyTable 在接口中 AdmintableName - name of table.htd - modified description of the tableIOException - if a remote or network exception occurspublic void modifyTable(byte[] tableName,
HTableDescriptor htd)
throws IOException
IOExceptionpublic void modifyTable(String tableName, HTableDescriptor htd) throws IOException
IOExceptionpublic void shutdown()
throws IOException
shutdown 在接口中 AdminIOException - if a remote or network exception occurspublic void stopMaster()
throws IOException
stopMaster 在接口中 AdminIOException - if a remote or network exception occursshutdown()public void stopRegionServer(String hostnamePort) throws IOException
stopRegionServer 在接口中 AdminhostnamePort - Hostname and port delimited by a : as in
example.org:1234IOException - if a remote or network exception occurspublic boolean isMasterInMaintenanceMode()
throws IOException
AdminisMasterInMaintenanceMode 在接口中 AdminIOException - if a remote or network exception occurspublic ClusterStatus getClusterStatus() throws IOException
getClusterStatus 在接口中 AdminIOException - if a remote or network exception occurspublic org.apache.hadoop.conf.Configuration getConfiguration()
getConfiguration 在接口中 Adminpublic void createNamespace(NamespaceDescriptor descriptor) throws IOException
createNamespace 在接口中 Admindescriptor - descriptor which describes the new namespaceIOExceptionpublic void modifyNamespace(NamespaceDescriptor descriptor) throws IOException
modifyNamespace 在接口中 Admindescriptor - descriptor which describes the new namespaceIOExceptionpublic void deleteNamespace(String name) throws IOException
deleteNamespace 在接口中 Adminname - namespace nameIOExceptionpublic NamespaceDescriptor getNamespaceDescriptor(String name) throws NamespaceNotFoundException, IOException
getNamespaceDescriptor 在接口中 Adminname - name of namespace descriptorIOExceptionNamespaceNotFoundExceptionpublic NamespaceDescriptor[] listNamespaceDescriptors() throws IOException
listNamespaceDescriptors 在接口中 AdminIOExceptionpublic ProcedureInfo[] listProcedures() throws IOException
listProcedures 在接口中 AdminIOExceptionpublic HTableDescriptor[] listTableDescriptorsByNamespace(String name) throws IOException
listTableDescriptorsByNamespace 在接口中 Adminname - namespace nameIOExceptionpublic TableName[] listTableNamesByNamespace(String name) throws IOException
listTableNamesByNamespace 在接口中 Adminname - namespace nameIOExceptionpublic static void checkHBaseAvailable(org.apache.hadoop.conf.Configuration conf)
throws MasterNotRunningException,
ZooKeeperConnectionException,
com.google.protobuf.ServiceException,
IOException
conf - system configurationMasterNotRunningException - if the master is not runningZooKeeperConnectionException - if unable to connect to zookeepercom.google.protobuf.ServiceExceptionIOExceptionpublic List<HRegionInfo> getTableRegions(TableName tableName) throws IOException
getTableRegions 在接口中 AdmintableName - the name of the tableHRegionInfo.IOExceptionpublic List<HRegionInfo> getTableRegions(byte[] tableName) throws IOException
IOExceptionpublic void close()
throws IOException
close 在接口中 Closeableclose 在接口中 AutoCloseableclose 在接口中 AdminIOExceptionpublic HTableDescriptor[] getTableDescriptorsByTableName(List<TableName> tableNames) throws IOException
getTableDescriptorsByTableName 在接口中 AdmintableNames - List of table namesIOException - if a remote or network exception occurspublic HTableDescriptor[] getTableDescriptors(List<String> names) throws IOException
getTableDescriptors 在接口中 Adminnames - List of table namesIOException - if a remote or network exception occurs@Deprecated public byte[][] rollHLogWriter(String serverName) throws IOException, FailedLogCloseException
rollWALWriter(ServerName)serverName - The servername of the regionserver. A server name is made of host,
port and startcode. This is mandatory. Here is an example:
host187.example.com,60020,1289493121758HRegionInfo.getEncodedName() that would allow the wal to
clean up some underlying files. null if there's nothing to flush.IOException - if a remote or network exception occursFailedLogCloseExceptionpublic void rollWALWriter(ServerName serverName) throws IOException, FailedLogCloseException
AdminrollWALWriter 在接口中 AdminserverName - The servername of the regionserver.IOException - if a remote or network exception occursFailedLogCloseExceptionpublic String[] getMasterCoprocessors()
AdmingetMasterCoprocessors 在接口中 AdminClusterStatus.getMasterCoprocessors()public org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState getCompactionState(TableName tableName) throws IOException
getCompactionState 在接口中 AdmintableName - table to examineIOException - if a remote or network exception occurspublic org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState getCompactionStateForRegion(byte[] regionName) throws IOException
getCompactionStateForRegion 在接口中 AdminregionName - region to examineIOException - if a remote or network exception occurs@Deprecated public org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState getCompactionState(String tableNameOrRegionName) throws IOException, InterruptedException
getCompactionState(org.apache.hadoop.hbase.TableName) or getCompactionStateForRegion(byte[]) instead.@Deprecated public org.apache.hadoop.hbase.protobuf.generated.AdminProtos.GetRegionInfoResponse.CompactionState getCompactionState(byte[] tableNameOrRegionName) throws IOException, InterruptedException
getCompactionState(org.apache.hadoop.hbase.TableName) or getCompactionStateForRegion(byte[]) instead.public void snapshot(String snapshotName, TableName tableName) throws IOException, SnapshotCreationException, IllegalArgumentException
Snapshots are considered unique based on the name of the snapshot. Attempts to take a
snapshot with the same name (even a different type or with different parameters) will fail with
a SnapshotCreationException indicating the duplicate naming.
Snapshot names follow the same naming constraints as tables in HBase. See
TableName.isLegalFullyQualifiedTableName(byte[]).
snapshot 在接口中 AdminsnapshotName - name of the snapshot to be createdtableName - name of the table for which snapshot is createdIOException - if a remote or network exception occursSnapshotCreationException - if snapshot creation failedIllegalArgumentException - if the snapshot request is formatted incorrectlypublic void snapshot(String snapshotName, String tableName) throws IOException, SnapshotCreationException, IllegalArgumentException
public void snapshot(byte[] snapshotName,
byte[] tableName,
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type flushType)
throws IOException,
SnapshotCreationException,
IllegalArgumentException
Snapshots are considered unique based on the name of the snapshot. Attempts to take a
snapshot with the same name (even a different type or with different parameters) will fail with
a SnapshotCreationException indicating the duplicate naming.
Snapshot names follow the same naming constraints as tables in HBase.
snapshotName - name of the snapshot to be createdtableName - name of the table for which snapshot is createdflushType - if the snapshot should be taken without flush memstore firstIOException - if a remote or network exception occursSnapshotCreationException - if snapshot creation failedIllegalArgumentException - if the snapshot request is formatted incorrectlypublic void snapshot(byte[] snapshotName,
TableName tableName)
throws IOException,
SnapshotCreationException,
IllegalArgumentException
Snapshots are considered unique based on the name of the snapshot. Attempts to take a
snapshot with the same name (even a different type or with different parameters) will fail with
a SnapshotCreationException indicating the duplicate naming.
Snapshot names follow the same naming constraints as tables in HBase.
snapshot 在接口中 AdminsnapshotName - name of the snapshot to be createdtableName - name of the table for which snapshot is createdIOException - if a remote or network exception occursSnapshotCreationException - if snapshot creation failedIllegalArgumentException - if the snapshot request is formatted incorrectlypublic void snapshot(byte[] snapshotName,
byte[] tableName)
throws IOException,
SnapshotCreationException,
IllegalArgumentException
public void snapshot(String snapshotName, TableName tableName, org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type) throws IOException, SnapshotCreationException, IllegalArgumentException
Snapshots are considered unique based on the name of the snapshot. Attempts to take a
snapshot with the same name (even a different type or with different parameters) will fail with
a SnapshotCreationException indicating the duplicate naming.
Snapshot names follow the same naming constraints as tables in HBase. See
TableName.isLegalFullyQualifiedTableName(byte[]).
snapshot 在接口中 AdminsnapshotName - name to give the snapshot on the filesystem. Must be unique from all other
snapshots stored on the clustertableName - name of the table to snapshottype - type of snapshot to takeIOException - we fail to reach the masterSnapshotCreationException - if snapshot creation failedIllegalArgumentException - if the snapshot request is formatted incorrectlypublic void snapshot(String snapshotName, String tableName, org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type) throws IOException, SnapshotCreationException, IllegalArgumentException
public void snapshot(String snapshotName, byte[] tableName, org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription.Type type) throws IOException, SnapshotCreationException, IllegalArgumentException
public void snapshot(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot) throws IOException, SnapshotCreationException, IllegalArgumentException
Only a single snapshot should be taken at a time for an instance of HBase, or results may be undefined (you can tell multiple HBase clusters to snapshot at the same time, but only one at a time for a single cluster).
Snapshots are considered unique based on the name of the snapshot. Attempts to take a
snapshot with the same name (even a different type or with different parameters) will fail with
a SnapshotCreationException indicating the duplicate naming.
Snapshot names follow the same naming constraints as tables in HBase. See
TableName.isLegalFullyQualifiedTableName(byte[]).
You should probably use snapshot(String, String) or snapshot(byte[], byte[])
unless you are sure about the type of snapshot that you want to take.
snapshot 在接口中 Adminsnapshot - snapshot to takeIOException - or we lose contact with the master.SnapshotCreationException - if snapshot failed to be takenIllegalArgumentException - if the snapshot request is formatted incorrectlypublic org.apache.hadoop.hbase.protobuf.generated.MasterProtos.SnapshotResponse takeSnapshotAsync(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot) throws IOException, SnapshotCreationException
Only a single snapshot should be taken at a time, or results may be undefined.
takeSnapshotAsync 在接口中 Adminsnapshot - snapshot to takeIOException - if the snapshot did not succeed or we lose contact with the master.SnapshotCreationException - if snapshot creation failedIllegalArgumentException - if the snapshot request is formatted incorrectlypublic boolean isSnapshotFinished(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription snapshot) throws IOException, HBaseSnapshotException, UnknownSnapshotException
There are three possible states:
The cluster only knows about the most recent snapshot. Therefore, if another snapshot has been
run/started since the snapshot your are checking, you will recieve an
UnknownSnapshotException.
isSnapshotFinished 在接口中 Adminsnapshot - description of the snapshot to checkIOException - if we have a network issueHBaseSnapshotException - if the snapshot failedUnknownSnapshotException - if the requested snapshot is unknownpublic void restoreSnapshot(byte[] snapshotName)
throws IOException,
RestoreSnapshotException
restoreSnapshot 在接口中 AdminsnapshotName - name of the snapshot to restoreIOException - if a remote or network exception occursRestoreSnapshotException - if snapshot failed to be restoredIllegalArgumentException - if the restore request is formatted incorrectlypublic void restoreSnapshot(String snapshotName) throws IOException, RestoreSnapshotException
restoreSnapshot 在接口中 AdminsnapshotName - name of the snapshot to restoreIOException - if a remote or network exception occursRestoreSnapshotException - if snapshot failed to be restoredIllegalArgumentException - if the restore request is formatted incorrectlypublic void restoreSnapshot(byte[] snapshotName,
boolean takeFailSafeSnapshot)
throws IOException,
RestoreSnapshotException
restoreSnapshot 在接口中 AdminsnapshotName - name of the snapshot to restoretakeFailSafeSnapshot - true if the failsafe snapshot should be takenIOException - if a remote or network exception occursRestoreSnapshotException - if snapshot failed to be restoredIllegalArgumentException - if the restore request is formatted incorrectlypublic void restoreSnapshot(String snapshotName, boolean takeFailSafeSnapshot, boolean restoreAcl) throws IOException, RestoreSnapshotException
restoreSnapshot 在接口中 AdminsnapshotName - name of the snapshot to restoretakeFailSafeSnapshot - true if the failsafe snapshot should be takenrestoreAcl - true to restore acl of snapshot into table.IOException - if a remote or network exception occursRestoreSnapshotException - if snapshot failed to be restoredIllegalArgumentException - if the restore request is formatted incorrectlypublic void restoreSnapshot(String snapshotName, boolean takeFailSafeSnapshot) throws IOException, RestoreSnapshotException
AdminrestoreSnapshot 在接口中 AdminsnapshotName - name of the snapshot to restoretakeFailSafeSnapshot - true if the failsafe snapshot should be takenIOException - if a remote or network exception occursRestoreSnapshotException - if snapshot failed to be restoredpublic void cloneSnapshot(byte[] snapshotName,
byte[] tableName)
throws IOException,
TableExistsException,
RestoreSnapshotException
snapshotName - name of the snapshot to be clonedtableName - name of the table where the snapshot will be restoredIOException - if a remote or network exception occursTableExistsException - if table to be created already existsRestoreSnapshotException - if snapshot failed to be clonedIllegalArgumentException - if the specified table has not a valid namepublic void cloneSnapshot(byte[] snapshotName,
TableName tableName)
throws IOException,
TableExistsException,
RestoreSnapshotException
cloneSnapshot 在接口中 AdminsnapshotName - name of the snapshot to be clonedtableName - name of the table where the snapshot will be restoredIOException - if a remote or network exception occursTableExistsException - if table to be created already existsRestoreSnapshotException - if snapshot failed to be clonedIllegalArgumentException - if the specified table has not a valid namepublic void cloneSnapshot(String snapshotName, String tableName) throws IOException, TableExistsException, RestoreSnapshotException, InterruptedException
snapshotName - name of the snapshot to be clonedtableName - name of the table where the snapshot will be restoredIOException - if a remote or network exception occursTableExistsException - if table to be created already existsRestoreSnapshotException - if snapshot failed to be clonedIllegalArgumentException - if the specified table has not a valid nameInterruptedExceptionpublic void cloneSnapshot(String snapshotName, TableName tableName, boolean restoreAcl) throws IOException, TableExistsException, RestoreSnapshotException
cloneSnapshot 在接口中 AdminsnapshotName - name of the snapshot to be clonedtableName - name of the table where the snapshot will be restoredrestoreAcl - true to restore acl of snapshot into newly created tableIOException - if a remote or network exception occursTableExistsException - if table to be created already existsRestoreSnapshotException - if snapshot failed to be clonedIllegalArgumentException - if the specified table has not a valid namepublic void cloneSnapshot(String snapshotName, TableName tableName) throws IOException, TableExistsException, RestoreSnapshotException
AdmincloneSnapshot 在接口中 AdminsnapshotName - name of the snapshot to be clonedtableName - name of the table where the snapshot will be restoredIOException - if a remote or network exception occursTableExistsException - if table to be created already existsRestoreSnapshotException - if snapshot failed to be clonedpublic byte[] execProcedureWithRet(String signature, String instance, Map<String,String> props) throws IOException
execProcedureWithRet 在接口中 Adminsignature - A distributed procedure is uniquely identified
by its signature (default the root ZK node name of the procedure).instance - The instance name of the procedure. For some procedures, this parameter is
optional.props - Property/Value pairs of properties passing to the procedureIOExceptionpublic void execProcedure(String signature, String instance, Map<String,String> props) throws IOException
execProcedure 在接口中 Adminsignature - A distributed procedure is uniquely identified
by its signature (default the root ZK node name of the procedure).instance - The instance name of the procedure. For some procedures, this parameter is
optional.props - Property/Value pairs of properties passing to the procedureIOExceptionpublic boolean isProcedureFinished(String signature, String instance, Map<String,String> props) throws IOException
There are three possible states:
isProcedureFinished 在接口中 Adminsignature - The signature that uniquely identifies a procedureinstance - The instance name of the procedureprops - Property/Value pairs of properties passing to the procedureIOException - if the specified procedure finished with errorpublic List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> listSnapshots() throws IOException
listSnapshots 在接口中 AdminIOException - if a network error occurspublic List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> listSnapshots(String regex) throws IOException
listSnapshots 在接口中 Adminregex - The regular expression to match againstIOException - if a remote or network exception occurspublic List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> listSnapshots(Pattern pattern) throws IOException
listSnapshots 在接口中 Adminpattern - The compiled regular expression to match againstIOException - if a remote or network exception occurspublic List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> listTableSnapshots(String tableNameRegex, String snapshotNameRegex) throws IOException
listTableSnapshots 在接口中 AdmintableNameRegex - The table name regular expression to match againstsnapshotNameRegex - The snapshot name regular expression to match againstIOException - if a remote or network exception occurspublic List<org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.SnapshotDescription> listTableSnapshots(Pattern tableNamePattern, Pattern snapshotNamePattern) throws IOException
listTableSnapshots 在接口中 AdmintableNamePattern - The compiled table name regular expression to match againstsnapshotNamePattern - The compiled snapshot name regular expression to match againstIOException - if a remote or network exception occurspublic void deleteSnapshot(byte[] snapshotName)
throws IOException
deleteSnapshot 在接口中 AdminsnapshotName - name of the snapshotIOException - if a remote or network exception occurspublic void deleteSnapshot(String snapshotName) throws IOException
deleteSnapshot 在接口中 AdminsnapshotName - name of the snapshotIOException - if a remote or network exception occurspublic void deleteSnapshots(String regex) throws IOException
deleteSnapshots 在接口中 Adminregex - The regular expression to match againstIOException - if a remote or network exception occurspublic void deleteSnapshots(Pattern pattern) throws IOException
deleteSnapshots 在接口中 Adminpattern - pattern for names of the snapshot to matchIOException - if a remote or network exception occurspublic void deleteTableSnapshots(String tableNameRegex, String snapshotNameRegex) throws IOException
deleteTableSnapshots 在接口中 AdmintableNameRegex - The table name regular expression to match againstsnapshotNameRegex - The snapshot name regular expression to match againstIOException - if a remote or network exception occurspublic void deleteTableSnapshots(Pattern tableNamePattern, Pattern snapshotNamePattern) throws IOException
deleteTableSnapshots 在接口中 AdmintableNamePattern - The compiled table name regular expression to match againstsnapshotNamePattern - The compiled snapshot name regular expression to match againstIOException - if a remote or network exception occurspublic void setQuota(QuotaSettings quota) throws IOException
setQuota 在接口中 Adminquota - the quota settingsIOException - if a remote or network exception occurspublic QuotaRetriever getQuotaRetriever(QuotaFilter filter) throws IOException
getQuotaRetriever 在接口中 Adminfilter - the quota settings filterIOException - if a remote or network exception occurspublic CoprocessorRpcChannel coprocessorService()
RpcChannel instance
connected to the active master.
The obtained RpcChannel instance can be used to access a published
coprocessor Service using standard protobuf service invocations:
CoprocessorRpcChannel channel = myAdmin.coprocessorService();
MyService.BlockingInterface service = MyService.newBlockingStub(channel);
MyCallRequest request = MyCallRequest.newBuilder()
...
.build();
MyCallResponse response = service.myCall(null, request);
coprocessorService 在接口中 Adminpublic CoprocessorRpcChannel coprocessorService(ServerName sn)
RpcChannel instance
connected to the passed region server.
The obtained RpcChannel instance can be used to access a published
coprocessor Service using standard protobuf service invocations:
CoprocessorRpcChannel channel = myAdmin.coprocessorService(serverName);
MyService.BlockingInterface service = MyService.newBlockingStub(channel);
MyCallRequest request = MyCallRequest.newBuilder()
...
.build();
MyCallResponse response = service.myCall(null, request);
coprocessorService 在接口中 Adminsn - the server name to which the endpoint call is madepublic void updateConfiguration(ServerName server) throws IOException
AdminupdateConfiguration 在接口中 Adminserver - : The server whose config needs to be updated.IOExceptionpublic void updateConfiguration()
throws IOException
AdminupdateConfiguration 在接口中 AdminIOExceptionpublic int getMasterInfoPort()
throws IOException
AdmingetMasterInfoPort 在接口中 AdminIOExceptionpublic long getLastMajorCompactionTimestamp(TableName tableName) throws IOException
AdmingetLastMajorCompactionTimestamp 在接口中 AdmintableName - table to examineIOException - if a remote or network exception occurspublic long getLastMajorCompactionTimestampForRegion(byte[] regionName)
throws IOException
AdmingetLastMajorCompactionTimestampForRegion 在接口中 AdminregionName - region to examineIOException - if a remote or network exception occurspublic List<SecurityCapability> getSecurityCapabilities() throws IOException
AdmingetSecurityCapabilities 在接口中 AdminIOExceptionpublic boolean[] setSplitOrMergeEnabled(boolean enabled,
boolean synchronous,
Admin.MasterSwitchType... switchTypes)
throws IOException
AdminsetSplitOrMergeEnabled 在接口中 Adminenabled - enabled or notsynchronous - If true, it waits until current split() call, if outstanding, to return.switchTypes - switchType list Admin.MasterSwitchTypeIOExceptionpublic boolean isSplitOrMergeEnabled(Admin.MasterSwitchType switchType) throws IOException
AdminisSplitOrMergeEnabled 在接口中 AdminIOExceptionpublic List<ServerName> listDeadServers() throws IOException
AdminlistDeadServers 在接口中 AdminIOExceptionpublic List<ServerName> clearDeadServers(List<ServerName> servers) throws IOException
AdminclearDeadServers 在接口中 Adminservers - list of dead region servers.IOException - if a remote or network exception occursCopyright © 2007–2021 The Apache Software Foundation. All rights reserved.