org.apache.calcite.rel.core

Class TableModify

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

org.apache.calcite.rel.SingleRel

org.apache.calcite.rel.core.TableModify

All Implemented Interfaces:

Cloneable, RelOptNode, RelNode

Direct Known Subclasses:

EnumerableTableModify, JdbcRules.JdbcTableModify, LogicalTableModify

public abstract class TableModify
extends SingleRel

Relational expression that modifies a table. It is similar to TableScan, but represents a request to modify a table rather than read from it. It takes one child which produces the modified rows. Those rows are:

• For INSERT, those rows are the new values;
• for DELETE, the old values;
• for UPDATE, all old values plus updated new values.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TableModify.Operation Enumeration of supported modification operations.

Field Summary

Fields

Modifier and Type	Field and Description
protected Prepare.CatalogReader	catalogReader The connection to the optimizing session.
protected RelOptTable	table The table definition.

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

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TableModify(RelOptCluster cluster, RelTraitSet traits, RelOptTable table, Prepare.CatalogReader catalogReader, RelNode child, TableModify.Operation operation, List<String> updateColumnList, boolean flattened)

Method Summary

Methods

Modifier and Type	Method and Description
RelOptCost	computeSelfCost(RelOptPlanner planner) Returns the cost of this plan (not including children).
RelDataType	deriveRowType()
RelWriter	explainTerms(RelWriter pw) Describes the inputs and attributes of this relational expression.
Prepare.CatalogReader	getCatalogReader()
RelDataType	getExpectedInputRowType(int ordinalInParent) Returns the type of the rows expected for an input.
TableModify.Operation	getOperation()
RelOptTable	getTable() If this relational expression represents an access to a table, returns that table, otherwise returns null.
List<String>	getUpdateColumnList()
boolean	isDelete()
boolean	isFlattened()
boolean	isInsert()
boolean	isMerge()
boolean	isUpdate()

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

childrenAccept, getInput, getInputs, getRows, replaceInput

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

accept, accept, collectVariablesSet, collectVariablesUsed, computeDigest, copy, explain, getChildExps, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getId, getInput, getQuery, getRelTypeName, getRowType, getTraitSet, getVariablesStopped, isDistinct, isKey, isValid, metadata, onRegister, recomputeDigest, register, sole, toString

Methods inherited from class java.lang.Object

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

Field Detail

catalogReader

protected Prepare.CatalogReader catalogReader

The connection to the optimizing session.

table

protected final RelOptTable table

The table definition.

Constructor Detail

TableModify

protected TableModify(RelOptCluster cluster,
           RelTraitSet traits,
           RelOptTable table,
           Prepare.CatalogReader catalogReader,
           RelNode child,
           TableModify.Operation operation,
           List<String> updateColumnList,
           boolean flattened)

Method Detail

getCatalogReader

public Prepare.CatalogReader getCatalogReader()

getTable

public RelOptTable getTable()

Description copied from interface: RelNode

If this relational expression represents an access to a table, returns that table, otherwise returns null.

Specified by:

getTable in interface RelNode

Overrides:

getTable in class AbstractRelNode

Returns:

If this relational expression represents an access to a table, returns that table, otherwise returns null

getUpdateColumnList

public List<String> getUpdateColumnList()

isFlattened

public boolean isFlattened()

getOperation

public TableModify.Operation getOperation()

isInsert

public boolean isInsert()

isUpdate

public boolean isUpdate()

isDelete

public boolean isDelete()

isMerge

public boolean isMerge()

deriveRowType

public RelDataType deriveRowType()

Overrides:

deriveRowType in class SingleRel

getExpectedInputRowType

public RelDataType getExpectedInputRowType(int ordinalInParent)

Description copied from interface: RelNode

Returns the type of the rows expected for an input. Defaults to RelNode.getRowType().

Specified by:

getExpectedInputRowType in interface RelNode

Overrides:

getExpectedInputRowType in class AbstractRelNode

Parameters:

ordinalInParent - input's 0-based ordinal with respect to this parent rel

Returns:

expected row type

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 SingleRel

Parameters:

pw - Plan writer

Returns:

Plan writer for fluent-explain pattern

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)