org.apache.hadoop.hbase.client.replication

类 ReplicationAdmin

java.lang.Object

org.apache.hadoop.hbase.client.replication.ReplicationAdmin

所有已实现的接口:

Closeable, AutoCloseable

@InterfaceAudience.Public
@InterfaceStability.Evolving
public class ReplicationAdmin
extends Object
implements Closeable

This class provides the administrative interface to HBase cluster replication. In order to use it, the cluster and the client using ReplicationAdmin must be configured with hbase.replication set to true.

Adding a new peer results in creating new outbound connections from every region server to a subset of region servers on the slave cluster. Each new stream of replication will start replicating from the beginning of the current WAL, meaning that edits from that past will be replicated.

Removing a peer is a destructive and irreversible operation that stops all the replication streams for the given cluster and deletes the metadata used to keep track of the replication state.

To see which commands are available in the shell, type replication.

字段概要

字段

限定符和类型	字段和说明
static String	CFNAME
static String	REPLICATION_WALENTRYFILTER_CONFIG_KEY
static String	REPLICATIONGLOBAL
static String	REPLICATIONTYPE
static String	TNAME

构造器概要

构造器

构造器和说明
ReplicationAdmin(org.apache.hadoop.conf.Configuration conf) Constructor that creates a connection to the local ZooKeeper ensemble.

方法概要

方法

限定符和类型	方法和说明
void	addPeer(String id, ReplicationPeerConfig peerConfig) Add a new remote slave cluster for replication.
void	addPeer(String id, ReplicationPeerConfig peerConfig, Map<TableName,? extends Collection<String>> tableCfs) Add a new remote slave cluster for replication.
void	addPeer(String id, String clusterKey) 已过时。 Use addPeer(String, ReplicationPeerConfig, Map) instead.
void	addPeer(String id, String clusterKey, String tableCFs) 已过时。
void	appendPeerTableCFs(String id, Map<TableName,? extends Collection<String>> tableCfs) Append the replicable table-cf config of the specified peer
void	appendPeerTableCFs(String id, String tableCfs) Append the replicable table-cf config of the specified peer
void	close()
void	disablePeer(String id) Stop the replication stream to the specified peer.
void	disableTableRep(TableName tableName) Disable a table's replication switch.
void	enablePeer(String id) Restart the replication stream to the specified peer.
void	enableTableRep(TableName tableName) Enable a table's replication switch.
ReplicationPeerConfig	getPeerConfig(String id)
int	getPeersCount() Get the number of slave clusters the local cluster has.
boolean	getPeerState(String id) Get the state of the specified peer cluster
String	getPeerTableCFs(String id) Get the replicable table-cf config of the specified peer.
Map<String,ReplicationPeerConfig>	listPeerConfigs()
Map<String,String>	listPeers() 已过时。 use listPeerConfigs()
List<HashMap<String,String>>	listReplicated() Find all column families that are replicated from this cluster
static Map<TableName,List<String>>	parseTableCFsFromConfig(String tableCFsConfig)
void	peerAdded(String id)
void	removePeer(String id) Removes a peer cluster and stops the replication to it.
void	removePeerTableCFs(String id, Map<TableName,? extends Collection<String>> tableCfs) Remove some table-cfs from config of the specified peer
void	removePeerTableCFs(String id, String tableCf) Remove some table-cfs from table-cfs config of the specified peer
void	setPeerTableCFs(String id, Map<TableName,? extends Collection<String>> tableCfs) Set the replicable table-cf config of the specified peer
void	setPeerTableCFs(String id, String tableCFs) 已过时。 use setPeerTableCFs(String, Map)
void	updatePeerConfig(String id, ReplicationPeerConfig peerConfig)

从类继承的方法 java.lang.Object

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

字段详细资料

TNAME

public static final String TNAME

另请参阅:

常量字段值

CFNAME

public static final String CFNAME

另请参阅:

常量字段值

REPLICATION_WALENTRYFILTER_CONFIG_KEY

public static final String REPLICATION_WALENTRYFILTER_CONFIG_KEY

另请参阅:

常量字段值

REPLICATIONTYPE

public static final String REPLICATIONTYPE

另请参阅:

常量字段值

REPLICATIONGLOBAL

public static final String REPLICATIONGLOBAL

构造器详细资料

ReplicationAdmin

public ReplicationAdmin(org.apache.hadoop.conf.Configuration conf)
                 throws IOException

Constructor that creates a connection to the local ZooKeeper ensemble.

参数:

conf - Configuration to use

抛出:

IOException - if an internal replication error occurs

RuntimeException - if replication isn't enabled.

方法详细资料

addPeer

@Deprecated
public void addPeer(String id,
                      String clusterKey)
             throws ReplicationException

已过时。 Use addPeer(String, ReplicationPeerConfig, Map) instead.

Add a new peer cluster to replicate to.

参数:

id - a short name that identifies the cluster

clusterKey - the concatenation of the slave cluster's hbase.zookeeper.quorum:hbase.zookeeper.property.clientPort:zookeeper.znode.parent

抛出:

IllegalStateException - if there's already one slave since multi-slave isn't supported yet.

ReplicationException

addPeer

@Deprecated
public void addPeer(String id,
                      String clusterKey,
                      String tableCFs)
             throws ReplicationException

已过时。

抛出:

ReplicationException

addPeer

public void addPeer(String id,
           ReplicationPeerConfig peerConfig,
           Map<TableName,? extends Collection<String>> tableCfs)
             throws ReplicationException

