Package org.apache.calcite.rel.rules

Class JoinPushThroughJoinRule

java.lang.Object

org.apache.calcite.plan.RelOptRule

org.apache.calcite.plan.RelRule<JoinPushThroughJoinRule.Config>

org.apache.calcite.rel.rules.JoinPushThroughJoinRule

All Implemented Interfaces:

TransformationRule

@Enclosing
public class JoinPushThroughJoinRule
extends RelRule<JoinPushThroughJoinRule.Config>
implements TransformationRule

Rule that pushes the right input of a join into through the left input of the join, provided that the left input is also a join.

Thus, (A join B) join C becomes (A join C) join B. The advantage of applying this rule is that it may be possible to apply conditions earlier. For instance,

(sales as s join product_class as pc on true)
 join product as p
 on s.product_id = p.product_id
 and p.product_class_id = pc.product_class_id

becomes

(sales as s join product as p on s.product_id = p.product_id)
 join product_class as pc
 on p.product_class_id = pc.product_class_id

Before the rule, one join has two conditions and the other has none (ON TRUE). After the rule, each join has one condition.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	JoinPushThroughJoinRule.Config	Rule configuration.

Nested classes/interfaces inherited from class org.apache.calcite.plan.RelRule

RelRule.Done, RelRule.MatchHandler<R extends RelOptRule>, RelRule.OperandBuilder, RelRule.OperandDetailBuilder<R extends RelNode>, RelRule.OperandTransform

Nested classes/interfaces inherited from class org.apache.calcite.plan.RelOptRule

RelOptRule.ConverterRelOptRuleOperand

Field Summary

Fields

Modifier and Type	Field	Description
static final JoinPushThroughJoinRule	LEFT	Instance of the rule that works on logical joins only, and pushes to the left.
static final JoinPushThroughJoinRule	RIGHT	Instance of the rule that works on logical joins only, and pushes to the right.

Fields inherited from class org.apache.calcite.plan.RelRule

config

Fields inherited from class org.apache.calcite.plan.RelOptRule

description, operands, relBuilderFactory

Constructor Summary

Constructors

Modifier	Constructor	Description
	JoinPushThroughJoinRule(String description, boolean right, Class<? extends Join> joinClass, RelFactories.ProjectFactory projectFactory)	Deprecated.
	JoinPushThroughJoinRule(String description, boolean right, Class<? extends Join> joinClass, RelBuilderFactory relBuilderFactory)	Deprecated.
protected	JoinPushThroughJoinRule(JoinPushThroughJoinRule.Config config)	Creates a JoinPushThroughJoinRule.

Method Summary

Modifier and Type	Method	Description
void	onMatch(RelOptRuleCall call)	Receives notification about a rule match.

Methods inherited from class org.apache.calcite.plan.RelOptRule

any, convert, convert, convert, convert, convertList, convertOperand, convertOperand, equals, equals, getOperand, getOperands, getOutConvention, getOutTrait, hashCode, matches, none, operand, operand, operand, operand, operand, operandJ, operandJ, some, toString, unordered

Methods inherited from class java.lang.Object

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

Field Details

RIGHT

public static final JoinPushThroughJoinRule RIGHT

Instance of the rule that works on logical joins only, and pushes to the right.

LEFT

public static final JoinPushThroughJoinRule LEFT

Instance of the rule that works on logical joins only, and pushes to the left.

Constructor Details

JoinPushThroughJoinRule

protected JoinPushThroughJoinRule(JoinPushThroughJoinRule.Config config)

Creates a JoinPushThroughJoinRule.

JoinPushThroughJoinRule

@Deprecated
public JoinPushThroughJoinRule(String description,
 boolean right,
 Class<? extends Join> joinClass,
 RelBuilderFactory relBuilderFactory)

Deprecated.

JoinPushThroughJoinRule

@Deprecated
public JoinPushThroughJoinRule(String description,
 boolean right,
 Class<? extends Join> joinClass,
 RelFactories.ProjectFactory projectFactory)

Deprecated.

Method Details

onMatch

public void onMatch(RelOptRuleCall call)

Description copied from class: RelOptRule

Receives notification about a rule match. At the time that this method is called, call.rels holds the set of relational expressions which match the operands to the rule; call.rels[0] is the root expression.

Typically a rule would check that the nodes are valid matches, creates a new expression, then calls back RelOptRuleCall.transformTo(org.apache.calcite.rel.RelNode, java.util.Map<org.apache.calcite.rel.RelNode, org.apache.calcite.rel.RelNode>, org.apache.calcite.plan.RelHintsPropagator) to register the expression.

Specified by:

onMatch in class RelOptRule

Parameters:

call - Rule call

See Also:

• RelOptRule.matches(RelOptRuleCall)