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.

Field Summary

Fields

Modifier and Type	Field and Description
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.
protected 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

Methods

Modifier and Type	Method and Description
RelOptCost	computeSelfCost(RelOptPlanner planner) Returns the cost of this plan (not including children).
protected RelDataType	deriveRowType()
RelWriter	explainTerms(RelWriter pw) Describes the inputs and attributes of this relational expression.
double	getRows() Returns an estimate of the number of rows this relational expression will return.
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, copy, explain, getChildExps, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getInputs, getQuery, getRelTypeName, getRowType, getTable, getTraitSet, getVariablesStopped, isDistinct, isKey, 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

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.

tuples

protected 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.

deriveRowType

protected RelDataType deriveRowType()

Overrides:

deriveRowType in class AbstractRelNode

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)

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 AbstractRelNode

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