org.apache.calcite.rel.core

Class Aggregate

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

org.apache.calcite.rel.SingleRel

org.apache.calcite.rel.core.Aggregate

All Implemented Interfaces:

Cloneable, RelOptNode, RelNode

Direct Known Subclasses:

Bindables.BindableAggregate, EnumerableAggregate, JdbcRules.JdbcAggregate, LogicalAggregate

public abstract class Aggregate
extends SingleRel

Relational operator that eliminates duplicates and computes totals.

It corresponds to the GROUP BY operator in a SQL query statement, together with the aggregate functions in the SELECT clause.

Rules:

• AggregateProjectPullUpConstantsRule
• AggregateExpandDistinctAggregatesRule
• AggregateReduceFunctionsRule.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Aggregate.AggCallBinding Implementation of the SqlOperatorBinding interface for an aggregate call applied to a set of operands in the context of a LogicalAggregate.
static class	Aggregate.Group What kind of roll-up is it?

Field Summary

Fields

Modifier and Type	Field and Description
protected List<AggregateCall>	aggCalls
protected ImmutableBitSet	groupSet
com.google.common.collect.ImmutableList<ImmutableBitSet>	groupSets
boolean	indicator
static com.google.common.base.Predicate<Aggregate>	IS_SIMPLE

Fields inherited from class org.apache.calcite.rel.AbstractRelNode

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Aggregate(RelInput input) Creates an Aggregate by parsing serialized output.
protected	Aggregate(RelOptCluster cluster, RelTraitSet traits, RelNode child, boolean indicator, ImmutableBitSet groupSet, List<ImmutableBitSet> groupSets, List<AggregateCall> aggCalls) Creates an Aggregate.

Method Summary

Methods

Modifier and Type	Method and Description
RelOptCost	computeSelfCost(RelOptPlanner planner) Returns the cost of this plan (not including children).
boolean	containsDistinctCall() Returns whether any of the aggregates are DISTINCT.
RelNode	copy(RelTraitSet traitSet, List<RelNode> inputs) Creates a copy of this relational expression, perhaps changing traits and inputs.
abstract Aggregate	copy(RelTraitSet traitSet, RelNode input, boolean indicator, ImmutableBitSet groupSet, List<ImmutableBitSet> groupSets, List<AggregateCall> aggCalls) Creates a copy of this aggregate.
protected RelDataType	deriveRowType()
static RelDataType	deriveRowType(RelDataTypeFactory typeFactory, RelDataType inputRowType, boolean indicator, ImmutableBitSet groupSet, List<ImmutableBitSet> groupSets, List<AggregateCall> aggCalls) Computes the row type of an Aggregate before it exists.
RelWriter	explainTerms(RelWriter pw) Describes the inputs and attributes of this relational expression.
List<AggregateCall>	getAggCallList() Returns a list of calls to aggregate functions.
int	getGroupCount() Returns the number of grouping fields.
ImmutableBitSet	getGroupSet() Returns a bit set of the grouping fields.
com.google.common.collect.ImmutableList<ImmutableBitSet>	getGroupSets() Returns the list of grouping sets computed by this Aggregate.
Aggregate.Group	getGroupType() Returns the type of roll-up.
int	getIndicatorCount() Returns the number of indicator fields.
double	getRows() Returns an estimate of the number of rows this relational expression will return.
boolean	isDistinct() Returns whether the same value will not come out twice.

Methods inherited from class org.apache.calcite.rel.SingleRel

childrenAccept, getInput, getInputs, replaceInput

Methods inherited from class org.apache.calcite.rel.AbstractRelNode

accept, accept, collectVariablesSet, collectVariablesUsed, computeDigest, explain, getChildExps, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getQuery, getRelTypeName, getRowType, getTable, getTraitSet, getVariablesStopped, isKey, isValid, metadata, onRegister, recomputeDigest, register, sole, toString

Methods inherited from class java.lang.Object

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

Field Detail

IS_SIMPLE

public static final com.google.common.base.Predicate<Aggregate> IS_SIMPLE

See Also:

Bug.CALCITE_461_FIXED

indicator

public final boolean indicator

aggCalls

protected final List<AggregateCall> aggCalls

groupSet

protected final ImmutableBitSet groupSet

groupSets

public final com.google.common.collect.ImmutableList<ImmutableBitSet> groupSets

Constructor Detail

Aggregate

protected Aggregate(RelOptCluster cluster,
         RelTraitSet traits,
         RelNode child,
         boolean indicator,
         ImmutableBitSet groupSet,
         List<ImmutableBitSet> groupSets,
         List<AggregateCall> aggCalls)

Creates an Aggregate.

All members of groupSets must be sub-sets of groupSet. For a simple GROUP BY, groupSets is a singleton list containing groupSet.

If GROUP BY is not specified, or equivalently if GROUP BY () is specified, groupSet will be the empty set, and groupSets will have one element, that empty set.

If CUBE, ROLLUP or GROUPING SETS are specified, groupSets will have additional elements, but they must each be a subset of groupSet, and they must be sorted by inclusion: (0, 1, 2), (1), (0, 2), (0), ().

Parameters:

cluster - Cluster

traits - Traits

child - Child

indicator - Whether row type should include indicator fields to indicate which grouping set is active; must be true if aggregate is not simple

groupSet - Bit set of grouping fields

groupSets - List of all grouping sets; null for just groupSet

aggCalls - Collection of calls to aggregate functions