Add a new remote slave cluster for replication.

参数:

id - a short name that identifies the cluster

peerConfig - configuration for the replication slave cluster

tableCfs - the table and column-family list which will be replicated for this peer. A map from tableName to column family names. An empty collection can be passed to indicate replicating all column families. Pass null for replicating all table and column families

抛出:

ReplicationException

addPeer

public void addPeer(String id,
           ReplicationPeerConfig peerConfig)
             throws ReplicationException

Add a new remote slave cluster for replication.

参数:

id - a short name that identifies the cluster

peerConfig - configuration for the replication slave cluster

抛出:

ReplicationException

updatePeerConfig

public void updatePeerConfig(String id,
                    ReplicationPeerConfig peerConfig)
                      throws ReplicationException

抛出:

ReplicationException

parseTableCFsFromConfig

public static Map<TableName,List<String>> parseTableCFsFromConfig(String tableCFsConfig)

removePeer

public void removePeer(String id)
                throws ReplicationException

Removes a peer cluster and stops the replication to it.

参数:

id - a short name that identifies the cluster

抛出:

ReplicationException

enablePeer

public void enablePeer(String id)
                throws ReplicationException

Restart the replication stream to the specified peer.

参数:

id - a short name that identifies the cluster

抛出:

ReplicationException

disablePeer

public void disablePeer(String id)
                 throws ReplicationException

Stop the replication stream to the specified peer.

参数:

id - a short name that identifies the cluster

抛出:

ReplicationException

getPeersCount

public int getPeersCount()

Get the number of slave clusters the local cluster has.

返回:

number of slave clusters

listPeers

@Deprecated
public Map<String,String> listPeers()

已过时。 use listPeerConfigs()

Map of this cluster's peers for display.

返回:

A map of peer ids to peer cluster keys

listPeerConfigs

public Map<String,ReplicationPeerConfig> listPeerConfigs()

getPeerConfig

public ReplicationPeerConfig getPeerConfig(String id)
                                    throws ReplicationException

抛出:

ReplicationException

getPeerTableCFs

public String getPeerTableCFs(String id)
                       throws ReplicationException

Get the replicable table-cf config of the specified peer.

参数:

id - a short name that identifies the cluster

抛出:

ReplicationException

setPeerTableCFs

@Deprecated
public void setPeerTableCFs(String id,
                              String tableCFs)
                     throws ReplicationException

已过时。 use setPeerTableCFs(String, Map)

Set the replicable table-cf config of the specified peer

参数:

id - a short name that identifies the cluster

抛出:

ReplicationException

appendPeerTableCFs

public void appendPeerTableCFs(String id,
                      String tableCfs)
                        throws ReplicationException

Append the replicable table-cf config of the specified peer

参数:

id - a short that identifies the cluster

tableCfs - table-cfs config str

抛出:

ReplicationException

appendPeerTableCFs

public void appendPeerTableCFs(String id,
                      Map<TableName,? extends Collection<String>> tableCfs)
                        throws ReplicationException

Append the replicable table-cf config of the specified peer

参数:

id - a short that identifies the cluster

tableCfs - A map from tableName to column family names

抛出:

ReplicationException

removePeerTableCFs

public void removePeerTableCFs(String id,
                      String tableCf)
                        throws ReplicationException

Remove some table-cfs from table-cfs config of the specified peer

参数:

id - a short name that identifies the cluster

tableCf - table-cfs config str

抛出:

ReplicationException

removePeerTableCFs

public void removePeerTableCFs(String id,
                      Map<TableName,? extends Collection<String>> tableCfs)
                        throws ReplicationException

Remove some table-cfs from config of the specified peer

参数:

id - a short name that identifies the cluster

tableCfs - A map from tableName to column family names

抛出:

ReplicationException

setPeerTableCFs

public void setPeerTableCFs(String id,
                   Map<TableName,? extends Collection<String>> tableCfs)
                     throws ReplicationException

Set the replicable table-cf config of the specified peer

参数:

id - a short name that identifies the cluster

tableCfs - the table and column-family list which will be replicated for this peer. A map from tableName to column family names. An empty collection can be passed to indicate replicating all column families. Pass null for replicating all table and column families

抛出:

ReplicationException

getPeerState

public boolean getPeerState(String id)
                     throws ReplicationException

Get the state of the specified peer cluster

参数:

id - String format of the Short name that identifies the peer, an IllegalArgumentException is thrown if it doesn't exist

返回:

true if replication is enabled to that peer, false if it isn't

抛出:

ReplicationException

close

public void close()
           throws IOException

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

抛出:

IOException

listReplicated

public List<HashMap<String,String>> listReplicated()
                                            throws IOException

Find all column families that are replicated from this cluster

返回:

the full list of the replicated column families of this cluster as: tableName, family name, replicationType Currently replicationType is Global. In the future, more replication types may be extended here. For example 1) the replication may only apply to selected peers instead of all peers 2) the replicationType may indicate the host Cluster servers as Slave for the table:columnFam.

抛出:

IOException

enableTableRep

public void enableTableRep(TableName tableName)
                    throws IOException

Enable a table's replication switch.

参数:

tableName - name of the table

抛出:

IOException - if a remote or network exception occurs

disableTableRep

public void disableTableRep(TableName tableName)
                     throws IOException

Disable a table's replication switch.

参数:

tableName - name of the table

抛出:

IOException - if a remote or network exception occurs

peerAdded

@InterfaceAudience.Private
public void peerAdded(String id)
               throws ReplicationException

抛出:

ReplicationException