Package io.trino.execution

Interface RemoteTask

All Known Implementing Classes:

HttpRemoteTask

public interface RemoteTask

Method Summary

Modifier and Type	Method	Description
void	abort()
void	addFinalTaskInfoListener(StateMachine.StateChangeListener<TaskInfo> stateChangeListener)	Add a listener for the final task info.
void	addSplits(com.google.common.collect.Multimap<PlanNodeId,Split> splits)
void	addStateChangeListener(StateMachine.StateChangeListener<TaskStatus> stateChangeListener)	Listener is always notified asynchronously using a dedicated notification thread pool so, care should be taken to avoid leaking this when adding a listener in a constructor.
void	cancel()
void	failLocallyImmediately(Throwable cause)	Fails task from the coordinator perspective immediately, without waiting for acknowledgement from the remote task
void	failRemotely(Throwable cause)	Fails task remotely; only transitions to failed state when we receive confirmation that remote operation is completed
String	getNodeId()
PartitionedSplitsInfo	getPartitionedSplitsInfo()
PartitionedSplitsInfo	getQueuedPartitionedSplitsInfo()
TaskId	getTaskId()
TaskInfo	getTaskInfo()
TaskStatus	getTaskStatus()
int	getUnacknowledgedPartitionedSplitCount()
void	noMoreSplits(PlanNodeId sourceId)
Optional<SpoolingOutputStats.Snapshot>	retrieveAndDropSpoolingOutputStats()	Retrieves spooling output stats.
void	setOutputBuffers(OutputBuffers outputBuffers)
void	setSpeculative(boolean speculative)
void	start()
com.google.common.util.concurrent.ListenableFuture<Void>	whenSplitQueueHasSpace(long weightThreshold)

Method Details

getTaskId

TaskId getTaskId()

getNodeId

String getNodeId()

getTaskInfo

TaskInfo getTaskInfo()

getTaskStatus

TaskStatus getTaskStatus()

start

void start()

addSplits

void addSplits(com.google.common.collect.Multimap<PlanNodeId,Split> splits)

noMoreSplits

void noMoreSplits(PlanNodeId sourceId)

setOutputBuffers

void setOutputBuffers(OutputBuffers outputBuffers)

setSpeculative

void setSpeculative(boolean speculative)

addStateChangeListener

void addStateChangeListener(StateMachine.StateChangeListener<TaskStatus> stateChangeListener)

Listener is always notified asynchronously using a dedicated notification thread pool so, care should be taken to avoid leaking this when adding a listener in a constructor. Additionally, it is possible notifications are observed out of order due to the asynchronous execution.

addFinalTaskInfoListener

void addFinalTaskInfoListener(StateMachine.StateChangeListener<TaskInfo> stateChangeListener)

Add a listener for the final task info. This notification is guaranteed to be fired only once. Listener is always notified asynchronously using a dedicated notification thread pool so, care should be taken to avoid leaking this when adding a listener in a constructor. Additionally, it is possible notifications are observed out of order due to the asynchronous execution.

whenSplitQueueHasSpace

com.google.common.util.concurrent.ListenableFuture<Void> whenSplitQueueHasSpace(long weightThreshold)

cancel

void cancel()

abort

void abort()

getPartitionedSplitsInfo

PartitionedSplitsInfo getPartitionedSplitsInfo()

failLocallyImmediately

void failLocallyImmediately(Throwable cause)

Fails task from the coordinator perspective immediately, without waiting for acknowledgement from the remote task

failRemotely

void failRemotely(Throwable cause)

Fails task remotely; only transitions to failed state when we receive confirmation that remote operation is completed

getQueuedPartitionedSplitsInfo

PartitionedSplitsInfo getQueuedPartitionedSplitsInfo()

getUnacknowledgedPartitionedSplitCount

int getUnacknowledgedPartitionedSplitCount()

retrieveAndDropSpoolingOutputStats

Optional<SpoolingOutputStats.Snapshot> retrieveAndDropSpoolingOutputStats()

Retrieves spooling output stats. Stats are available only for tasks that are in the TaskState.FINISHED state and have received the final task info (see addFinalTaskInfoListener(StateChangeListener). Stats can be retrieved only once and are discarded upon retrieval. Subsequent calls to the method after initial retrieval will fail.

The retrieve-and-drop semantics is necessary to avoid unnecessary memory overhead of keeping the SpoolingOutputStats.Snapshot for every task as usually only the total output of the entire stage is of interest.

Returns:

spooling output statistics