org.apache.calcite.prepare

Class PlannerImpl

java.lang.Object

org.apache.calcite.prepare.PlannerImpl

All Implemented Interfaces:

Planner

public class PlannerImpl
extends Object
implements Planner

Implementation of Planner.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	PlannerImpl.ViewExpanderImpl Implements RelOptTable.ViewExpander interface for Planner.

Constructor Summary

Constructors

Constructor and Description
PlannerImpl(FrameworkConfig config) Creates a planner.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Releases all internal resources utilized while this Planner exists.
RelNode	convert(SqlNode sql) Converts a SQL parse tree into a tree of relational expressions.
RelTraitSet	getEmptyTraitSet()
JavaTypeFactory	getTypeFactory() Returns the type factory.
SqlNode	parse(String sql) Parses and validates a SQL statement.
void	reset() Resets this Planner to be used with a new query.
RelNode	transform(int ruleSetIndex, RelTraitSet requiredOutputTraits, RelNode rel) Converts one relational expression tree into another relational expression based on a particular rule set and requires set of traits.
SqlNode	validate(SqlNode sqlNode) Validates a SQL statement.

Methods inherited from class java.lang.Object

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

Constructor Detail

PlannerImpl

public PlannerImpl(FrameworkConfig config)

Creates a planner. Not a public API; call Frameworks.getPlanner(org.apache.calcite.tools.FrameworkConfig) instead.

Method Detail

getEmptyTraitSet

public RelTraitSet getEmptyTraitSet()

Specified by:

getEmptyTraitSet in interface Planner

close

public void close()

Description copied from interface: Planner

Releases all internal resources utilized while this Planner exists. Once called, this Planner object is no longer valid.

Specified by:

close in interface Planner

reset

public void reset()

Description copied from interface: Planner

Resets this Planner to be used with a new query. This should be called between each new query.

Specified by:

reset in interface Planner

parse

public SqlNode parse(String sql)
              throws SqlParseException

Description copied from interface: Planner

Parses and validates a SQL statement.

Specified by:

parse in interface Planner

Parameters:

sql - The SQL statement to parse.

Returns:

The root node of the SQL parse tree.

Throws:

SqlParseException - on parse error

validate

public SqlNode validate(SqlNode sqlNode)
                 throws ValidationException

Description copied from interface: Planner

Validates a SQL statement.

Specified by:

validate in interface Planner

Parameters:

sqlNode - Root node of the SQL parse tree.

Returns:

Validated node

Throws:

ValidationException - if not valid

convert

public RelNode convert(SqlNode sql)
                throws RelConversionException

Description copied from interface: Planner

Converts a SQL parse tree into a tree of relational expressions.

You must call Planner.validate(org.apache.calcite.sql.SqlNode) first.

Specified by:

convert in interface Planner

Parameters:

sql - The root node of the SQL parse tree.

Returns:

The root node of the newly generated RelNode tree.

Throws:

RelConversionException - if the node cannot be converted or has not been validated

getTypeFactory

public JavaTypeFactory getTypeFactory()

Description copied from interface: Planner

Returns the type factory.

Specified by:

getTypeFactory in interface Planner

transform

public RelNode transform(int ruleSetIndex,
                RelTraitSet requiredOutputTraits,
                RelNode rel)
                  throws RelConversionException

Description copied from interface: Planner

Converts one relational expression tree into another relational expression based on a particular rule set and requires set of traits.

Specified by:

transform in interface Planner

Parameters:

ruleSetIndex - The RuleSet to use for conversion purposes. Note that this is zero-indexed and is based on the list and order of RuleSets provided in the construction of this Planner.

requiredOutputTraits - The set of RelTraits required of the root node at the termination of the planning cycle.

rel - The root of the RelNode tree to convert.

Returns:

The root of the new RelNode tree.

Throws:

RelConversionException - on conversion error