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, org.apache.calcite.plan.RelOptNode, org.apache.calcite.rel.hint.Hintable, org.apache.calcite.rel.RelNode

Direct Known Subclasses:

LogicalValues

public abstract class Values
extends org.apache.calcite.rel.AbstractRelNode
implements org.apache.calcite.rel.hint.Hintable

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

Temporarily copy from calcite to cherry-pick [CALCITE-5107] and will be removed when upgrade the latest calcite.

Nested Class Summary

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

org.apache.calcite.rel.RelNode.Context

Field Summary

Fields

Modifier and Type	Field and Description
protected com.google.common.collect.ImmutableList<org.apache.calcite.rel.hint.RelHint>	hints
static com.google.common.base.Predicate<? super Values>	IS_EMPTY Deprecated.
static java.util.function.Predicate<? super Values>	IS_EMPTY_J
static com.google.common.base.Predicate<? super Values>	IS_NOT_EMPTY Deprecated.
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>>	tuples

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

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Values(org.apache.calcite.rel.RelInput input) Creates a Values by parsing serialized output.
protected	Values(org.apache.calcite.plan.RelOptCluster cluster, List<org.apache.calcite.rel.hint.RelHint> hints, org.apache.calcite.rel.type.RelDataType rowType, com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> tuples, org.apache.calcite.plan.RelTraitSet traits) Creates a new Values.
protected	Values(org.apache.calcite.plan.RelOptCluster cluster, org.apache.calcite.rel.type.RelDataType rowType, com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> tuples, org.apache.calcite.plan.RelTraitSet traits) Creates a new Values.

Method Summary

Modifier and Type	Method and Description
@Nullable org.apache.calcite.plan.RelOptCost	computeSelfCost(org.apache.calcite.plan.RelOptPlanner planner, org.apache.calcite.rel.metadata.RelMetadataQuery mq)
protected org.apache.calcite.rel.type.RelDataType	deriveRowType()
double	estimateRowCount(org.apache.calcite.rel.metadata.RelMetadataQuery mq)
org.apache.calcite.rel.RelWriter	explainTerms(org.apache.calcite.rel.RelWriter pw)
com.google.common.collect.ImmutableList<org.apache.calcite.rel.hint.RelHint>	getHints()
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>>	getTuples() Returns the rows of literals represented by this Values relational expression.
com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>>	getTuples(org.apache.calcite.rel.RelInput input)
static boolean	isEmpty(Values values) Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains zero tuples.
static boolean	isNotEmpty(Values values) Predicate, to be used when defining an operand of a RelOptRule, that returns true if a Values contains one or more tuples.

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

accept, accept, childrenAccept, collectVariablesSet, collectVariablesUsed, copy, deepEquals, deepHashCode, equals, explain, getCluster, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getInputs, getRelDigest, getRelTypeName, getRowType, getTable, getTraitSet, getVariablesSet, hashCode, isEnforcer, isValid, metadata, onRegister, recomputeDigest, register, replaceInput, 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.hint.Hintable

attachHints, withHints

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

explain, fieldIsNullable

Field Detail

IS_EMPTY_J

public static final java.util.function.Predicate<? super Values> IS_EMPTY_J

hints

protected final com.google.common.collect.ImmutableList<org.apache.calcite.rel.hint.RelHint> hints

IS_EMPTY

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

Deprecated.

IS_NOT_EMPTY

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

Deprecated.

tuples

public final com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> tuples

Constructor Detail

Values

protected Values(org.apache.calcite.plan.RelOptCluster cluster,
                 List<org.apache.calcite.rel.hint.RelHint> hints,
                 org.apache.calcite.rel.type.RelDataType rowType,
                 com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> tuples,
                 org.apache.calcite.plan.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

hints - Hints for this node

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

protected Values(org.apache.calcite.plan.RelOptCluster cluster,
                 org.apache.calcite.rel.type.RelDataType rowType,
                 com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> tuples,
                 org.apache.calcite.plan.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

protected Values(org.apache.calcite.rel.RelInput input)

Creates a Values by parsing serialized output.

Method Detail

isEmpty

public static boolean isEmpty(Values values)

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.

isNotEmpty

public static boolean isNotEmpty(Values values)

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.

getTuples

public com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> getTuples(org.apache.calcite.rel.RelInput input)

getTuples

public com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableList<org.apache.calcite.rex.RexLiteral>> getTuples()

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

deriveRowType

protected org.apache.calcite.rel.type.RelDataType deriveRowType()

Overrides:

deriveRowType in class org.apache.calcite.rel.AbstractRelNode

computeSelfCost

public @Nullable org.apache.calcite.plan.RelOptCost computeSelfCost(org.apache.calcite.plan.RelOptPlanner planner,
                                                                    org.apache.calcite.rel.metadata.RelMetadataQuery mq)

Specified by:

computeSelfCost in interface org.apache.calcite.rel.RelNode

Overrides:

computeSelfCost in class org.apache.calcite.rel.AbstractRelNode

estimateRowCount

public double estimateRowCount(org.apache.calcite.rel.metadata.RelMetadataQuery mq)

Specified by:

estimateRowCount in interface org.apache.calcite.rel.RelNode

Overrides:

estimateRowCount in class org.apache.calcite.rel.AbstractRelNode

explainTerms

public org.apache.calcite.rel.RelWriter explainTerms(org.apache.calcite.rel.RelWriter pw)

Overrides:

explainTerms in class org.apache.calcite.rel.AbstractRelNode

getHints

public com.google.common.collect.ImmutableList<org.apache.calcite.rel.hint.RelHint> getHints()

Specified by:

getHints in interface org.apache.calcite.rel.hint.Hintable