org.apache.hadoop.hbase.master.assignment

类 AssignProcedure

java.lang.Object

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

org.apache.hadoop.hbase.master.assignment.RegionTransitionProcedure

org.apache.hadoop.hbase.master.assignment.AssignProcedure

所有已实现的接口:

Comparable<Procedure<MasterProcedureEnv>>, TableProcedureInterface, RemoteProcedureDispatcher.RemoteProcedure<MasterProcedureEnv,ServerName>

@InterfaceAudience.Private
public class AssignProcedure
extends RegionTransitionProcedure

Procedure that describe the assignment of a single region. There can only be one RegionTransitionProcedure per region running at a time since each procedure takes a lock on the region.

The Assign starts by pushing the "assign" operation to the AssignmentManager and then will go in a "waiting" state. The AM will batch the "assign" requests and ask the Balancer where to put the region (the various policies will be respected: retain, round-robin, random). Once the AM and the balancer have found a place for the region the procedure will be resumed and an "open region" request will be placed in the Remote Dispatcher queue, and the procedure once again will go in a "waiting state". The Remote Dispatcher will batch the various requests for that server and they will be sent to the RS for execution. The RS will complete the open operation by calling master.reportRegionStateTransition(). The AM will intercept the transition report, and notify the procedure. The procedure will finish the assignment by publishing to new state on meta or it will retry the assignment.

This procedure does not rollback when beyond the first REGION_TRANSITION_QUEUE step; it will press on trying to assign in the face of failure. Should we ignore rollback calls to Assign/Unassign then? Or just remove rollback here?

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	AssignProcedure.CompareAssignProcedure Sort AssignProcedures such that meta and system assigns come first before user-space assigns.

从类继承的嵌套类/接口 org.apache.hadoop.hbase.procedure2.Procedure

Procedure.LockState

从接口继承的嵌套类/接口 org.apache.hadoop.hbase.master.procedure.TableProcedureInterface

TableProcedureInterface.TableOperationType

字段概要

字段

限定符和类型	字段和说明
static AssignProcedure.CompareAssignProcedure	COMPARATOR Comparator that will sort AssignProcedures so meta assigns come first, then system table assigns and finally user space assigns.
protected ServerName	targetServer Gets set as desired target on move, merge, etc., when we want to go to a particular server.

从类继承的字段 org.apache.hadoop.hbase.master.assignment.RegionTransitionProcedure

aborted

从类继承的字段 org.apache.hadoop.hbase.procedure2.Procedure

NO_PROC_ID, NO_TIMEOUT

构造器概要

构造器

构造器和说明
AssignProcedure()
AssignProcedure(RegionInfo regionInfo)
AssignProcedure(RegionInfo regionInfo, ServerName destinationServer)
AssignProcedure(RegionInfo regionInfo, ServerName destinationServer, boolean override)

方法概要

限定符和类型	方法和说明
static boolean	assign(MasterServices masterServices, RegionInfo ri) Used by ServerCrashProcedure too skip creating Assigns if not needed.
protected static boolean	assign(MasterServices masterServices, RegionStates.RegionStateNode regionNode)
protected void	deserializeStateData(ProcedureStateSerializer serializer)
protected void	finishTransition(MasterProcedureEnv env, RegionStates.RegionStateNode regionNode)
protected ProcedureMetrics	getProcedureMetrics(MasterProcedureEnv env)
ServerName	getServer(MasterProcedureEnv env) Used by ServerCrashProcedure to see if this Assign/Unassign needs processing.
TableProcedureInterface.TableOperationType	getTableOperationType() Given an operation type we can take decisions about what to do with pending operations.
protected boolean	isRollbackSupported(org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProcedureProtos.RegionTransitionState state)
RemoteProcedureDispatcher.RemoteOperation	remoteCallBuild(MasterProcedureEnv env, ServerName serverName)
protected boolean	remoteCallFailed(MasterProcedureEnv env, RegionStates.RegionStateNode regionNode, IOException exception)
protected void	reportTransition(MasterProcedureEnv env, RegionStates.RegionStateNode regionNode, org.apache.hadoop.hbase.shaded.protobuf.generated.RegionServerStatusProtos.RegionStateTransition.TransitionCode code, long openSeqNum)
protected void	serializeStateData(ProcedureStateSerializer serializer)
protected boolean	startTransition(MasterProcedureEnv env, RegionStates.RegionStateNode regionNode)
void	toStringClassDetails(StringBuilder sb)
protected boolean	updateTransition(MasterProcedureEnv env, RegionStates.RegionStateNode regionNode) Called when the Procedure is in the REGION_TRANSITION_DISPATCH state.

从类继承的方法 org.apache.hadoop.hbase.master.assignment.RegionTransitionProcedure

abort, acquireLock, addToRemoteDispatcher, bypass, execute, getAttempt, getRegionInfo, getRegionState, getTableName, getTransitionState, holdLock, isMeta, isServerOnline, isServerOnline, releaseLock, remoteCallFailed, remoteOperationCompleted, remoteOperationFailed, reportTransition, rollback, setAttempt, setOverride, setRegionInfo, setTimeoutFailure, shouldWaitClientAck, toStringState, waitInitialized

从类继承的方法 org.apache.hadoop.hbase.procedure2.Procedure

