org.apache.calcite.rel.core

Class Collect

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

org.apache.calcite.rel.SingleRel

org.apache.calcite.rel.core.Collect

All Implemented Interfaces:

Cloneable, RelOptNode, RelNode

Direct Known Subclasses:

EnumerableCollect

public class Collect
extends SingleRel

A relational expression that collapses multiple rows into one.

Rules:

• SubQueryRemoveRule creates a Collect from a call to SqlArrayQueryConstructor, SqlMapQueryConstructor, or SqlMultisetQueryConstructor.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.calcite.rel.RelNode

RelNode.Context

Field Summary

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

input

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

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
	Collect(RelInput input) Creates a Collect by parsing serialized output.
protected	Collect(RelOptCluster cluster, RelTraitSet traitSet, RelNode input, RelDataType rowType) Creates a Collect.
	Collect(RelOptCluster cluster, RelTraitSet traitSet, RelNode input, String fieldName) Deprecated.

Method Summary

Modifier and Type	Method and Description
RelNode	copy(RelTraitSet traitSet, List<RelNode> inputs) Creates a copy of this relational expression, perhaps changing traits and inputs.
RelNode	copy(RelTraitSet traitSet, RelNode input)
static Collect	create(RelNode input, RelDataType rowType) Creates a Collect.
static Collect	create(RelNode input, SqlKind sqlKind, String fieldName) Creates a Collect.
static Collect	create(RelNode input, SqlTypeName collectionType, String fieldName) Deprecated.
static RelDataType	deriveCollectRowType(SingleRel rel, String fieldName) Deprecated.
protected RelDataType	deriveRowType()
static RelDataType	deriveRowType(RelDataTypeFactory typeFactory, SqlTypeName collectionType, String fieldName, RelDataType elementType) Derives the output row type of a Collect relational expression.
RelWriter	explainTerms(RelWriter pw) Describes the inputs and attributes of this relational expression.
SqlTypeName	getCollectionType() Returns the collection type (ARRAY, MAP, or MULTISET).
String	getFieldName() Returns the name of the sole output field.
protected RelDataType	rowType() Returns the row type, guaranteed not null.

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

childrenAccept, estimateRowCount, getInput, getInputs, replaceInput

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

accept, accept, collectVariablesSet, collectVariablesUsed, computeSelfCost, deepEquals, deepHashCode, equals, explain, getCluster, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getRelDigest, getRelTypeName, getRowType, getTable, getTraitSet, getVariablesSet, hashCode, isEnforcer, isValid, metadata, onRegister, recomputeDigest, register, sole, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.calcite.rel.RelNode

explain, fieldIsNullable

Constructor Detail

Collect

protected Collect(RelOptCluster cluster,
                  RelTraitSet traitSet,
                  RelNode input,
                  RelDataType rowType)

Creates a Collect.

Use create(org.apache.calcite.rel.RelNode, org.apache.calcite.rel.type.RelDataType) unless you know what you're doing.

Parameters:

cluster - Cluster

traitSet - Trait set

input - Input relational expression

rowType - Row type

Collect

@Deprecated
public Collect(RelOptCluster cluster,
                           RelTraitSet traitSet,
                           RelNode input,
                           String fieldName)

Deprecated.

Collect

public Collect(RelInput input)

Creates a Collect by parsing serialized output.

Method Detail

create

public static Collect create(RelNode input,
                             RelDataType rowType)

Creates a Collect.

Parameters:

input - Input relational expression

rowType - Row type

create

@Deprecated
public static Collect create(RelNode input,
                                         SqlTypeName collectionType,
                                         String fieldName)

Deprecated.

Creates a Collect.

Parameters:

input - Input relational expression

collectionType - ARRAY, MAP or MULTISET

fieldName - Name of the sole output field

create

public static Collect create(RelNode input,
                             SqlKind sqlKind,
                             String fieldName)

Creates a Collect.

Parameters:

input - Input relational expression

sqlKind - SqlKind

fieldName - Name of the sole output field

rowType

protected final RelDataType rowType()

Returns the row type, guaranteed not null. (The row type is never null after initialization, but CheckerFramework can't deduce that references are safe.)

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 RelNode copy(RelTraitSet traitSet,
                    RelNode input)

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 RelWriter.input(String, RelNode) and RelWriter.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

getFieldName

public String getFieldName()

Returns the name of the sole output field.

Returns:

name of the sole output field

getCollectionType

public SqlTypeName getCollectionType()

Returns the collection type (ARRAY, MAP, or MULTISET).

deriveRowType

protected RelDataType deriveRowType()

Overrides:

deriveRowType in class SingleRel

deriveCollectRowType

@Deprecated
public static RelDataType deriveCollectRowType(SingleRel rel,
                                                           String fieldName)

Deprecated.

Derives the output row type of a Collect relational expression.

Parameters:

rel - relational expression

fieldName - name of sole output field

Returns:

output row type of a Collect relational expression

deriveRowType

public static RelDataType deriveRowType(RelDataTypeFactory typeFactory,
                                        SqlTypeName collectionType,
                                        String fieldName,
                                        RelDataType elementType)

Derives the output row type of a Collect relational expression.

Parameters:

typeFactory - Type factory

collectionType - MULTISET, ARRAY or MAP

fieldName - Name of sole output field

elementType - Element type

Returns:

output row type of a Collect relational expression