org.apache.flink.runtime.checkpoint

Class PendingCheckpoint

java.lang.Object

org.apache.flink.runtime.checkpoint.PendingCheckpoint

public class PendingCheckpoint
extends Object

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.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PendingCheckpoint.TaskAcknowledgeResult Result of the acknowledgedTasks method.

Constructor Summary

Constructors

Constructor and Description
PendingCheckpoint(org.apache.flink.api.common.JobID jobId, long checkpointId, long checkpointTimestamp, Map<ExecutionAttemptID,ExecutionVertex> verticesToConfirm, Collection<String> masterStateIdentifiers, CheckpointProperties props, CheckpointStorageLocation targetLocation, Executor executor)

Method Summary

Modifier and Type	Method and Description
void	abort(CheckpointFailureReason reason) Aborts a checkpoint with reason and cause.
void	abort(CheckpointFailureReason reason, Throwable cause) Aborts a checkpoint with reason and cause.
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) Acknowledges the task with the given execution attempt id and the given subtask state.
boolean	areMasterStatesFullyAcknowledged()
boolean	areTasksFullyAcknowledged()
boolean	canBeSubsumed() Checks whether this checkpoint can be subsumed or whether it should always continue, regardless of newer checkpoints in progress.
CompletedCheckpoint	finalizeCheckpoint()
long	getCheckpointId()
long	getCheckpointTimestamp()
CompletableFuture<CompletedCheckpoint>	getCompletionFuture() Returns the completion future.
org.apache.flink.api.common.JobID	getJobId()
List<MasterState>	getMasterStates()
int	getNumberOfAcknowledgedTasks()
int	getNumberOfNonAcknowledgedTasks()
Map<OperatorID,OperatorState>	getOperatorStates()
boolean	isAcknowledgedBy(ExecutionAttemptID executionAttemptId)
boolean	isDiscarded()
boolean	setCancellerHandle(ScheduledFuture<?> cancellerHandle) Sets the handle for the canceller to this pending checkpoint.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

PendingCheckpoint

public PendingCheckpoint(org.apache.flink.api.common.JobID jobId,
                         long checkpointId,
                         long checkpointTimestamp,
                         Map<ExecutionAttemptID,ExecutionVertex> verticesToConfirm,
                         Collection<String> masterStateIdentifiers,
                         CheckpointProperties props,
                         CheckpointStorageLocation targetLocation,
                         Executor executor)

Method Detail

getJobId

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

getCheckpointId

public long getCheckpointId()

getCheckpointTimestamp

public long getCheckpointTimestamp()

getNumberOfNonAcknowledgedTasks

public int getNumberOfNonAcknowledgedTasks()

getNumberOfAcknowledgedTasks

public int getNumberOfAcknowledgedTasks()

getOperatorStates

public Map<OperatorID,OperatorState> getOperatorStates()

getMasterStates

public List<MasterState> getMasterStates()

areMasterStatesFullyAcknowledged

public boolean areMasterStatesFullyAcknowledged()

areTasksFullyAcknowledged

public boolean areTasksFullyAcknowledged()

isAcknowledgedBy

public boolean isAcknowledgedBy(ExecutionAttemptID executionAttemptId)

isDiscarded

public boolean isDiscarded()

canBeSubsumed

public boolean canBeSubsumed()

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

Returns:

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.

Returns:

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

getCompletionFuture

public CompletableFuture<CompletedCheckpoint> getCompletionFuture()

Returns the completion future.

Returns:

A future to the completed checkpoint

finalizeCheckpoint

public CompletedCheckpoint finalizeCheckpoint()
                                       throws IOException

Throws:

IOException

acknowledgeTask

public PendingCheckpoint.TaskAcknowledgeResult acknowledgeTask(ExecutionAttemptID executionAttemptId,
                                                               TaskStateSnapshot operatorSubtaskStates,
                                                               CheckpointMetrics metrics)

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

Parameters:

executionAttemptId - of the acknowledged task

operatorSubtaskStates - of the acknowledged task

metrics - Checkpoint metrics for the stats

Returns:

TaskAcknowledgeResult of the operation

acknowledgeMasterState

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

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

Parameters:

identifier - The identifier of the master state

state - The state to acknowledge

abort

public void abort(CheckpointFailureReason reason,
                  @Nullable
                  Throwable cause)

Aborts a checkpoint with reason and cause.

abort

public void abort(CheckpointFailureReason reason)

Aborts a checkpoint with reason and cause.

toString

public String toString()

Overrides:

toString in class Object