org.apache.hadoop.hbase.client

接口 ClusterConnection

所有超级接口:

Abortable, AutoCloseable, Closeable, Connection, HConnection

@InterfaceAudience.Private
public interface ClusterConnection
extends HConnection

Internal methods on Connection that should not be used by user code.

字段概要

从接口继承的字段 org.apache.hadoop.hbase.client.HConnection

HBASE_CLIENT_CONNECTION_IMPL

方法概要

方法

限定符和类型	方法和说明
void	cacheLocation(TableName tableName, RegionLocations location)
void	clearCaches(ServerName sn) Clear any caches that pertain to server name sn.
void	clearRegionCache() Allows flushing the region cache.
void	clearRegionCache(TableName tableName) Allows flushing the region cache of all locations that pertain to tableName
void	deleteCachedRegionLocation(HRegionLocation location) Deletes cached locations for the specific region.
org.apache.hadoop.hbase.protobuf.generated.AdminProtos.AdminService.BlockingInterface	getAdmin(ServerName serverName) Establishes a connection to the region server at the specified address.
org.apache.hadoop.hbase.client.AsyncProcess	getAsyncProcess()
ClientBackoffPolicy	getBackoffPolicy()
org.apache.hadoop.hbase.protobuf.generated.ClientProtos.ClientService.BlockingInterface	getClient(ServerName serverName) Establishes a connection to the region server at the specified address, and returns a region client protocol.
ConnectionConfiguration	getConnectionConfiguration()
MetricsConnection	getConnectionMetrics()
org.apache.hadoop.hbase.client.MasterKeepAliveConnection	getKeepAliveMasterService() 已过时。
org.apache.hadoop.hbase.protobuf.generated.MasterProtos.MasterService.BlockingInterface	getMaster() Returns a MasterKeepAliveConnection to the active master
RpcRetryingCallerFactory	getNewRpcRetryingCallerFactory(org.apache.hadoop.conf.Configuration conf) Returns a new RpcRetryingCallerFactory from the given Configuration.
NonceGenerator	getNonceGenerator()
HRegionLocation	getRegionLocation(TableName tableName, byte[] row, boolean reload) Find region location hosting passed row
RpcControllerFactory	getRpcControllerFactory()
RpcRetryingCallerFactory	getRpcRetryingCallerFactory()
ServerStatisticTracker	getStatisticsTracker()
boolean	hasCellBlockSupport()
boolean	isDeadServer(ServerName serverName) 已过时。 internal method, do not use thru HConnection
boolean	isManaged()
boolean	isMasterRunning() 已过时。 this has been deprecated without a replacement
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.
HRegionLocation	locateRegion(byte[] regionName) Gets the location of the region of regionName.
HRegionLocation	locateRegion(TableName tableName, byte[] row) Find the location of the region of tableName that row lives in.
RegionLocations	locateRegion(TableName tableName, byte[] row, boolean useCache, boolean retry)
RegionLocations	locateRegion(TableName tableName, byte[] row, boolean useCache, boolean retry, int replicaId)
List<HRegionLocation>	locateRegions(TableName tableName) Gets the locations of all regions in the specified table, tableName.
List<HRegionLocation>	locateRegions(TableName tableName, boolean useCache, boolean offlined) Gets the locations of all regions in the specified table, tableName.
HRegionLocation	relocateRegion(TableName tableName, byte[] row) Find the location of the region of tableName that row lives in, ignoring any value that might be in the cache.
RegionLocations	relocateRegion(TableName tableName, byte[] row, int replicaId) Find the location of the region of tableName that row lives in, ignoring any value that might be in the cache.
void	updateCachedLocations(TableName tableName, byte[] regionName, byte[] rowkey, Object exception, ServerName source) Update the location cache.

从接口继承的方法 org.apache.hadoop.hbase.client.HConnection

clearRegionCache, getAdmin, getAdmin, getConfiguration, getCurrentNrHRS, getHTableDescriptor, getHTableDescriptor, getHTableDescriptors, getHTableDescriptorsByTableName, getRegionCachePrefetch, getRegionCachePrefetch, getRegionLocation, getRegionLocator, getTable, getTable, getTable, getTable, getTable, getTable, getTableNames, isClosed, isTableAvailable, isTableAvailable, isTableAvailable, isTableDisabled, isTableDisabled, isTableEnabled, isTableEnabled, listTableNames, listTables, locateRegion, locateRegions, locateRegions, processBatch, processBatch, processBatchCallback, processBatchCallback, relocateRegion, setRegionCachePrefetch, setRegionCachePrefetch, updateCachedLocations, updateCachedLocations

从接口继承的方法 org.apache.hadoop.hbase.client.Connection

