org.apache.hadoop.hbase.regionserver

接口 RegionMergeTransaction

所有已知实现类:

RegionMergeTransactionImpl

@InterfaceAudience.LimitedPrivate(value="Coprocesssor")
@InterfaceStability.Evolving
public interface RegionMergeTransaction

Executes region merge as a "transaction". It is similar with SplitTransaction. Call prepare(RegionServerServices) to setup the transaction, execute(Server, RegionServerServices) to run the transaction and rollback(Server, RegionServerServices) to cleanup if execute fails.

Here is an example of how you would use this interface:

  RegionMergeTransactionFactory factory = new RegionMergeTransactionFactory(conf);
  RegionMergeTransaction mt = factory.create(parent, midKey)
    .registerTransactionListener(new TransactionListener() {
       public void transition(RegionMergeTransaction transaction,
         RegionMergeTransactionPhase from, RegionMergeTransactionPhase to) throws IOException {
         // ...
       }
       public void rollback(RegionMergeTransaction transaction,
         RegionMergeTransactionPhase from, RegionMergeTransactionPhase to) {
         // ...
       }
    });
  if (!mt.prepare()) return;
  try {
    mt.execute(server, services);
  } catch (IOException ioe) {
    try {
      mt.rollback(server, services);
      return;
    } catch (RuntimeException e) {
      // abort the server
    }
  }
 

A merge transaction is not thread safe. Callers must ensure a split is run by one thread only.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static interface	RegionMergeTransaction.JournalEntry Split transaction journal entry
static class	RegionMergeTransaction.RegionMergeTransactionPhase Each enum is a step in the merge transaction.
static interface	RegionMergeTransaction.TransactionListener Split transaction listener

方法概要

方法

限定符和类型	方法和说明
Region	execute(Server server, RegionServerServices services) 已过时。 use #execute(Server, RegionServerServices, User)
Region	execute(Server server, RegionServerServices services, User user) Run the transaction.
List<RegionMergeTransaction.JournalEntry>	getJournal() Get the journal for the transaction.
HRegionInfo	getMergedRegionInfo()
RegionServerServices	getRegionServerServices() Get the RegonServerServices of the server running the transaction or rollback
Server	getServer() Get the Server running the transaction or rollback
boolean	prepare(RegionServerServices services) Check merge inputs and prepare the transaction.
RegionMergeTransaction	registerTransactionListener(RegionMergeTransaction.TransactionListener listener) Register a listener for transaction preparation, execution, and possibly rollback phases.
boolean	rollback(Server server, RegionServerServices services) 已过时。 use #rollback(Server, RegionServerServices, User)
boolean	rollback(Server server, RegionServerServices services, User user) Roll back a failed transaction

方法详细资料

prepare

boolean prepare(RegionServerServices services)
                throws IOException

Check merge inputs and prepare the transaction.

参数:

services -

返回:

true if the regions are mergeable else false if they are not (e.g. its already closed, etc.).

抛出:

IOException

execute

@Deprecated
Region execute(Server server,
                        RegionServerServices services)
               throws IOException

已过时。 use #execute(Server, RegionServerServices, User)

Run the transaction.

参数:

server - Hosting server instance. Can be null when testing

services - Used to online/offline regions.

返回:

merged region

抛出:

IOException - If thrown, transaction failed. Call rollback(Server, RegionServerServices)

IOException

另请参阅:

rollback(Server, RegionServerServices)

execute

Region execute(Server server,
             RegionServerServices services,
             User user)
               throws IOException

Run the transaction.

参数:

server - Hosting server instance. Can be null when testing

services - Used to online/offline regions.

user -

返回:

merged region

抛出:

IOException - If thrown, transaction failed. Call rollback(Server, RegionServerServices)

IOException

另请参阅:

rollback(Server, RegionServerServices, User)

rollback

@Deprecated
boolean rollback(Server server,
                          RegionServerServices services)
                 throws IOException

已过时。 use #rollback(Server, RegionServerServices, User)

Roll back a failed transaction

参数:

server - Hosting server instance (May be null when testing).

services - Services of regionserver, used to online regions.

返回:

True if we successfully rolled back, false if we got to the point of no return and so now need to abort the server to minimize damage.

抛出:

IOException - If thrown, rollback failed. Take drastic action.

rollback

boolean rollback(Server server,
               RegionServerServices services,
               User user)
                 throws IOException

Roll back a failed transaction

参数:

server - Hosting server instance (May be null when testing).

services - Services of regionserver, used to online regions.

user -

返回:

True if we successfully rolled back, false if we got to the point of no return and so now need to abort the server to minimize damage.

抛出:

IOException - If thrown, rollback failed. Take drastic action.

registerTransactionListener

RegionMergeTransaction registerTransactionListener(RegionMergeTransaction.TransactionListener listener)

Register a listener for transaction preparation, execution, and possibly rollback phases.

A listener can abort a transaction by throwing an exception.

参数:

listener - the listener

返回:

'this' for chaining

getMergedRegionInfo

HRegionInfo getMergedRegionInfo()

返回:

merged region info

getJournal

List<RegionMergeTransaction.JournalEntry> getJournal()

Get the journal for the transaction.

Journal entries are an opaque type represented as JournalEntry. They can also provide useful debugging information via their toString method.

返回:

the transaction journal

getServer

Server getServer()

Get the Server running the transaction or rollback

返回:

server instance

getRegionServerServices

RegionServerServices getRegionServerServices()

Get the RegonServerServices of the server running the transaction or rollback

返回:

region server services