Aggregate

protected Aggregate(RelInput input)

Creates an Aggregate by parsing serialized output.

Method Detail

copy

public final RelNode copy(RelTraitSet traitSet,
           List<RelNode> inputs)

Description copied from interface: RelNode

Creates a copy of this relational expression, perhaps changing traits and inputs.

Sub-classes with other important attributes are encouraged to create variants of this method with more parameters.

Specified by:

copy in interface RelNode

Overrides:

copy in class AbstractRelNode

Parameters:

traitSet - Trait set

inputs - Inputs

Returns:

Copy of this relational expression, substituting traits and inputs

copy

public abstract Aggregate copy(RelTraitSet traitSet,
             RelNode input,
             boolean indicator,
             ImmutableBitSet groupSet,
             List<ImmutableBitSet> groupSets,
             List<AggregateCall> aggCalls)

Creates a copy of this aggregate.

Parameters:

traitSet - Traits

input - Input

indicator - Whether row type should include indicator fields to indicate which grouping set is active; must be true if aggregate is not simple

groupSet - Bit set of grouping fields

groupSets - List of all grouping sets; null for just groupSet

aggCalls - Collection of calls to aggregate functions

Returns:

New Aggregate if any parameter differs from the value of this Aggregate, or just this if all the parameters are the same

See Also:

copy(org.apache.calcite.plan.RelTraitSet, java.util.List)

isDistinct

public boolean isDistinct()

Description copied from interface: RelNode

Returns whether the same value will not come out twice. Default value is false, derived classes should override.

Specified by:

isDistinct in interface RelNode

Overrides:

isDistinct in class AbstractRelNode

Returns:

Whether the same value will not come out twice

getAggCallList

public List<AggregateCall> getAggCallList()

Returns a list of calls to aggregate functions.

Returns:

list of calls to aggregate functions

getGroupCount

public int getGroupCount()

Returns the number of grouping fields. These grouping fields are the leading fields in both the input and output records.

NOTE: The getGroupSet() data structure allows for the grouping fields to not be on the leading edge. New code should, if possible, assume that grouping fields are in arbitrary positions in the input relational expression.

Returns:

number of grouping fields

getIndicatorCount

public int getIndicatorCount()

Returns the number of indicator fields.

This is the same as getGroupCount() if indicator is true, zero if indicator is false.

The offset of the first aggregate call in the output record is always groupCount + indicatorCount.

Returns:

number of indicator fields

getGroupSet

public ImmutableBitSet getGroupSet()

Returns a bit set of the grouping fields.

Returns:

bit set of ordinals of grouping fields

getGroupSets

public com.google.common.collect.ImmutableList<ImmutableBitSet> getGroupSets()

Returns the list of grouping sets computed by this Aggregate.

Returns:

List of all grouping sets; null for just groupSet

explainTerms

public RelWriter explainTerms(RelWriter pw)

Description copied from class: AbstractRelNode

Describes the inputs and attributes of this relational expression. Each node should call super.explainTerms, then call the RelWriterImpl.input(String, RelNode) and RelWriterImpl.item(String, Object) methods for each input and attribute.

Overrides:

explainTerms in class SingleRel

Parameters:

pw - Plan writer

Returns:

Plan writer for fluent-explain pattern

getRows

public double getRows()

Description copied from interface: RelNode

Returns an estimate of the number of rows this relational expression will return.

NOTE jvs 29-Mar-2006: Don't call this method directly. Instead, use RelMetadataQuery.getRowCount(org.apache.calcite.rel.RelNode), which gives plugins a chance to override the rel's default ideas about row count.

Specified by:

getRows in interface RelNode

Overrides:

getRows in class SingleRel

Returns:

Estimate of the number of rows this relational expression will return

computeSelfCost

public RelOptCost computeSelfCost(RelOptPlanner planner)

Description copied from interface: RelNode

Returns the cost of this plan (not including children). The base implementation throws an error; derived classes should override.

NOTE jvs 29-Mar-2006: Don't call this method directly. Instead, use RelMetadataQuery.getNonCumulativeCost(org.apache.calcite.rel.RelNode), which gives plugins a chance to override the rel's default ideas about cost.

Specified by:

computeSelfCost in interface RelNode

Overrides:

computeSelfCost in class AbstractRelNode

Parameters:

planner - Planner for cost calculation

Returns:

Cost of this plan (not including children)

deriveRowType

protected RelDataType deriveRowType()

Overrides:

deriveRowType in class SingleRel

deriveRowType

public static RelDataType deriveRowType(RelDataTypeFactory typeFactory,
                        RelDataType inputRowType,
                        boolean indicator,
                        ImmutableBitSet groupSet,
                        List<ImmutableBitSet> groupSets,
                        List<AggregateCall> aggCalls)

Computes the row type of an Aggregate before it exists.

Parameters:

typeFactory - Type factory

inputRowType - Input row type

indicator - Whether row type should include indicator fields to indicate which grouping set is active; must be true if aggregate is not simple

groupSet - Bit set of grouping fields

groupSets - List of all grouping sets; null for just groupSet

aggCalls - Collection of calls to aggregate functions

Returns:

Row type of the aggregate

containsDistinctCall

public boolean containsDistinctCall()

Returns whether any of the aggregates are DISTINCT.

Returns:

Whether any of the aggregates are DISTINCT

getGroupType

public Aggregate.Group getGroupType()

Returns the type of roll-up.

Returns:

Type of roll-up