close, getBufferedMutator, getBufferedMutator, getClusterId

从接口继承的方法 org.apache.hadoop.hbase.Abortable

abort, isAborted

方法详细资料

isMasterRunning

@Deprecated
boolean isMasterRunning()
                        throws MasterNotRunningException,
                               ZooKeeperConnectionException

已过时。 this has been deprecated without a replacement

指定者:

isMasterRunning 在接口中 HConnection

返回:

- true if the master server is running

抛出:

MasterNotRunningException

ZooKeeperConnectionException

isTableAvailable

boolean isTableAvailable(TableName tableName,
                       byte[][] splitKeys)
                         throws IOException

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. Note : If this api is used after a table's region gets splitted, the api may return false.

指定者:

isTableAvailable 在接口中 HConnection

参数:

tableName - tableName

splitKeys - splitKeys used while creating table

抛出:

IOException - if a remote or network exception occurs

locateRegion

HRegionLocation locateRegion(TableName tableName,
                           byte[] row)
                             throws IOException

Find the location of the region of tableName that row lives in.

指定者:

locateRegion 在接口中 HConnection

参数:

tableName - name of the table row is in

row - row key you're trying to find the region of

返回:

HRegionLocation that describes where to find the region in question

抛出:

IOException - if a remote or network exception occurs

clearRegionCache

void clearRegionCache()

Allows flushing the region cache.

指定者:

clearRegionCache 在接口中 HConnection

cacheLocation

void cacheLocation(TableName tableName,
                 RegionLocations location)

clearRegionCache

void clearRegionCache(TableName tableName)

Allows flushing the region cache of all locations that pertain to tableName

指定者:

clearRegionCache 在接口中 HConnection

参数:

tableName - Name of the table whose regions we are to remove from cache.

deleteCachedRegionLocation

void deleteCachedRegionLocation(HRegionLocation location)

Deletes cached locations for the specific region.

指定者:

deleteCachedRegionLocation 在接口中 HConnection

参数:

location - The location object for the region, to be purged from cache.

relocateRegion

HRegionLocation relocateRegion(TableName tableName,
                             byte[] row)
                               throws IOException

Find the location of the region of tableName that row lives in, ignoring any value that might be in the cache.

指定者:

relocateRegion 在接口中 HConnection

参数:

tableName - name of the table row is in

row - row key you're trying to find the region of

返回:

HRegionLocation that describes where to find the region in question

抛出:

IOException - if a remote or network exception occurs

relocateRegion

RegionLocations relocateRegion(TableName tableName,
                             byte[] row,
                             int replicaId)
                               throws IOException

Find the location of the region of tableName that row lives in, ignoring any value that might be in the cache.

参数:

tableName - name of the table row is in

row - row key you're trying to find the region of

replicaId - the replicaId of the region

返回:

RegionLocations that describe where to find the region in question

抛出:

IOException - if a remote or network exception occurs

updateCachedLocations

void updateCachedLocations(TableName tableName,
                         byte[] regionName,
                         byte[] rowkey,
                         Object exception,
                         ServerName source)

Update the location cache. This is used internally by HBase, in most cases it should not be used by the client application.

指定者:

updateCachedLocations 在接口中 HConnection

参数:

tableName - the table name

regionName - the region name

rowkey - the row

exception - the exception if any. Can be null.

source - the previous location

locateRegion

HRegionLocation locateRegion(byte[] regionName)
                             throws IOException

Gets the location of the region of regionName.

指定者:

locateRegion 在接口中 HConnection

参数:

regionName - name of the region to locate

返回:

HRegionLocation that describes where to find the region in question

抛出:

IOException - if a remote or network exception occurs

locateRegions

List<HRegionLocation> locateRegions(TableName tableName)
                                    throws IOException

Gets the locations of all regions in the specified table, tableName.

指定者:

locateRegions 在接口中 HConnection

参数:

tableName - table to get regions of

返回:

list of region locations for all regions of table

抛出:

IOException

locateRegions

List<HRegionLocation> locateRegions(TableName tableName,
                                  boolean useCache,
                                  boolean offlined)
                                    throws IOException

Gets the locations of all regions in the specified table, tableName.

指定者:

locateRegions 在接口中 HConnection

参数:

tableName - table to get regions of

useCache - Should we use the cache to retrieve the region information.

offlined - True if we are to include offlined regions, false and we'll leave out offlined regions from returned list.

返回:

list of region locations for all regions of table

抛出:

IOException

locateRegion

RegionLocations locateRegion(TableName tableName,
                           byte[] row,
                           boolean useCache,
                           boolean retry)
                             throws IOException

参数:

tableName - table to get regions of

row - the row

useCache - Should we use the cache to retrieve the region information.

