Package org.apache.flink.streaming.api.operators.sortpartition

Class SortPartitionOperator<INPUT>

java.lang.Object

org.apache.flink.streaming.api.operators.AbstractStreamOperator<INPUT>

org.apache.flink.streaming.api.operators.sortpartition.SortPartitionOperator<INPUT>

Type Parameters:

INPUT - The type of input record.

All Implemented Interfaces:

Serializable, org.apache.flink.api.common.state.CheckpointListener, BoundedOneInput, Input<INPUT>, KeyContext, KeyContextHandler, OneInputStreamOperator<INPUT,INPUT>, StreamOperator<INPUT>, StreamOperatorStateHandler.CheckpointedStreamOperator, YieldingOperator<INPUT>

@Internal
public class SortPartitionOperator<INPUT>
extends AbstractStreamOperator<INPUT>
implements OneInputStreamOperator<INPUT,INPUT>, BoundedOneInput

The SortPartitionOperator sorts records of a partition on non-keyed data stream. It ensures that all records within the same task are sorted in a user-defined order.

To sort the records, the record will be written to ExternalSorter directly. However, if the record is sorted according to the selected key by KeySelector, the selected key should also be written with the record to ExternalSorter to avoid repeated key selections.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected org.apache.flink.api.common.typeinfo.TypeInformation<INPUT>	inputType	The type information of input records.
protected org.apache.flink.api.java.functions.KeySelector<INPUT,?>	sortFieldSelector	The selector to create the sort key for records, which will be null if it's not used.

Fields inherited from class org.apache.flink.streaming.api.operators.AbstractStreamOperator

combinedWatermark, config, lastRecordAttributes1, lastRecordAttributes2, latencyStats, LOG, metrics, output, processingTimeService, stateHandler, stateKeySelector1, stateKeySelector2, timeServiceManager

Constructor Summary

Constructors

Constructor	Description
SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType, int positionSortField, org.apache.flink.api.common.operators.Order sortOrder)
SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType, String stringSortField, org.apache.flink.api.common.operators.Order sortOrder)
SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType, org.apache.flink.api.java.functions.KeySelector<INPUT,K> sortFieldSelector, org.apache.flink.api.common.operators.Order sortOrder)

Method Summary

Modifier and Type	Method	Description
void	endInput()	It is notified that no more data will arrive from the input.
OperatorAttributes	getOperatorAttributes()	Called to get the OperatorAttributes of the operator.
void	processElement(StreamRecord<INPUT> element)	Processes one element that arrived on this input of the MultipleInputStreamOperator.
protected void	setup(StreamTask<?,?> containingTask, StreamConfig config, Output<StreamRecord<INPUT>> output)

Methods inherited from class org.apache.flink.streaming.api.operators.AbstractStreamOperator

beforeInitializeStateHandler, close, finish, getContainingTask, getCurrentKey, getExecutionConfig, getInternalTimerService, getKeyedStateBackend, getKeyedStateStore, getMetricGroup, getOperatorConfig, getOperatorID, getOperatorName, getOperatorStateBackend, getOrCreateKeyedState, getPartitionedState, getPartitionedState, getProcessingTimeService, getRuntimeContext, getStateKeySelector1, getStateKeySelector2, getTimeServiceManager, getUserCodeClassloader, hasKeyContext1, hasKeyContext2, initializeState, initializeState, isAsyncKeyOrderedProcessingEnabled, isUsingCustomRawKeyedState, notifyCheckpointAborted, notifyCheckpointComplete, open, prepareSnapshotPreBarrier, processLatencyMarker, processLatencyMarker1, processLatencyMarker2, processRecordAttributes, processRecordAttributes1, processRecordAttributes2, processWatermark, processWatermark, processWatermark1, processWatermark1, processWatermark2, processWatermark2, processWatermarkStatus, processWatermarkStatus, processWatermarkStatus1, processWatermarkStatus2, reportOrForwardLatencyMarker, setCurrentKey, setKeyContextElement1, setKeyContextElement2, setMailboxExecutor, setProcessingTimeService, snapshotState, snapshotState, useSplittableTimers

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.flink.api.common.state.CheckpointListener

notifyCheckpointAborted, notifyCheckpointComplete

Methods inherited from interface org.apache.flink.streaming.api.operators.Input

processLatencyMarker, processRecordAttributes, processWatermark, processWatermark, processWatermarkStatus

Methods inherited from interface org.apache.flink.streaming.api.operators.KeyContext

getCurrentKey, setCurrentKey

Methods inherited from interface org.apache.flink.streaming.api.operators.KeyContextHandler

hasKeyContext

Methods inherited from interface org.apache.flink.streaming.api.operators.OneInputStreamOperator

setKeyContextElement

Methods inherited from interface org.apache.flink.streaming.api.operators.StreamOperator

close, finish, getMetricGroup, getOperatorID, initializeState, open, prepareSnapshotPreBarrier, setKeyContextElement1, setKeyContextElement2, snapshotState

Field Detail

inputType

protected final org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType

The type information of input records.

sortFieldSelector

protected final org.apache.flink.api.java.functions.KeySelector<INPUT,?> sortFieldSelector

The selector to create the sort key for records, which will be null if it's not used.

Constructor Detail

SortPartitionOperator

public SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType,
                             int positionSortField,
                             org.apache.flink.api.common.operators.Order sortOrder)

SortPartitionOperator

public SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType,
                             String stringSortField,
                             org.apache.flink.api.common.operators.Order sortOrder)

SortPartitionOperator

public SortPartitionOperator(org.apache.flink.api.common.typeinfo.TypeInformation<INPUT> inputType,
                             org.apache.flink.api.java.functions.KeySelector<INPUT,K> sortFieldSelector,
                             org.apache.flink.api.common.operators.Order sortOrder)

Method Detail

setup

protected void setup(StreamTask<?,?> containingTask,
                     StreamConfig config,
                     Output<StreamRecord<INPUT>> output)

Overrides:

setup in class AbstractStreamOperator<INPUT>

processElement

public void processElement(StreamRecord<INPUT> element)
                    throws Exception

Description copied from interface: Input

Processes one element that arrived on this input of the MultipleInputStreamOperator. This method is guaranteed to not be called concurrently with other methods of the operator.

Specified by:

processElement in interface Input<INPUT>

Throws:

Exception

endInput

public void endInput()
              throws Exception

Description copied from interface: BoundedOneInput

It is notified that no more data will arrive from the input.

Stateful operators need to be aware that a restart with rescaling may occur after receiving this notification. A changed source split assignment may imply that the same subtask of this operator that received endInput, has its state after endInput snapshotted, and will receive new data after restart. Hence, the state should not contain any finalization that would make it impossible to process new data.

WARNING: It is not safe to use this method to commit any transactions or other side effects! You can use this method to flush any buffered data that can later on be committed e.g. in a CheckpointListener.notifyCheckpointComplete(long).

NOTE: Given it is semantically very similar to the StreamOperator.finish() method. It might be dropped in favour of the other method at some point in time.

Specified by:

endInput in interface BoundedOneInput

Throws:

Exception

getOperatorAttributes

public OperatorAttributes getOperatorAttributes()

Description copied from interface: StreamOperator

Called to get the OperatorAttributes of the operator. If there is no defined attribute, a default OperatorAttributes is built.

Specified by:

getOperatorAttributes in interface StreamOperator<INPUT>

Returns:

OperatorAttributes of the operator.