org.apache.hadoop.hbase.master.assignment

Class MergeTableRegionsProcedure

java.lang.Object

org.apache.hadoop.hbase.procedure2.Procedure<TEnvironment>

org.apache.hadoop.hbase.procedure2.StateMachineProcedure<MasterProcedureEnv,TState>

org.apache.hadoop.hbase.master.procedure.AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

org.apache.hadoop.hbase.master.assignment.MergeTableRegionsProcedure

All Implemented Interfaces:

Comparable<Procedure<MasterProcedureEnv>>, TableProcedureInterface

@InterfaceAudience.Private
public class MergeTableRegionsProcedure
extends AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

The procedure to Merge regions in a table. This procedure takes an exclusive table lock since it is working over multiple regions. It holds the lock for the life of the procedure. Throws exception on construction if determines context hostile to merge (cluster going down or master is shutting down or table is disabled).

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.hbase.procedure2.StateMachineProcedure

StateMachineProcedure.Flow

Nested classes/interfaces inherited from class org.apache.hadoop.hbase.procedure2.Procedure

Procedure.LockState

Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.master.procedure.TableProcedureInterface

TableProcedureInterface.TableOperationType

Field Summary

Fields inherited from class org.apache.hadoop.hbase.procedure2.StateMachineProcedure

stateCount

Fields inherited from class org.apache.hadoop.hbase.procedure2.Procedure

NO_PROC_ID, NO_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
MergeTableRegionsProcedure()
MergeTableRegionsProcedure(MasterProcedureEnv env, RegionInfo[] regionsToMerge, boolean force)

Method Summary

