LoptMultiJoin (Apache Calcite API)

java.lang.Object
- org.apache.calcite.rel.rules.LoptMultiJoin

```
public class LoptMultiJoin
extends Object
```
Utility class that keeps track of the join factors that make up a MultiJoin.

Constructor Summary

Constructors
Constructor and Description

LoptMultiJoin(MultiJoin multiJoin)

Constructors
Constructor and Description
`LoptMultiJoin(MultiJoin multiJoin)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addRemovableOuterJoinFactor(int factIdx)` Adds a join factor to the set of factors that can be removed because the factor is the null generating factor in an outer join, its join keys are unique, and the factor is not projected in the query
`void`	`addRemovableSelfJoinPair(int factor1, int factor2)` Adds to a map that keeps track of removable self-join pairs.
`org.apache.calcite.rel.rules.LoptMultiJoin.Edge`	`createEdge(RexNode condition)`
`int`	`findRef(int rexInputRef)` Determines the join factor corresponding to a RexInputRef
`void`	`getChildFactors(LoptJoinTree joinTree, ImmutableBitSet.Builder childFactors)` Deprecated.
`ImmutableBitSet`	`getFactorsRefByFactor(int factIdx)`
`ImmutableBitSet`	`getFactorsRefByJoinFilter(RexNode joinFilter)`
`int[][]`	`getFactorWeights()`
`ImmutableBitSet`	`getFieldsRefByJoinFilter(RexNode joinFilter)`
`RelNode`	`getJoinFactor(int factIdx)`
`int[]`	`getJoinFieldRefCounts(int factIdx)`
`List<RelDataTypeField>`	`getJoinFields(LoptJoinTree left, LoptJoinTree right)` Retrieves the fields corresponding to a join between a left and right tree
`List<RexNode>`	`getJoinFilters()`
`Integer`	`getJoinRemovalFactor(int dimIdx)`
`SemiJoin`	`getJoinRemovalSemiJoin(int dimIdx)`
`int`	`getJoinStart(int factIdx)`
`List<RelDataTypeField>`	`getMultiJoinFields()` Returns array of fields contained within the multi-join
`MultiJoin`	`getMultiJoinRel()`
`int`	`getNumFieldsInJoinFactor(int factIdx)`
`int`	`getNumJoinFactors()`
`int`	`getNumTotalFields()`
`Integer`	`getOtherSelfJoinFactor(int factIdx)` Returns the other factor in a self-join pair if the factor passed in is a factor in a removable self-join; otherwise, returns null.
`RexNode`	`getOuterJoinCond(int factIdx)`
`ImmutableBitSet`	`getOuterJoinFactors(int factIdx)`
`ImmutableBitSet`	`getProjFields(int factIdx)`
`Integer`	`getRightColumnMapping(int rightFactor, int rightOffset)` Determines whether there is a mapping from a column in the right factor of a self-join to a column from the left factor.
`boolean`	`hasAllFactors(LoptJoinTree joinTree, BitSet factorsNeeded)` Returns true if a join tree contains all factors required
`boolean`	`isLeftFactorInRemovableSelfJoin(int factIdx)`
`boolean`	`isNullGenerating(int factIdx)`
`boolean`	`isRemovableOuterJoinFactor(int factIdx)`
`boolean`	`isRightFactorInRemovableSelfJoin(int factIdx)`
`void`	`setFactorWeights()` Sets weighting for each combination of factors, depending on which join filters reference which factors.
`void`	`setJoinRemovalFactor(int dimIdx, int factIdx)` Indicates that a dimension factor's join can be removed because of a semijoin with a fact table.
`void`	`setJoinRemovalSemiJoin(int dimIdx, SemiJoin semiJoin)` Indicates the semijoin that allows the join of a dimension table to be removed

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - LoptMultiJoin
```
public LoptMultiJoin(MultiJoin multiJoin)
```
- Method Detail
  - getMultiJoinRel
```
public MultiJoin getMultiJoinRel()
```
    Returns:
    
    the MultiJoin corresponding to this multijoin
  - getNumJoinFactors
```
public int getNumJoinFactors()
```
    Returns:
    
    number of factors in this multijoin
  - getJoinFactor
```
public RelNode getJoinFactor(int factIdx)
```
    Parameters:
    
    factIdx - factor to be returned
    
    Returns:
    
    factor corresponding to the factor index passed in
  - getNumTotalFields