addStackIndex, afterReplay, beforeReplay, 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, isYieldAfterExecutionStep, removeStackIndex, setAbortFailure, setChildrenLatch, setFailure, setFailure, setLastUpdate, setNonceKey, setOwner, setOwner, setParentProcId, setProcId, setResult, setRootProcId, setStackIndexes, setState, setSubmittedTime, setTimeout, skipPersistence, toString, toStringClass, toStringDetails, toStringSimpleSB, updateMetricsOnFinish, updateMetricsOnSubmit, updateTimestamp, wasExecuted

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

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

字段详细资料

targetServer

protected volatile ServerName targetServer

Gets set as desired target on move, merge, etc., when we want to go to a particular server. We may not be able to respect this request but will try. When it is NOT set, then we ask the balancer to assign. This value is used below in startTransition to set regionLocation if non-null. Setting regionLocation in regionServerNode is how we override balancer setting destination.

COMPARATOR

public static final AssignProcedure.CompareAssignProcedure COMPARATOR

Comparator that will sort AssignProcedures so meta assigns come first, then system table assigns and finally user space assigns.

构造器详细资料

AssignProcedure

public AssignProcedure()

AssignProcedure

public AssignProcedure(RegionInfo regionInfo)

AssignProcedure

public AssignProcedure(RegionInfo regionInfo,
                       ServerName destinationServer)

AssignProcedure

public AssignProcedure(RegionInfo regionInfo,
                       ServerName destinationServer,
                       boolean override)

方法详细资料

getTableOperationType

public TableProcedureInterface.TableOperationType getTableOperationType()

从接口复制的说明: 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.

返回:

the operation type that the procedure is executing.

isRollbackSupported

protected boolean isRollbackSupported(org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProcedureProtos.RegionTransitionState state)

指定者:

isRollbackSupported 在类中 RegionTransitionProcedure

serializeStateData

protected void serializeStateData(ProcedureStateSerializer serializer)
                           throws IOException

指定者:

serializeStateData 在类中 Procedure<MasterProcedureEnv>

抛出:

IOException

deserializeStateData

protected void deserializeStateData(ProcedureStateSerializer serializer)
                             throws IOException

指定者:

deserializeStateData 在类中 Procedure<MasterProcedureEnv>

抛出:

IOException

assign

public static boolean assign(MasterServices masterServices,
                             RegionInfo ri)

Used by ServerCrashProcedure too skip creating Assigns if not needed.

返回:

Skip out on the assign; returns 'true'/assign if exception.

assign

protected static boolean assign(MasterServices masterServices,
                                RegionStates.RegionStateNode regionNode)
                         throws IOException

抛出:

IOException

startTransition

protected boolean startTransition(MasterProcedureEnv env,
                                  RegionStates.RegionStateNode regionNode)
                           throws IOException

指定者:

startTransition 在类中 RegionTransitionProcedure

抛出:

IOException

updateTransition

protected boolean updateTransition(MasterProcedureEnv env,
                                   RegionStates.RegionStateNode regionNode)
                            throws IOException,
                                   ProcedureSuspendedException

从类复制的说明: RegionTransitionProcedure

Called when the Procedure is in the REGION_TRANSITION_DISPATCH state. In here we do the RPC call to OPEN/CLOSE the region. The suspending of the thread so it sleeps until it gets update that the OPEN/CLOSE has succeeded is complicated. Read the implementations to learn more.

指定者:

updateTransition 在类中 RegionTransitionProcedure

抛出:

IOException

ProcedureSuspendedException

finishTransition

protected void finishTransition(MasterProcedureEnv env,
                                RegionStates.RegionStateNode regionNode)
                         throws IOException

指定者:

finishTransition 在类中 RegionTransitionProcedure

抛出:

IOException

reportTransition

protected void reportTransition(MasterProcedureEnv env,
                                RegionStates.RegionStateNode regionNode,
                                org.apache.hadoop.hbase.shaded.protobuf.generated.RegionServerStatusProtos.RegionStateTransition.TransitionCode code,
                                long openSeqNum)
                         throws UnexpectedStateException

指定者:

reportTransition 在类中 RegionTransitionProcedure

抛出:

UnexpectedStateException

remoteCallBuild

public RemoteProcedureDispatcher.RemoteOperation remoteCallBuild(MasterProcedureEnv env,
                                                                 ServerName serverName)

指定者:

remoteCallBuild 在接口中 RemoteProcedureDispatcher.RemoteProcedure<MasterProcedureEnv,ServerName>

指定者:

remoteCallBuild 在类中 RegionTransitionProcedure

remoteCallFailed

protected boolean remoteCallFailed(MasterProcedureEnv env,
                                   RegionStates.RegionStateNode regionNode,
                                   IOException exception)

指定者:

remoteCallFailed 在类中 RegionTransitionProcedure

返回:

True if processing of fail is complete; the procedure will be woken from its suspend and we'll go back to running through procedure steps: otherwise if false we leave the procedure in suspended state.

toStringClassDetails

public void toStringClassDetails(StringBuilder sb)

覆盖:

toStringClassDetails 在类中 RegionTransitionProcedure

getServer

public ServerName getServer(MasterProcedureEnv env)

从类复制的说明: RegionTransitionProcedure

Used by ServerCrashProcedure to see if this Assign/Unassign needs processing.

指定者:

getServer 在类中 RegionTransitionProcedure

返回:

ServerName the Assign or Unassign is going against.

getProcedureMetrics

protected ProcedureMetrics getProcedureMetrics(MasterProcedureEnv env)

覆盖:

getProcedureMetrics 在类中 Procedure<MasterProcedureEnv>