org.apache.hadoop.hbase.master.assignment

Class SplitTableRegionProcedure

java.lang.Object

<any>

org.apache.hadoop.hbase.master.procedure.AbstractStateMachineTableProcedure<TState>

org.apache.hadoop.hbase.master.procedure.AbstractStateMachineRegionProcedure<SplitTableRegionState>

org.apache.hadoop.hbase.master.assignment.SplitTableRegionProcedure

All Implemented Interfaces:

TableProcedureInterface

public class SplitTableRegionProcedure
extends AbstractStateMachineRegionProcedure<SplitTableRegionState>

The procedure to split a region in a table. Takes lock on the parent region. It holds the lock for the life of the procedure.

Throws exception on construction if determines context hostile to spllt (cluster going down or master is shutting down or table is disabled).

Nested Class Summary

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

TableProcedureInterface.TableOperationType

Constructor Summary

Constructors

Constructor and Description
SplitTableRegionProcedure()
SplitTableRegionProcedure(MasterProcedureEnv env, RegionInfo regionToSplit, byte[] splitRow)

Method Summary

Modifier and Type	Method and Description
protected boolean	abort(MasterProcedureEnv env)
void	createDaughterRegions(MasterProcedureEnv env) Create daughter regions
protected void	deserializeStateData(ProcedureStateSerializer serializer)
protected Flow	executeFromState(MasterProcedureEnv env, SplitTableRegionState state)
protected SplitTableRegionState	getInitialState()
protected ProcedureMetrics	getProcedureMetrics(MasterProcedureEnv env)
protected SplitTableRegionState	getState(int stateId)
protected int	getStateId(SplitTableRegionState state)
TableProcedureInterface.TableOperationType	getTableOperationType() Given an operation type we can take decisions about what to do with pending operations.
protected boolean	isRollbackSupported(SplitTableRegionState state)
boolean	prepareSplitRegion(MasterProcedureEnv env) Prepare to Split region.
protected void	rollbackState(MasterProcedureEnv env, SplitTableRegionState state) To rollback SplitTableRegionProcedure, an AssignProcedure is asynchronously submitted for parent region to be split (rollback doesn't wait on the completion of the AssignProcedure) .
protected void	serializeStateData(ProcedureStateSerializer serializer)
void	toStringClassDetails(java.lang.StringBuilder sb)

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

acquireLock, checkTableModifiable, getRegion, getTableName, hasLock, holdLock, releaseLock, setFailure, setRegion

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

checkOnline, getRegionDir, getUser, preflightChecks, releaseSyncLatch, setUser

Methods inherited from class java.lang.Object

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

Constructor Detail

SplitTableRegionProcedure

public SplitTableRegionProcedure()

SplitTableRegionProcedure

public SplitTableRegionProcedure(MasterProcedureEnv env,
                                 RegionInfo regionToSplit,
                                 byte[] splitRow)
                          throws java.io.IOException

Throws:

java.io.IOException

Method Detail

executeFromState

protected Flow executeFromState(MasterProcedureEnv env,
                                SplitTableRegionState state)
                         throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

rollbackState

protected void rollbackState(MasterProcedureEnv env,
                             SplitTableRegionState state)
                      throws java.io.IOException,
                             java.lang.InterruptedException

To rollback SplitTableRegionProcedure, an AssignProcedure is asynchronously submitted for parent region to be split (rollback doesn't wait on the completion of the AssignProcedure) . This can be improved by changing rollback() to support sub-procedures. See HBASE-19851 for details.

Throws:

java.io.IOException

java.lang.InterruptedException

isRollbackSupported

protected boolean isRollbackSupported(SplitTableRegionState state)

getState

protected SplitTableRegionState getState(int stateId)

getStateId

protected int getStateId(SplitTableRegionState state)

getInitialState

protected SplitTableRegionState getInitialState()

serializeStateData

protected void serializeStateData(ProcedureStateSerializer serializer)
                           throws java.io.IOException

Overrides:

serializeStateData in class AbstractStateMachineRegionProcedure<SplitTableRegionState>

Throws:

java.io.IOException

deserializeStateData

protected void deserializeStateData(ProcedureStateSerializer serializer)
                             throws java.io.IOException

Overrides:

deserializeStateData in class AbstractStateMachineRegionProcedure<SplitTableRegionState>

Throws:

java.io.IOException

toStringClassDetails

public void toStringClassDetails(java.lang.StringBuilder sb)

Overrides:

toStringClassDetails in class AbstractStateMachineRegionProcedure<SplitTableRegionState>

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 AbstractStateMachineRegionProcedure<SplitTableRegionState>

Returns:

the operation type that the procedure is executing.

getProcedureMetrics

protected ProcedureMetrics getProcedureMetrics(MasterProcedureEnv env)

prepareSplitRegion

public boolean prepareSplitRegion(MasterProcedureEnv env)
                           throws java.io.IOException

Prepare to Split region.

Parameters:

env - MasterProcedureEnv

Throws:

java.io.IOException

createDaughterRegions

public void createDaughterRegions(MasterProcedureEnv env)
                           throws java.io.IOException

Create daughter regions

Parameters:

env - MasterProcedureEnv

Throws:

java.io.IOException

abort

protected boolean abort(MasterProcedureEnv env)