retry - do we retry

返回:

region locations for this row.

抛出:

IOException

locateRegion

RegionLocations locateRegion(TableName tableName,
                           byte[] row,
                           boolean useCache,
                           boolean retry,
                           int replicaId)
                             throws IOException

参数:

tableName - table to get regions of

row - the row

useCache - Should we use the cache to retrieve the region information.

retry - do we retry

replicaId - the replicaId for the region

返回:

region locations for this row.

抛出:

IOException

getMaster

org.apache.hadoop.hbase.protobuf.generated.MasterProtos.MasterService.BlockingInterface getMaster()
                                                                                                  throws IOException

Returns a MasterKeepAliveConnection to the active master

指定者:

getMaster 在接口中 HConnection

抛出:

IOException

getAdmin

org.apache.hadoop.hbase.protobuf.generated.AdminProtos.AdminService.BlockingInterface getAdmin(ServerName serverName)
                                                                                               throws IOException

Establishes a connection to the region server at the specified address.

指定者:

getAdmin 在接口中 HConnection

参数:

serverName -

返回:

proxy for HRegionServer

抛出:

IOException - if a remote or network exception occurs

getClient

org.apache.hadoop.hbase.protobuf.generated.ClientProtos.ClientService.BlockingInterface getClient(ServerName serverName)
                                                                                                  throws IOException

Establishes a connection to the region server at the specified address, and returns a region client protocol.

指定者:

getClient 在接口中 HConnection

参数:

serverName -

返回:

ClientProtocol proxy for RegionServer

抛出:

IOException - if a remote or network exception occurs

getRegionLocation

HRegionLocation getRegionLocation(TableName tableName,
                                byte[] row,
                                boolean reload)
                                  throws IOException

Find region location hosting passed row

指定者:

getRegionLocation 在接口中 HConnection

参数:

tableName - table name

row - Row to find.

reload - If true do not use cache, otherwise bypass.

返回:

Location of row.

抛出:

IOException - if a remote or network exception occurs

clearCaches

void clearCaches(ServerName sn)

Clear any caches that pertain to server name sn.

指定者:

clearCaches 在接口中 HConnection

参数:

sn - A server name

getKeepAliveMasterService

@Deprecated
org.apache.hadoop.hbase.client.MasterKeepAliveConnection getKeepAliveMasterService()
                                                                                   throws MasterNotRunningException

已过时。

This function allows HBaseAdmin and potentially others to get a shared MasterService connection.

指定者:

getKeepAliveMasterService 在接口中 HConnection

返回:

The shared instance. Never returns null.

抛出:

MasterNotRunningException

isDeadServer

@Deprecated
boolean isDeadServer(ServerName serverName)

已过时。 internal method, do not use thru HConnection

指定者:

isDeadServer 在接口中 HConnection

参数:

serverName -

返回:

true if the server is known as dead, false otherwise.

getNonceGenerator

NonceGenerator getNonceGenerator()

指定者:

getNonceGenerator 在接口中 HConnection

返回:

Nonce generator for this HConnection; may be null if disabled in configuration.

getAsyncProcess

org.apache.hadoop.hbase.client.AsyncProcess getAsyncProcess()

返回:

Default AsyncProcess associated with this connection.

getNewRpcRetryingCallerFactory

RpcRetryingCallerFactory getNewRpcRetryingCallerFactory(org.apache.hadoop.conf.Configuration conf)

Returns a new RpcRetryingCallerFactory from the given Configuration. This RpcRetryingCallerFactory lets the users create RpcRetryingCallers which can be intercepted with the configured RetryingCallerInterceptor

参数:

conf -

返回:

RpcRetryingCallerFactory

getRpcRetryingCallerFactory

RpcRetryingCallerFactory getRpcRetryingCallerFactory()

返回:

Connection's RpcRetryingCallerFactory instance

getRpcControllerFactory

RpcControllerFactory getRpcControllerFactory()

返回:

Connection's RpcControllerFactory instance

getConnectionConfiguration

ConnectionConfiguration getConnectionConfiguration()

返回:

a ConnectionConfiguration object holding parsed configuration values

isManaged

boolean isManaged()

返回:

true if this is a managed connection.

getStatisticsTracker

ServerStatisticTracker getStatisticsTracker()

返回:

the current statistics tracker associated with this connection

getBackoffPolicy

ClientBackoffPolicy getBackoffPolicy()

返回:

the configured client backoff policy

getConnectionMetrics

MetricsConnection getConnectionMetrics()

返回:

the MetricsConnection instance associated with this connection.

hasCellBlockSupport

boolean hasCellBlockSupport()

返回:

true when this connection uses a Codec and so supports cell blocks.