org.apache.flink.runtime.checkpoint

类 PendingCheckpoint

java.lang.Object

org.apache.flink.runtime.checkpoint.PendingCheckpoint

所有已实现的接口:

Checkpoint

public class PendingCheckpoint
extends Object
implements Checkpoint

A pending checkpoint is a checkpoint that has been started, but has not been acknowledged by all tasks that need to acknowledge it. Once all tasks have acknowledged it, it becomes a CompletedCheckpoint.

Note that the pending checkpoint, as well as the successful checkpoint keep the state handles always as serialized values, never as actual values.

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	PendingCheckpoint.TaskAcknowledgeResult Result of the acknowledgedTasks method.

构造器概要

构造器

构造器和说明
PendingCheckpoint(org.apache.flink.api.common.JobID jobId, long checkpointId, long checkpointTimestamp, CheckpointPlan checkpointPlan, Collection<OperatorID> operatorCoordinatorsToConfirm, Collection<String> masterStateIdentifiers, CheckpointProperties props, CompletableFuture<CompletedCheckpoint> onCompletionPromise)

方法概要

限定符和类型	方法和说明
void	abort(CheckpointFailureReason reason, Throwable cause, CheckpointsCleaner checkpointsCleaner, Runnable postCleanup, Executor executor) Aborts a checkpoint with reason and cause.
PendingCheckpoint.TaskAcknowledgeResult	acknowledgeCoordinatorState(OperatorInfo coordinatorInfo, ByteStreamStateHandle stateHandle)
void	acknowledgeMasterState(String identifier, MasterState state) Acknowledges a master state (state generated on the checkpoint coordinator) to the pending checkpoint.
PendingCheckpoint.TaskAcknowledgeResult	acknowledgeTask(ExecutionAttemptID executionAttemptId, TaskStateSnapshot operatorSubtaskStates, CheckpointMetrics metrics, PendingCheckpointStats statsCallback) Acknowledges the task with the given execution attempt id and the given subtask state.
boolean	canBeSubsumed() Checks whether this checkpoint can be subsumed or whether it should always continue, regardless of newer checkpoints in progress.
void	discard() Discard state.
CompletedCheckpoint	finalizeCheckpoint(CheckpointsCleaner checkpointsCleaner, Runnable postCleanup, Executor executor, PendingCheckpointStats statsCallback)
long	getCheckpointId() 已过时。 use getCheckpointID()
long	getCheckpointID()
CheckpointPlan	getCheckpointPlan()
CheckpointStorageLocation	getCheckpointStorageLocation()
long	getCheckpointTimestamp()
CompletableFuture<CompletedCheckpoint>	getCompletionFuture() Returns the completion future.
CheckpointException	getFailureCause()
org.apache.flink.api.common.JobID	getJobId()
List<MasterState>	getMasterStates()
int	getNumberOfAcknowledgedTasks()
int	getNumberOfNonAcknowledgedOperatorCoordinators()
int	getNumberOfNonAcknowledgedTasks()
Map<OperatorID,OperatorState>	getOperatorStates()
boolean	isAcknowledgedBy(ExecutionAttemptID executionAttemptId)
boolean	isDisposed()
boolean	isFullyAcknowledged()
boolean	setCancellerHandle(ScheduledFuture<?> cancellerHandle) Sets the handle for the canceller to this pending checkpoint.
void	setCheckpointTargetLocation(CheckpointStorageLocation targetLocation)
String	toString()

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

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

构造器详细资料

PendingCheckpoint

public PendingCheckpoint(org.apache.flink.api.common.JobID jobId,
                         long checkpointId,
                         long checkpointTimestamp,
                         CheckpointPlan checkpointPlan,
                         Collection<OperatorID> operatorCoordinatorsToConfirm,
                         Collection<String> masterStateIdentifiers,
                         CheckpointProperties props,
                         CompletableFuture<CompletedCheckpoint> onCompletionPromise)

方法详细资料

getJobId