```
public int getNumTotalFields()
```
    Returns:
    
    total number of fields in the multijoin
  - getNumFieldsInJoinFactor
```
public int getNumFieldsInJoinFactor(int factIdx)
```
    Parameters:
    
    factIdx - desired factor
    
    Returns:
    
    number of fields in the specified factor
  - getJoinFilters
```
public List<RexNode> getJoinFilters()
```
    Returns:
    
    all non-outer join filters in this multijoin
  - getFactorsRefByJoinFilter
```
public ImmutableBitSet getFactorsRefByJoinFilter(RexNode joinFilter)
```
    Parameters:
    
    joinFilter - filter for which information will be returned
    
    Returns:
    
    bitmap corresponding to the factors referenced within the specified join filter
  - getMultiJoinFields
```
public List<RelDataTypeField> getMultiJoinFields()
```
    Returns array of fields contained within the multi-join
  - getFieldsRefByJoinFilter
```
public ImmutableBitSet getFieldsRefByJoinFilter(RexNode joinFilter)
```
    Parameters:
    
    joinFilter - the filter for which information will be returned
    
    Returns:
    
    bitmap corresponding to the fields referenced by a join filter
  - getFactorWeights
```
public int[][] getFactorWeights()
```
    Returns:
    
    weights of the different factors relative to one another
  - getFactorsRefByFactor
