Package org.apache.calcite.sql.validate

Class SqlValidatorImpl.DmlNamespace

java.lang.Object

org.apache.calcite.sql.validate.IdentifierNamespace

org.apache.calcite.sql.validate.SqlValidatorImpl.DmlNamespace

All Implemented Interfaces:

SqlValidatorNamespace

Enclosing class:

SqlValidatorImpl

public static class SqlValidatorImpl.DmlNamespace
extends IdentifierNamespace

Common base class for DML statement namespaces.

Field Summary

Fields

Modifier and Type	Field	Description
protected final @Nullable SqlNode	enclosingNode
protected FilterRequirement	filterRequirement	Information about what fields need to be filtered and what bypass fields can defuse the errors if they are filtered on as an alternative.
protected @Nullable RelDataType	rowType	Type of the output row, which comprises the name and type of each output column.
protected @Nullable RelDataType	type	As rowType, but not necessarily a struct.
protected final SqlValidatorImpl	validator

Fields inherited from class org.apache.calcite.sql.validate.IdentifierNamespace

extendList

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DmlNamespace(SqlValidatorImpl validator, SqlNode id, SqlNode enclosingNode, SqlValidatorScope parentScope)

Method Summary

Modifier and Type	Method	Description
protected RelDataType	convertToStruct(RelDataType type)
@Nullable RelDataTypeField	field(String name)	Returns a field of a given name, or null.
@Nullable SqlNode	getEnclosingNode()	Returns the parse tree node that at is at the root of this namespace and includes all decorations.
FilterRequirement	getFilterRequirement()	Returns a FilterRequirement object describing the "must-filter" fields of this namespace (fields that must be filtered in a query) and "bypass" fields that can remove the requirement that fields are filtered.
RelDataType	getRowType()	Returns the row type of this namespace, which comprises a list of names and types of the output columns.
RelDataType	getRowTypeSansSystemColumns()	Returns the row type of this namespace, sans any system columns.
RelDataType	getType()	Returns the type of this namespace.
SqlValidator	getValidator()	Returns the validator.
boolean	isWrapperFor(Class<?> clazz)	Returns whether this namespace implements a given interface, or wraps a class which does.
@Nullable SqlValidatorNamespace	lookupChild(String name)	Looks up a child namespace of a given name.
void	makeNullable()
void	setType(RelDataType type)	Sets the type of this namespace.
protected RelDataType	toStruct(RelDataType type, @Nullable SqlNode unnest)	Converts a type to a struct if it is not already.
String	translate(String name)
<T> @Nullable T	unwrap(Class<T> clazz)	Returns this namespace, or a wrapped namespace, cast to a particular class.
final void	validate(RelDataType targetRowType)	Validates this namespace.

Methods inherited from class org.apache.calcite.sql.validate.IdentifierNamespace

getId, getMonotonicExprs, getMonotonicity, getNode, getTable, resolve, split, supportsModality, validateImpl

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.calcite.sql.validate.SqlValidatorNamespace

fieldExists

Field Details

validator

protected final SqlValidatorImpl validator

rowType

protected @Nullable RelDataType rowType

Type of the output row, which comprises the name and type of each output column. Set on validate.

type

protected @Nullable RelDataType type

As rowType, but not necessarily a struct.

filterRequirement

protected FilterRequirement filterRequirement

Information about what fields need to be filtered and what bypass fields can defuse the errors if they are filtered on as an alternative. Initialized as an empty object, but typically re-assigned during validation.

enclosingNode

protected final @Nullable SqlNode enclosingNode

Constructor Details

DmlNamespace

protected DmlNamespace(SqlValidatorImpl validator,
 SqlNode id,
 SqlNode enclosingNode,
 SqlValidatorScope parentScope)

Method Details

getValidator

public SqlValidator getValidator()

Description copied from interface: SqlValidatorNamespace

Returns the validator.

Specified by:

getValidator in interface SqlValidatorNamespace

Returns:

validator

validate

public final void validate(RelDataType targetRowType)

Description copied from interface: SqlValidatorNamespace

Validates this namespace.

