io.druid.sql.calcite.rel

Class DruidRel<T extends DruidRel>

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

io.druid.sql.calcite.rel.DruidRel<T>

All Implemented Interfaces:

Cloneable, org.apache.calcite.interpreter.BindableRel, org.apache.calcite.interpreter.InterpretableRel, org.apache.calcite.plan.RelOptNode, org.apache.calcite.rel.RelNode, org.apache.calcite.runtime.ArrayBindable, org.apache.calcite.runtime.Bindable<Object[]>, org.apache.calcite.runtime.Typed

Direct Known Subclasses:

DruidOuterQueryRel, DruidQueryRel, DruidSemiJoin

public abstract class DruidRel<T extends DruidRel>
extends org.apache.calcite.rel.AbstractRelNode
implements org.apache.calcite.interpreter.BindableRel

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.calcite.interpreter.InterpretableRel

org.apache.calcite.interpreter.InterpretableRel.InterpreterImplementor

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

org.apache.calcite.rel.RelNode.Context

Field Summary

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

digest, id, rowType, traitSet

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DruidRel(org.apache.calcite.plan.RelOptCluster cluster, org.apache.calcite.plan.RelTraitSet traitSet, QueryMaker queryMaker)

Method Summary

Modifier and Type	Method and Description
abstract T	asBindable()
abstract T	asDruidConvention()
org.apache.calcite.linq4j.Enumerable<Object[]>	bind(org.apache.calcite.DataContext dataContext)
abstract List<String>	getDatasourceNames() Get a list of names of datasources read by this DruidRel
Class<Object[]>	getElementType()
abstract PartialDruidQuery	getPartialDruidQuery()
PlannerContext	getPlannerContext()
abstract int	getQueryCount() Return the number of Druid queries this rel involves, including sub-queries.
QueryMaker	getQueryMaker()
org.apache.calcite.interpreter.Node	implement(org.apache.calcite.interpreter.InterpretableRel.InterpreterImplementor implementor)
boolean	isValidDruidQuery()
abstract io.druid.java.util.common.guava.Sequence<Object[]>	runQuery()
abstract DruidQuery	toDruidQuery(boolean finalizeAggregations) Convert this DruidRel to a DruidQuery.
abstract DruidQuery	toDruidQueryForExplaining() Convert this DruidRel to a DruidQuery for purposes of explaining.
abstract T	withPartialQuery(PartialDruidQuery newQueryBuilder)

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

accept, accept, childrenAccept, collectVariablesSet, collectVariablesUsed, computeDigest, computeSelfCost, computeSelfCost, copy, deriveRowType, estimateRowCount, explain, explainTerms, getChildExps, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getInputs, getQuery, getRelTypeName, getRows, getRowType, getTable, getTraitSet, getVariablesSet, getVariablesStopped, isDistinct, isKey, isValid, 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

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

accept, accept, childrenAccept, collectVariablesSet, collectVariablesUsed, computeSelfCost, computeSelfCost, copy, estimateRowCount, explain, getChildExps, getCollationList, getConvention, getCorrelVariable, getExpectedInputRowType, getInput, getInputs, getQuery, getRelTypeName, getRows, getRowType, getTable, getVariablesSet, getVariablesStopped, isDistinct, isKey, isValid, isValid, metadata, onRegister, recomputeDigest, register, replaceInput

Methods inherited from interface org.apache.calcite.plan.RelOptNode

getCluster, getDescription, getDigest, getId, getTraitSet

Constructor Detail

DruidRel

protected DruidRel(org.apache.calcite.plan.RelOptCluster cluster,
                   org.apache.calcite.plan.RelTraitSet traitSet,
                   QueryMaker queryMaker)

Method Detail

getPartialDruidQuery

public abstract PartialDruidQuery getPartialDruidQuery()

getQueryCount

public abstract int getQueryCount()

Return the number of Druid queries this rel involves, including sub-queries. Simple queries will return 1.

Returns:

number of nested queries

runQuery

public abstract io.druid.java.util.common.guava.Sequence<Object[]> runQuery()

withPartialQuery

public abstract T withPartialQuery(PartialDruidQuery newQueryBuilder)

isValidDruidQuery

public boolean isValidDruidQuery()

toDruidQuery

@Nullable
public abstract DruidQuery toDruidQuery(boolean finalizeAggregations)

Convert this DruidRel to a DruidQuery. This may be an expensive operation. For example, DruidSemiJoin needs to execute the right-hand side query in order to complete this method. This method may return null if it knows that this rel will yield an empty result set.

Parameters:

finalizeAggregations - true if this query should include explicit finalization for all of its aggregators, where required. Useful for subqueries where Druid's native query layer does not do this automatically.

Returns:

query, or null if it is known in advance that this rel will yield an empty result set.

Throws:

CannotBuildQueryException

toDruidQueryForExplaining

public abstract DruidQuery toDruidQueryForExplaining()

Convert this DruidRel to a DruidQuery for purposes of explaining. This must be an inexpensive operation. For example, DruidSemiJoin will use a dummy dataSource in order to complete this method, rather than executing the right-hand side query. This method may not return null.

Returns:

query

Throws:

CannotBuildQueryException

asBindable

public abstract T asBindable()

getQueryMaker

public QueryMaker getQueryMaker()

getPlannerContext

public PlannerContext getPlannerContext()

asDruidConvention

public abstract T asDruidConvention()

getDatasourceNames

public abstract List<String> getDatasourceNames()

Get a list of names of datasources read by this DruidRel

getElementType

public Class<Object[]> getElementType()

Specified by:

getElementType in interface org.apache.calcite.runtime.ArrayBindable

Specified by:

getElementType in interface org.apache.calcite.runtime.Typed

implement

public org.apache.calcite.interpreter.Node implement(org.apache.calcite.interpreter.InterpretableRel.InterpreterImplementor implementor)

Specified by:

implement in interface org.apache.calcite.interpreter.InterpretableRel

bind

public org.apache.calcite.linq4j.Enumerable<Object[]> bind(org.apache.calcite.DataContext dataContext)

Specified by:

bind in interface org.apache.calcite.runtime.Bindable<Object[]>