```
public ImmutableBitSet getFactorsRefByFactor(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    bitmap corresponding to the factors referenced by the specified factor in the various join filters that correspond to comparisons
  - getJoinStart
```
public int getJoinStart(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    starting offset within the multijoin for the specified factor
  - isNullGenerating
```
public boolean isNullGenerating(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    whether or not the factor corresponds to a null-generating factor in a left or right outer join
  - getOuterJoinFactors
```
public ImmutableBitSet getOuterJoinFactors(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    bitmap containing the factors that a null generating factor is dependent upon, if the factor is null generating in a left or right outer join; otherwise null is returned
  - getOuterJoinCond
```
public RexNode getOuterJoinCond(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    outer join conditions associated with the specified null generating factor
  - getProjFields
```
public ImmutableBitSet getProjFields(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    bitmap containing the fields that are projected from a factor
  - getJoinFieldRefCounts
```
public int[] getJoinFieldRefCounts(int factIdx)
```
    Parameters:
    
    factIdx - factor for which information will be returned
    
    Returns:
    
    the join field reference counts for a factor
  - getJoinRemovalFactor
```
public Integer getJoinRemovalFactor(int dimIdx)
```
    Parameters:
    
    dimIdx - the dimension factor for which information will be returned
    
    Returns:
    
    the factor id of the fact table corresponding to a dimension table in a semijoin, in the case where the join with the dimension table can be removed
  - getJoinRemovalSemiJoin
```
public SemiJoin getJoinRemovalSemiJoin(int dimIdx)
```
    Parameters:
    
    dimIdx - the dimension factor for which information will be returned
    
    Returns:
    
    the semijoin that allows the join of a dimension table to be removed
  - setJoinRemovalFactor
```
public void setJoinRemovalFactor(int dimIdx,
                                 int factIdx)
```
    Indicates that a dimension factor's join can be removed because of a semijoin with a fact table.
    
    Parameters:
    
    dimIdx - id of the dimension factor
    
    factIdx - id of the fact factor
  - setJoinRemovalSemiJoin
```
public void setJoinRemovalSemiJoin(int dimIdx,
                                   SemiJoin semiJoin)
```
    Indicates the semijoin that allows the join of a dimension table to be removed
    
    Parameters:
    
    dimIdx - id of the dimension factor
    
    semiJoin - the semijoin
  - findRef
```
public int findRef(int rexInputRef)
```
    Determines the join factor corresponding to a RexInputRef
    
    Parameters:
    
    rexInputRef - rexInputRef index
    
    Returns:
    
    index corresponding to join factor
  - setFactorWeights
```
public void setFactorWeights()
```
    Sets weighting for each combination of factors, depending on which join filters reference which factors. Greater weight is given to equality conditions. Also, sets bitmaps indicating which factors are referenced by each factor within join filters that are comparisons.
  - hasAllFactors
```
public boolean hasAllFactors(LoptJoinTree joinTree,
                             BitSet factorsNeeded)
```
    Returns true if a join tree contains all factors required
    
    Parameters:
    
    joinTree - join tree to be examined
    
    factorsNeeded - bitmap of factors required
    
    Returns:
    
    true if join tree contains all required factors
  - getChildFactors
```
@Deprecated
public void getChildFactors(LoptJoinTree joinTree,
                                        ImmutableBitSet.Builder childFactors)
```
    Deprecated.
    
    Sets a bitmap indicating all child RelNodes in a join tree
    
    Parameters:
    
    joinTree - join tree to be examined
    
    childFactors - bitmap to be set
  - getJoinFields
```
public List<RelDataTypeField> getJoinFields(LoptJoinTree left,
                                            LoptJoinTree right)
```
    Retrieves the fields corresponding to a join between a left and right tree
    
    Parameters:
    
    left - left hand side of the join
    
    right - right hand side of the join
    
    Returns:
    
    fields of the join
  - addRemovableOuterJoinFactor
```
public void addRemovableOuterJoinFactor(int factIdx)
```
    Adds a join factor to the set of factors that can be removed because the factor is the null generating factor in an outer join, its join keys are unique, and the factor is not projected in the query
    
    Parameters:
    
    factIdx - join factor
  - isRemovableOuterJoinFactor
```
public boolean isRemovableOuterJoinFactor(int factIdx)
```
    Parameters:
    
    factIdx - factor in question
    
    Returns:
    
    true if the factor corresponds to the null generating factor in an outer join that can be removed
  - addRemovableSelfJoinPair
```
public void addRemovableSelfJoinPair(int factor1,
                                     int factor2)
```
    Adds to a map that keeps track of removable self-join pairs.
    
    Parameters:
    
    factor1 - one of the factors in the self-join
    
    factor2 - the second factor in the self-join
  - getOtherSelfJoinFactor
```
public Integer getOtherSelfJoinFactor(int factIdx)
```
    Returns the other factor in a self-join pair if the factor passed in is a factor in a removable self-join; otherwise, returns null.
    
    Parameters:
    
    factIdx - one of the factors in a self-join pair
  - isLeftFactorInRemovableSelfJoin
```
public boolean isLeftFactorInRemovableSelfJoin(int factIdx)
```
    Parameters:
    
    factIdx - factor in a self-join
    
    Returns:
    
    true if the factor is the left factor in a self-join
  - isRightFactorInRemovableSelfJoin
```
public boolean isRightFactorInRemovableSelfJoin(int factIdx)
```
    Parameters:
    
    factIdx - factor in a self-join
    
    Returns:
    
    true if the factor is the right factor in a self-join
  - getRightColumnMapping
```
public Integer getRightColumnMapping(int rightFactor,
                                     int rightOffset)
```
    Determines whether there is a mapping from a column in the right factor of a self-join to a column from the left factor. Assumes that the right factor is a part of a self-join.
    
    Parameters:
    
    rightFactor - the index of the right factor
    
    rightOffset - the column offset of the right factor
    
    Returns:
    
    the offset of the corresponding column in the left factor, if such a column mapping exists; otherwise, null is returned
  - createEdge
```
public org.apache.calcite.rel.rules.LoptMultiJoin.Edge createEdge(RexNode condition)
```

Class LoptMultiJoin

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LoptMultiJoin

Method Detail

getMultiJoinRel

getNumJoinFactors

getJoinFactor

getNumTotalFields

getNumFieldsInJoinFactor

getJoinFilters

getFactorsRefByJoinFilter

getMultiJoinFields

getFieldsRefByJoinFilter

getFactorWeights

getFactorsRefByFactor

getJoinStart

isNullGenerating

getOuterJoinFactors

getOuterJoinCond

getProjFields

getJoinFieldRefCounts

getJoinRemovalFactor

getJoinRemovalSemiJoin

setJoinRemovalFactor

setJoinRemovalSemiJoin

findRef

setFactorWeights

hasAllFactors

getChildFactors

getJoinFields

addRemovableOuterJoinFactor

isRemovableOuterJoinFactor

addRemovableSelfJoinPair

getOtherSelfJoinFactor

isLeftFactorInRemovableSelfJoin

isRightFactorInRemovableSelfJoin

getRightColumnMapping

createEdge