If the scope has already been validated, does nothing.

Please call SqlValidatorImpl.validateNamespace(org.apache.calcite.sql.validate.SqlValidatorNamespace, org.apache.calcite.rel.type.RelDataType) rather than calling this method directly.

Specified by:

validate in interface SqlValidatorNamespace

Parameters:

targetRowType - Desired row type, must not be null, may be the data type 'unknown'.

getRowType

public RelDataType getRowType()

Description copied from interface: SqlValidatorNamespace

Returns the row type of this namespace, which comprises a list of names and types of the output columns. If the scope's type has not yet been derived, derives it.

Specified by:

getRowType in interface SqlValidatorNamespace

Returns:

Row type of this namespace, never null, always a struct

getRowTypeSansSystemColumns

public RelDataType getRowTypeSansSystemColumns()

Description copied from interface: SqlValidatorNamespace

Returns the row type of this namespace, sans any system columns.

Specified by:

getRowTypeSansSystemColumns in interface SqlValidatorNamespace

Returns:

Row type sans system columns

getType

public RelDataType getType()

Description copied from interface: SqlValidatorNamespace

Returns the type of this namespace.

Specified by:

getType in interface SqlValidatorNamespace

Returns:

Row type converted to struct

setType

public void setType(RelDataType type)

Description copied from interface: SqlValidatorNamespace

Sets the type of this namespace.

Allows the type for the namespace to be explicitly set, but usually is called during SqlValidatorNamespace.validate(RelDataType).

Implicitly also sets the row type. If the type is not a struct, then the row type is the type wrapped as a struct with a single column, otherwise the type and row type are the same.

Specified by:

setType in interface SqlValidatorNamespace

getEnclosingNode

public @Nullable SqlNode getEnclosingNode()

Description copied from interface: SqlValidatorNamespace

Returns the parse tree node that at is at the root of this namespace and includes all decorations. If there are no decorations, returns the same as SqlValidatorNamespace.getNode().

Specified by:

getEnclosingNode in interface SqlValidatorNamespace

lookupChild

public @Nullable SqlValidatorNamespace lookupChild(String name)

Description copied from interface: SqlValidatorNamespace

Looks up a child namespace of a given name.

For example, in the query select e.name from emps as e, e is an IdentifierNamespace which has a child name which is a FieldNamespace.

Specified by:

lookupChild in interface SqlValidatorNamespace

Parameters:

name - Name of namespace

Returns:

Namespace

field

public @Nullable RelDataTypeField field(String name)

Description copied from interface: SqlValidatorNamespace

Returns a field of a given name, or null.

Specified by:

field in interface SqlValidatorNamespace

Parameters:

name - Field name

Returns:

Field, or null

getFilterRequirement

public FilterRequirement getFilterRequirement()

Description copied from interface: SqlValidatorNamespace

Returns a FilterRequirement object describing the "must-filter" fields of this namespace (fields that must be filtered in a query) and "bypass" fields that can remove the requirement that fields are filtered.

Specified by:

getFilterRequirement in interface SqlValidatorNamespace

makeNullable

public void makeNullable()

Specified by:

makeNullable in interface SqlValidatorNamespace

translate

public String translate(String name)

unwrap

public <T> @Nullable T unwrap(Class<T> clazz)

Description copied from interface: SqlValidatorNamespace

Returns this namespace, or a wrapped namespace, cast to a particular class.

Specified by:

unwrap in interface SqlValidatorNamespace

Parameters:

clazz - Desired type

Returns:

This namespace cast to desired type

isWrapperFor

public boolean isWrapperFor(Class<?> clazz)

Description copied from interface: SqlValidatorNamespace

Returns whether this namespace implements a given interface, or wraps a class which does.

Specified by:

isWrapperFor in interface SqlValidatorNamespace

Parameters:

clazz - Interface

Returns:

Whether namespace implements given interface

convertToStruct

protected RelDataType convertToStruct(RelDataType type)

toStruct

protected RelDataType toStruct(RelDataType type,
 @Nullable SqlNode unnest)

Converts a type to a struct if it is not already.