org.apache.calcite.rel.core

Class Values

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

org.apache.calcite.rel.core.Values

All Implemented Interfaces:

Cloneable, RelOptNode, RelNode

Direct Known Subclasses:

Bindables.BindableValues, EnumerableValues, JdbcRules.JdbcValues, LogicalValues

public abstract class Values
extends AbstractRelNode

Relational expression whose value is a sequence of zero or more literal row values.

Nested Class Summary

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

RelNode.Context

Field Summary

Fields

Modifier and Type	Field and Description
private static com.google.common.base.Function<com.google.common.collect.ImmutableList<RexLiteral>,Object>	F Lambda that helps render tuples as strings.
static com.google.common.base.Predicate<? super Values>	IS_EMPTY Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains zero tuples.
static com.google.common.base.Predicate<? super Values>	IS_NOT_EMPTY Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains one or more tuples.
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>>	tuples

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

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
	Values(RelInput input) Creates a Values by parsing serialized output.
protected	Values(RelOptCluster cluster, RelDataType rowType, com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>> tuples, RelTraitSet traits) Creates a new Values.

Method Summary

Modifier and Type	Method and Description
private boolean	assertRowType() Returns true if all tuples match rowType; otherwise, assert on mismatch.
RelOptCost	computeSelfCost(RelOptPlanner planner, RelMetadataQuery mq) Returns the cost of this plan (not including children).
protected RelDataType	deriveRowType()
double	estimateRowCount(RelMetadataQuery mq) Returns an estimate of the number of rows this relational expression will return.
RelWriter	explainTerms(RelWriter pw) Describes the inputs and attributes of this relational expression.
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>>	getTuples() Returns the rows of literals represented by this Values relational expression.
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>>	getTuples(RelInput input)

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

accept, accept, childrenAccept, collectVariablesSet, collectVariablesUsed, computeDigest, computeSelfCost, copy, explain, getChildExps, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getInputs, getQuery, getRelTypeName, getRows, getRowType, getTable, getTraitSet, getVariablesSet, getVariablesStopped, isDistinct, isKey, isValid, isValid, metadata, onRegister, recomputeDigest, register, replaceInput, sole, toString

Methods inherited from class java.lang.Object

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

Field Detail

F

private static final com.google.common.base.Function<com.google.common.collect.ImmutableList<RexLiteral>,Object> F

Lambda that helps render tuples as strings.

IS_EMPTY

public static final com.google.common.base.Predicate<? super Values> IS_EMPTY

Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains zero tuples.

This is the conventional way to represent an empty relational expression. There are several rules that recognize empty relational expressions and prune away that section of the tree.

IS_NOT_EMPTY

public static final com.google.common.base.Predicate<? super Values> IS_NOT_EMPTY

Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains one or more tuples.

This is the conventional way to represent an empty relational expression. There are several rules that recognize empty relational expressions and prune away that section of the tree.

tuples

public final com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>> tuples

Constructor Detail

Values

protected Values(RelOptCluster cluster,
                 RelDataType rowType,
                 com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>> tuples,
                 RelTraitSet traits)

Creates a new Values.

Note that tuples passed in become owned by this rel (without a deep copy), so caller must not modify them after this call, otherwise bad things will happen.

Parameters:

cluster - Cluster that this relational expression belongs to

rowType - Row type for tuples produced by this rel

tuples - 2-dimensional array of tuple values to be produced; outer list contains tuples; each inner list is one tuple; all tuples must be of same length, conforming to rowType

Values

public Values(RelInput input)

Creates a Values by parsing serialized output.

Method Detail

getTuples

public com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>> getTuples(RelInput input)

getTuples

public com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<RexLiteral>> getTuples()

Returns the rows of literals represented by this Values relational expression.

assertRowType

private boolean assertRowType()

Returns true if all tuples match rowType; otherwise, assert on mismatch.

deriveRowType

protected RelDataType deriveRowType()

Overrides:

deriveRowType in class AbstractRelNode

computeSelfCost

public RelOptCost computeSelfCost(RelOptPlanner planner,
                                  RelMetadataQuery mq)

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

mq - Metadata query

Returns:

Cost of this plan (not including children)

estimateRowCount

public double estimateRowCount(RelMetadataQuery mq)

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:

estimateRowCount in interface RelNode

Overrides:

estimateRowCount in class AbstractRelNode

Parameters:

mq - Metadata query

Returns:

Estimate of the number of rows this relational expression will return

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 AbstractRelNode

Parameters:

pw - Plan writer

Returns:

Plan writer for fluent-explain pattern