org.apache.drill.exec.planner.physical

Class JoinPrel

java.lang.Object

org.apache.calcite.rel.AbstractRelNode

org.apache.calcite.rel.BiRel

org.apache.calcite.rel.core.Join

org.apache.drill.exec.planner.common.DrillJoinRelBase

org.apache.drill.exec.planner.physical.JoinPrel

All Implemented Interfaces:

Cloneable, Iterable<Prel>, org.apache.calcite.plan.RelOptNode, org.apache.calcite.rel.RelNode, DrillRelNode, DrillJoin, Prel

Direct Known Subclasses:

HashJoinPrel, MergeJoinPrel, NestedLoopJoinPrel, RowKeyJoinPrel

public abstract class JoinPrel
extends DrillJoinRelBase
implements Prel

Base class for MergeJoinPrel and HashJoinPrel

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 boolean	isSemiJoin
protected JoinUtils.JoinCategory	joincategory

Fields inherited from class org.apache.drill.exec.planner.common.DrillJoinRelBase

filterNulls, leftKeys, rightKeys

Fields inherited from class org.apache.calcite.rel.core.Join

condition, joinInfo, joinType, variablesSet

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

left, right

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

digest, id, rowType, traitSet

Fields inherited from interface org.apache.drill.exec.planner.physical.Prel

DRILL_PHYSICAL

Constructor Summary

Constructors

Constructor and Description
JoinPrel(org.apache.calcite.plan.RelOptCluster cluster, org.apache.calcite.plan.RelTraitSet traits, org.apache.calcite.rel.RelNode left, org.apache.calcite.rel.RelNode right, org.apache.calcite.rex.RexNode condition, org.apache.calcite.rel.core.JoinRelType joinType)
JoinPrel(org.apache.calcite.plan.RelOptCluster cluster, org.apache.calcite.plan.RelTraitSet traits, org.apache.calcite.rel.RelNode left, org.apache.calcite.rel.RelNode right, org.apache.calcite.rex.RexNode condition, org.apache.calcite.rel.core.JoinRelType joinType, boolean isSemiJoin)

Method Summary

Modifier and Type	Method and Description
<T,X,E extends Throwable> T	accept(PrelVisitor<T,X,E> logicalVisitor, X value)
protected void	buildJoinConditions(List<JoinCondition> conditions, List<String> leftFields, List<String> rightFields, List<Integer> leftKeys, List<Integer> rightKeys) Build the list of join conditions for this join.
org.apache.calcite.rel.type.RelDataType	deriveRowType()
org.apache.calcite.rel.RelNode	getJoinInput(int offset, org.apache.calcite.rel.RelNode input) Check to make sure that the fields of the inputs are the same as the output field names.
boolean	isSemiJoin()
boolean	isValid(org.apache.calcite.util.Litmus litmus, org.apache.calcite.rel.RelNode.Context context) A Drill physical rel which is semi join will have output row type with fields from only left side of the join.
Iterator<Prel>	iterator()
boolean	needsFinalColumnReordering()

Methods inherited from class org.apache.drill.exec.planner.common.DrillJoinRelBase

computeCartesianJoinCost, computeHashJoinCost, computeHashJoinCostWithRowCntKeySize, computeLogicalJoinCost, computeSelfCost, estimateRowCount, getLeftKeys, getRightKeys, isUnique, uniqueFieldNames

Methods inherited from class org.apache.calcite.rel.core.Join

accept, analyzeCondition, copy, copy, createJoinType, deriveJoinRowType, estimateJoinedRows, explainTerms, getChildExps, getCondition, getJoinType, getSystemFieldList, getVariablesSet, isSemiJoinDone

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

childrenAccept, getInputs, getLeft, getRight, replaceInput

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

accept, collectVariablesSet, collectVariablesUsed, computeDigest, computeSelfCost, equals, explain, getCluster, getCollationList, getConvention, getCorrelVariable, getDescription, getDigest, getExpectedInputRowType, getId, getInput, getQuery, getRelTypeName, getRows, getRowType, getTable, getTraitSet, getVariablesStopped, hashCode, isDistinct, isKey, isValid, metadata, onRegister, recomputeDigest, register, sole, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.drill.exec.planner.physical.Prel

getEncoding, getPhysicalOperator, getSupportedEncodings, prepareForLateralUnnestPipeline

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, metadata, onRegister, recomputeDigest, register, replaceInput

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

getCluster, getDescription, getDigest, getId, getTraitSet

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.apache.drill.exec.planner.logical.DrillJoin

getCondition, getJoinType, getLeft, getRight

Field Detail

isSemiJoin

protected final boolean isSemiJoin

joincategory

protected JoinUtils.JoinCategory joincategory

Constructor Detail

JoinPrel

public JoinPrel(org.apache.calcite.plan.RelOptCluster cluster,
                org.apache.calcite.plan.RelTraitSet traits,
                org.apache.calcite.rel.RelNode left,
                org.apache.calcite.rel.RelNode right,
                org.apache.calcite.rex.RexNode condition,
                org.apache.calcite.rel.core.JoinRelType joinType)

JoinPrel

public JoinPrel(org.apache.calcite.plan.RelOptCluster cluster,
                org.apache.calcite.plan.RelTraitSet traits,
                org.apache.calcite.rel.RelNode left,
                org.apache.calcite.rel.RelNode right,
                org.apache.calcite.rex.RexNode condition,
                org.apache.calcite.rel.core.JoinRelType joinType,
                boolean isSemiJoin)

Method Detail

accept

public <T,X,E extends Throwable> T accept(PrelVisitor<T,X,E> logicalVisitor,
                                          X value)
                                   throws E extends Throwable

Specified by:

accept in interface Prel

Throws:

E extends Throwable

iterator

public Iterator<Prel> iterator()

Specified by:

iterator in interface Iterable<Prel>

getJoinInput

public org.apache.calcite.rel.RelNode getJoinInput(int offset,
                                                   org.apache.calcite.rel.RelNode input)

Check to make sure that the fields of the inputs are the same as the output field names. If not, insert a project renaming them.

needsFinalColumnReordering

public boolean needsFinalColumnReordering()

Specified by:

needsFinalColumnReordering in interface Prel

buildJoinConditions

protected void buildJoinConditions(List<JoinCondition> conditions,
                                   List<String> leftFields,
                                   List<String> rightFields,
                                   List<Integer> leftKeys,
                                   List<Integer> rightKeys)

Build the list of join conditions for this join. A join condition is built only for equality and IS NOT DISTINCT FROM comparisons. The difference is: null == null is FALSE whereas null IS NOT DISTINCT FROM null is TRUE For a use case of the IS NOT DISTINCT FROM comparison, see AggregateRemoveRule

Parameters:

conditions - populated list of join conditions

leftFields - join fields from the left input

rightFields - join fields from the right input

isSemiJoin

public boolean isSemiJoin()

Specified by:

isSemiJoin in interface DrillJoin

Overrides:

isSemiJoin in class org.apache.calcite.rel.core.Join

isValid

public boolean isValid(org.apache.calcite.util.Litmus litmus,
                       org.apache.calcite.rel.RelNode.Context context)

A Drill physical rel which is semi join will have output row type with fields from only left side of the join. Calcite's join rel expects to have the output row type from left and right side of the join. This function is overloaded to not throw exceptions for a Drill semi join physical rel.

Specified by:

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

Overrides:

isValid in class org.apache.calcite.rel.core.Join

deriveRowType

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

Overrides:

deriveRowType in class org.apache.calcite.rel.core.Join