org.apache.calcite.tools

Interface RelBuilder.Config

Enclosing class:

RelBuilder

public static interface RelBuilder.Config

Configuration of RelBuilder.

It is immutable, and all fields are public.

Start with the DEFAULT instance, and call withXxx methods to set its properties.

Field Summary

Fields

Modifier and Type	Field and Description
static RelBuilder.Config	DEFAULT Default configuration.

Method Summary

Modifier and Type	Method and Description
boolean	aggregateUnique() Whether to create an Aggregate even if we know that the input is already unique; default false.
int	bloat() Controls whether to merge two Project operators when inlining expressions causes complexity to increase.
static RelBuilder.ConfigBuilder	builder() Deprecated.
boolean	dedupAggregateCalls() Whether RelBuilder.aggregate(org.apache.calcite.tools.RelBuilder.GroupKey, org.apache.calcite.tools.RelBuilder.AggCall...) should eliminate duplicate aggregate calls; default true.
boolean	pruneInputOfAggregate() Whether RelBuilder.aggregate(org.apache.calcite.tools.RelBuilder.GroupKey, org.apache.calcite.tools.RelBuilder.AggCall...) should prune unused input columns; default true.
boolean	pushJoinCondition() Whether to push down join conditions; default false (but SqlToRelConverter.config() by default sets this to true).
boolean	simplify() Whether to simplify expressions; default true.
boolean	simplifyLimit() Whether to simplify LIMIT 0 to an empty relation; default true.
default RelBuilder.ConfigBuilder	toBuilder() Deprecated.
RelBuilder.Config	withAggregateUnique(boolean aggregateUnique) Sets aggregateUnique().
RelBuilder.Config	withBloat(int bloat) Sets bloat().
RelBuilder.Config	withDedupAggregateCalls(boolean dedupAggregateCalls) Sets dedupAggregateCalls().
RelBuilder.Config	withPruneInputOfAggregate(boolean pruneInputOfAggregate) Sets pruneInputOfAggregate().
RelBuilder.Config	withPushJoinCondition(boolean pushJoinCondition) Sets pushJoinCondition().
RelBuilder.Config	withSimplify(boolean simplify) Sets simplify().
RelBuilder.Config	withSimplifyLimit(boolean simplifyLimit) Sets simplifyLimit().

Field Detail

DEFAULT

static final RelBuilder.Config DEFAULT

Default configuration.

Method Detail

builder

@Deprecated
static RelBuilder.ConfigBuilder builder()

Deprecated.

toBuilder

@Deprecated
default RelBuilder.ConfigBuilder toBuilder()

Deprecated.

bloat

int bloat()

Controls whether to merge two Project operators when inlining expressions causes complexity to increase.

Usually merging projects is beneficial, but occasionally the result is more complex than the original projects. Consider:

 P: Project(a+b+c AS x, d+e+f AS y, g+h+i AS z)  # complexity 15
 Q: Project(x*y*z AS p, x-y-z AS q)              # complexity 10
 R: Project((a+b+c)*(d+e+f)*(g+h+i) AS s,
            (a+b+c)-(d+e+f)-(g+h+i) AS t)        # complexity 34
 

The complexity of an expression is the number of nodes (leaves and operators). For example, a+b+c has complexity 5 (3 field references and 2 calls):

       +
      /  \
     +    c
    / \
   a   b
 

A negative value never allows merges.

A zero or positive value, bloat, allows a merge if complexity of the result is less than or equal to the sum of the complexity of the originals plus bloat.

The default value, 100, allows a moderate increase in complexity but prevents cases where complexity would run away into the millions and run out of memory. Moderate complexity is OK; the implementation, say via EnumerableCalc, will often gather common sub-expressions and compute them only once.

withBloat

RelBuilder.Config withBloat(int bloat)

Sets bloat().

dedupAggregateCalls

boolean dedupAggregateCalls()

Whether RelBuilder.aggregate(org.apache.calcite.tools.RelBuilder.GroupKey, org.apache.calcite.tools.RelBuilder.AggCall...) should eliminate duplicate aggregate calls; default true.

withDedupAggregateCalls

RelBuilder.Config withDedupAggregateCalls(boolean dedupAggregateCalls)

Sets dedupAggregateCalls().

pruneInputOfAggregate

boolean pruneInputOfAggregate()

Whether RelBuilder.aggregate(org.apache.calcite.tools.RelBuilder.GroupKey, org.apache.calcite.tools.RelBuilder.AggCall...) should prune unused input columns; default true.

withPruneInputOfAggregate

RelBuilder.Config withPruneInputOfAggregate(boolean pruneInputOfAggregate)

Sets pruneInputOfAggregate().

pushJoinCondition

boolean pushJoinCondition()

Whether to push down join conditions; default false (but SqlToRelConverter.config() by default sets this to true).

withPushJoinCondition

RelBuilder.Config withPushJoinCondition(boolean pushJoinCondition)

Sets pushJoinCondition().

simplify

boolean simplify()

Whether to simplify expressions; default true.

withSimplify

RelBuilder.Config withSimplify(boolean simplify)

Sets simplify().

simplifyLimit

boolean simplifyLimit()

Whether to simplify LIMIT 0 to an empty relation; default true.

withSimplifyLimit

RelBuilder.Config withSimplifyLimit(boolean simplifyLimit)

Sets simplifyLimit().

aggregateUnique

boolean aggregateUnique()

Whether to create an Aggregate even if we know that the input is already unique; default false.

withAggregateUnique

RelBuilder.Config withAggregateUnique(boolean aggregateUnique)

Sets aggregateUnique().