public org.apache.flink.api.common.JobID getJobId()

getCheckpointId

@Deprecated
public long getCheckpointId()

已过时。 use getCheckpointID()

getCheckpointID

public long getCheckpointID()

指定者:

getCheckpointID 在接口中 Checkpoint

setCheckpointTargetLocation

public void setCheckpointTargetLocation(CheckpointStorageLocation targetLocation)

getCheckpointStorageLocation

public CheckpointStorageLocation getCheckpointStorageLocation()

getCheckpointTimestamp

public long getCheckpointTimestamp()

getNumberOfNonAcknowledgedTasks

public int getNumberOfNonAcknowledgedTasks()

getNumberOfNonAcknowledgedOperatorCoordinators

public int getNumberOfNonAcknowledgedOperatorCoordinators()

getCheckpointPlan

public CheckpointPlan getCheckpointPlan()

getNumberOfAcknowledgedTasks

public int getNumberOfAcknowledgedTasks()

getOperatorStates

public Map<OperatorID,OperatorState> getOperatorStates()

getMasterStates

public List<MasterState> getMasterStates()

isFullyAcknowledged

public boolean isFullyAcknowledged()

isAcknowledgedBy

public boolean isAcknowledgedBy(ExecutionAttemptID executionAttemptId)

isDisposed

public boolean isDisposed()

canBeSubsumed

public boolean canBeSubsumed()

Checks whether this checkpoint can be subsumed or whether it should always continue, regardless of newer checkpoints in progress.

返回:

True if the checkpoint can be subsumed, false otherwise.

setCancellerHandle

public boolean setCancellerHandle(ScheduledFuture<?> cancellerHandle)

Sets the handle for the canceller to this pending checkpoint. This method fails with an exception if a handle has already been set.

返回:

true, if the handle was set, false, if the checkpoint is already disposed;

getFailureCause

public CheckpointException getFailureCause()

getCompletionFuture

public CompletableFuture<CompletedCheckpoint> getCompletionFuture()

Returns the completion future.

返回:

A future to the completed checkpoint

finalizeCheckpoint

public CompletedCheckpoint finalizeCheckpoint(CheckpointsCleaner checkpointsCleaner,
                                              Runnable postCleanup,
                                              Executor executor,
                                              @Nullable
                                              PendingCheckpointStats statsCallback)
                                       throws IOException

抛出:

IOException

acknowledgeTask

public PendingCheckpoint.TaskAcknowledgeResult acknowledgeTask(ExecutionAttemptID executionAttemptId,
                                                               TaskStateSnapshot operatorSubtaskStates,
                                                               CheckpointMetrics metrics,
                                                               @Nullable
                                                               PendingCheckpointStats statsCallback)

Acknowledges the task with the given execution attempt id and the given subtask state.

参数:

executionAttemptId - of the acknowledged task

operatorSubtaskStates - of the acknowledged task

metrics - Checkpoint metrics for the stats

返回:

TaskAcknowledgeResult of the operation

acknowledgeCoordinatorState

public PendingCheckpoint.TaskAcknowledgeResult acknowledgeCoordinatorState(OperatorInfo coordinatorInfo,
                                                                           @Nullable
                                                                           ByteStreamStateHandle stateHandle)

acknowledgeMasterState

public void acknowledgeMasterState(String identifier,
                                   @Nullable
                                   MasterState state)

Acknowledges a master state (state generated on the checkpoint coordinator) to the pending checkpoint.

参数:

identifier - The identifier of the master state

state - The state to acknowledge

abort

public void abort(CheckpointFailureReason reason,
                  @Nullable
                  Throwable cause,
                  CheckpointsCleaner checkpointsCleaner,
                  Runnable postCleanup,
                  Executor executor)

Aborts a checkpoint with reason and cause.

discard

public void discard()

Discard state. Must be called after dispose.

指定者:

discard 在接口中 Checkpoint

toString

public String toString()

覆盖:

toString 在类中 Object