Module org.elasticsearch.compute

Package org.elasticsearch.compute.aggregation

Interface GroupingAggregatorFunction

All Superinterfaces:

AutoCloseable, Closeable, org.elasticsearch.core.Releasable

All Known Implementing Classes:

CountGroupingAggregatorFunction, DimensionValuesByteRefGroupingAggregatorFunction, FirstDocIdGroupingAggregatorFunction, FromPartialGroupingAggregatorFunction, PresentGroupingAggregatorFunction, RateDoubleGroupingAggregatorFunction, RateIntGroupingAggregatorFunction, RateLongGroupingAggregatorFunction, ToPartialGroupingAggregatorFunction, WindowGroupingAggregatorFunction

public interface GroupingAggregatorFunction
extends org.elasticsearch.core.Releasable

Applies some grouping function like min or avg to many values, grouped into buckets.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	GroupingAggregatorFunction.AddInput	Consume group ids to cause the GroupingAggregatorFunction to group values at a particular position into a particular group.

Method Summary

Modifier and Type	Method	Description
void	addIntermediateInput(int positionOffset, IntArrayBlock groupIdVector, Page page)	Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).
void	addIntermediateInput(int positionOffset, IntBigArrayBlock groupIdVector, Page page)	Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).
void	addIntermediateInput(int positionOffset, IntVector groupIdVector, Page page)	Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).
void	evaluateFinal(Block[] blocks, int offset, IntVector selected, GroupingAggregatorEvaluationContext evaluationContext)	Build the final results for this aggregation.
void	evaluateIntermediate(Block[] blocks, int offset, IntVector selected)	Build the intermediate results for this aggregation.
int	intermediateBlockCount()	The number of blocks used by intermediate state.
GroupingAggregatorFunction.AddInput	prepareProcessRawInputPage(SeenGroupIds seenGroupIds, Page page)	Prepare to process a single page of raw input.
void	selectedMayContainUnseenGroups(SeenGroupIds seenGroupIds)	Call this to signal to the aggregation that the selected parameter that's passed to evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector) or evaluateFinal(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector, org.elasticsearch.compute.aggregation.GroupingAggregatorEvaluationContext) may reference groups that haven't been seen.

Methods inherited from interface org.elasticsearch.core.Releasable

close

Method Details

prepareProcessRawInputPage

GroupingAggregatorFunction.AddInput prepareProcessRawInputPage(SeenGroupIds seenGroupIds,
 Page page)

Prepare to process a single page of raw input.

This should load the input Blocks and check their types and select an optimal path and return that path as an GroupingAggregatorFunction.AddInput.

selectedMayContainUnseenGroups

void selectedMayContainUnseenGroups(SeenGroupIds seenGroupIds)

Call this to signal to the aggregation that the selected parameter that's passed to evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector) or evaluateFinal(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector, org.elasticsearch.compute.aggregation.GroupingAggregatorEvaluationContext) may reference groups that haven't been seen. This puts the underlying storage into a mode where it'll track which group ids have been seen, even if that increases the overhead.

addIntermediateInput

void addIntermediateInput(int positionOffset,
 IntArrayBlock groupIdVector,
 Page page)

Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).

addIntermediateInput

void addIntermediateInput(int positionOffset,
 IntBigArrayBlock groupIdVector,
 Page page)

Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).

addIntermediateInput

void addIntermediateInput(int positionOffset,
 IntVector groupIdVector,
 Page page)

Add data produced by evaluateIntermediate(org.elasticsearch.compute.data.Block[], int, org.elasticsearch.compute.data.IntVector).

evaluateIntermediate

void evaluateIntermediate(Block[] blocks,
 int offset,
 IntVector selected)

Build the intermediate results for this aggregation.

Parameters:

selected - the groupIds that have been selected to be included in the results. Always ascending.

evaluateFinal

void evaluateFinal(Block[] blocks,
 int offset,
 IntVector selected,
 GroupingAggregatorEvaluationContext evaluationContext)

Build the final results for this aggregation.

Parameters:

selected - the groupIds that have been selected to be included in the results. Always ascending.

This function is called in the coordinator node after all intermediate results have been gathered from the worker nodes, and aggregated into intermediate blocks.

intermediateBlockCount

int intermediateBlockCount()

The number of blocks used by intermediate state.