Modifier and Type	Method and Description
protected boolean	abort(MasterProcedureEnv env)
protected Procedure.LockState	acquireLock(MasterProcedureEnv env)
protected void	deserializeStateData(ProcedureStateSerializer serializer)
protected StateMachineProcedure.Flow	executeFromState(MasterProcedureEnv env, MasterProcedureProtos.MergeTableRegionsState state)
protected MasterProcedureProtos.MergeTableRegionsState	getInitialState()
protected ProcedureMetrics	getProcedureMetrics(MasterProcedureEnv env)
protected MasterProcedureProtos.MergeTableRegionsState	getState(int stateId)
protected int	getStateId(MasterProcedureProtos.MergeTableRegionsState state)
TableName	getTableName()
TableProcedureInterface.TableOperationType	getTableOperationType() Given an operation type we can take decisions about what to do with pending operations.
protected boolean	holdLock(MasterProcedureEnv env)
protected boolean	isRollbackSupported(MasterProcedureProtos.MergeTableRegionsState state)
protected void	releaseLock(MasterProcedureEnv env)
protected void	rollbackState(MasterProcedureEnv env, MasterProcedureProtos.MergeTableRegionsState state) To rollback MergeTableRegionsProcedure, two AssignProcedures are asynchronously submitted for each region to be merged (rollback doesn't wait on the completion of the AssignProcedures) .
protected void	serializeStateData(ProcedureStateSerializer serializer)
void	toStringClassDetails(StringBuilder sb)

Methods inherited from class org.apache.hadoop.hbase.master.procedure.AbstractStateMachineTableProcedure

checkOnline, checkTableModifiable, getUser, getWALRegionDir, preflightChecks, releaseSyncLatch, setUser, waitInitialized

Methods inherited from class org.apache.hadoop.hbase.procedure2.StateMachineProcedure

addChildProcedure, execute, failIfAborted, getCurrentState, getCurrentStateId, getCycles, isEofState, isYieldAfterExecutionStep, isYieldBeforeExecuteFromState, rollback, setNextState, toStringState

Methods inherited from class org.apache.hadoop.hbase.procedure2.Procedure

addStackIndex, afterReplay, beforeReplay, bypass, compareTo, completionCleanup, doExecute, doRollback, elapsedTime, getChildrenLatch, getException, getLastUpdate, getNonceKey, getOwner, getParentProcId, getProcId, getProcIdHashCode, getProcName, getResult, getRootProcedureId, getRootProcId, getStackIndexes, getState, getSubmittedTime, getTimeout, getTimeoutTimestamp, hasChildren, hasException, hasLock, hasOwner, hasParent, hasTimeout, haveSameParent, incChildrenLatch, isBypass, isFailed, isFinished, isInitializing, isLockedWhenLoading, isRunnable, isSuccess, isWaiting, removeStackIndex, setAbortFailure, setChildrenLatch, setFailure, setFailure, setLastUpdate, setNonceKey, setOwner, setOwner, setParentProcId, setProcId, setResult, setRootProcId, setStackIndexes, setState, setSubmittedTime, setTimeout, setTimeoutFailure, shouldWaitClientAck, skipPersistence, toString, toStringClass, toStringDetails, toStringSimpleSB, updateMetricsOnFinish, updateMetricsOnSubmit, updateTimestamp, wasExecuted

Methods inherited from class java.lang.Object

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

Constructor Detail

MergeTableRegionsProcedure

public MergeTableRegionsProcedure()

MergeTableRegionsProcedure

public MergeTableRegionsProcedure(MasterProcedureEnv env,
                                  RegionInfo[] regionsToMerge,
                                  boolean force)
                           throws IOException

Throws:

IOException

Method Detail

executeFromState

protected StateMachineProcedure.Flow executeFromState(MasterProcedureEnv env,
                                                      MasterProcedureProtos.MergeTableRegionsState state)

Specified by:

executeFromState in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

rollbackState

protected void rollbackState(MasterProcedureEnv env,
                             MasterProcedureProtos.MergeTableRegionsState state)
                      throws IOException

To rollback MergeTableRegionsProcedure, two AssignProcedures are asynchronously submitted for each region to be merged (rollback doesn't wait on the completion of the AssignProcedures) . This can be improved by changing rollback() to support sub-procedures. See HBASE-19851 for details.

Specified by:

rollbackState in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

Throws:

IOException

isRollbackSupported

protected boolean isRollbackSupported(MasterProcedureProtos.MergeTableRegionsState state)

Overrides:

isRollbackSupported in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

getState

protected MasterProcedureProtos.MergeTableRegionsState getState(int stateId)

Specified by:

getState in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

getStateId

protected int getStateId(MasterProcedureProtos.MergeTableRegionsState state)

Specified by:

getStateId in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

getInitialState

protected MasterProcedureProtos.MergeTableRegionsState getInitialState()

Specified by:

getInitialState in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

serializeStateData

protected void serializeStateData(ProcedureStateSerializer serializer)
                           throws IOException

Overrides:

serializeStateData in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

Throws:

IOException

deserializeStateData

protected void deserializeStateData(ProcedureStateSerializer serializer)
                             throws IOException

Overrides:

deserializeStateData in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>

Throws:

IOException

toStringClassDetails

public void toStringClassDetails(StringBuilder sb)

Overrides:

toStringClassDetails in class AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

acquireLock

protected Procedure.LockState acquireLock(MasterProcedureEnv env)

Overrides:

acquireLock in class AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

releaseLock

protected void releaseLock(MasterProcedureEnv env)

Overrides:

releaseLock in class AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

holdLock

protected boolean holdLock(MasterProcedureEnv env)

Overrides:

holdLock in class Procedure<MasterProcedureEnv>

getTableName

public TableName getTableName()

Specified by:

getTableName in interface TableProcedureInterface

Specified by:

getTableName in class AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

Returns:

the name of the table the procedure is operating on

getTableOperationType

public TableProcedureInterface.TableOperationType getTableOperationType()

Description copied from interface: TableProcedureInterface

Given an operation type we can take decisions about what to do with pending operations. e.g. if we get a delete and we have some table operation pending (e.g. add column) we can abort those operations.

Specified by:

getTableOperationType in interface TableProcedureInterface

Specified by:

getTableOperationType in class AbstractStateMachineTableProcedure<MasterProcedureProtos.MergeTableRegionsState>

Returns:

the operation type that the procedure is executing.

getProcedureMetrics

protected ProcedureMetrics getProcedureMetrics(MasterProcedureEnv env)

Overrides:

getProcedureMetrics in class Procedure<MasterProcedureEnv>

abort

protected boolean abort(MasterProcedureEnv env)

Overrides:

abort in class StateMachineProcedure<MasterProcedureEnv,MasterProcedureProtos.MergeTableRegionsState>