org.apache.hadoop.hive.ql.exec.vector.mapjoin

Class VectorMapJoinGenerateResultOperator

java.lang.Object

org.apache.hadoop.hive.ql.exec.Operator<T>

org.apache.hadoop.hive.ql.exec.CommonJoinOperator<T>

org.apache.hadoop.hive.ql.exec.AbstractMapJoinOperator<MapJoinDesc>

org.apache.hadoop.hive.ql.exec.MapJoinOperator

org.apache.hadoop.hive.ql.exec.vector.mapjoin.VectorMapJoinCommonOperator

org.apache.hadoop.hive.ql.exec.vector.mapjoin.VectorMapJoinGenerateResultOperator

All Implemented Interfaces:

Serializable, Cloneable, VectorizationContextRegion, Node

Direct Known Subclasses:

VectorMapJoinInnerBigOnlyGenerateResultOperator, VectorMapJoinInnerGenerateResultOperator, VectorMapJoinLeftSemiGenerateResultOperator, VectorMapJoinOuterGenerateResultOperator

public abstract class VectorMapJoinGenerateResultOperator
extends VectorMapJoinCommonOperator

This class has methods for generating vectorized join results and forwarding batchs. In some cases when can forward the big table batch by setting scratch columns with small table results and then making use of our output projection to pick out all the output result columns. This can improve performance by avoiding copying big table values. So, we will use the big table batch's selected in use to represent those rows. At the same time, some output results need to be formed in the overflow batch. For example, to form N x M cross product output results. In this case, we will copy big table values into the overflow batch and set scratch columns in it for small table results. The "schema" of the overflow batch is the same as the big table batch so child operators only need one definition of their input batch. The overflow batch will be typically be forwarded when it gets full, which might not be during a process call. NOTE: Child operators should not remember a received batch.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.hive.ql.exec.Operator

Operator.OperatorFunc, Operator.State

Field Summary

Fields

Modifier and Type	Field and Description
protected long	batchCounter

Fields inherited from class org.apache.hadoop.hive.ql.exec.vector.mapjoin.VectorMapJoinCommonOperator

bigTableByteColumnVectorColumns, bigTableFilterExpressions, bigTableKeyColumnMap, bigTableKeyExpressions, bigTableKeyTypeNames, bigTableOuterKeyMapping, bigTableOuterKeyOutputVectorColumns, bigTableRetainedMapping, bigTableRetainedVectorCopy, bigTableValueColumnMap, bigTableValueExpressions, bigTableValueTypeNames, bigTableVectorCopyOuterKeys, isOuterJoin, needCommonSetup, needHashTableSetup, outputProjection, outputTypeNames, overflowBatch, overflowRepeatedThreshold, posSingleVectorMapJoinSmallTable, smallTableByteColumnVectorColumns, smallTableMapping, smallTableOutputVectorColumns, smallTableVectorDeserializeRow, spillReplayBatch, taskName, useOverflowRepeatedThreshold, vContext, vectorMapJoinHashTable, vOutContext

Fields inherited from class org.apache.hadoop.hive.ql.exec.MapJoinOperator

firstSmallTable, hashMapRowGetters, loader, mapJoinTables, spilledMapJoinTables

Fields inherited from class org.apache.hadoop.hive.ql.exec.AbstractMapJoinOperator

emptyList, joinKeys, joinKeysObjectInspectors, posBigTable

Fields inherited from class org.apache.hadoop.hive.ql.exec.CommonJoinOperator

alias, aliasFilterTags, condn, countAfterReport, dummyObj, dummyObjVectors, filterMaps, filterTags, forwardCache, heartbeatInterval, intermediate, joinFilterObjectInspectors, joinFilters, joinValues, joinValuesObjectInspectors, joinValuesStandardObjectInspectors, noOuterJoin, NOTSKIPBIGTABLE, nullsafes, numAliases, offsets, order, rowContainerStandardObjectInspectors, skipVectors, spillTableDesc, totalSz

Fields inherited from class org.apache.hadoop.hive.ql.exec.Operator

childOperators, childOperatorsArray, childOperatorsTag, colExprMap, conf, CONTEXT_NAME_KEY, done, groupKeyObject, HIVECOUNTERCREATEDFILES, HIVECOUNTERFATAL, id, inputObjInspectors, isLogDebugEnabled, isLogInfoEnabled, isLogTraceEnabled, operatorId, out, outputObjInspector, parentOperators, PLOG, reporter, state, statsMap

Constructor Summary

Constructors

Constructor and Description
VectorMapJoinGenerateResultOperator()
VectorMapJoinGenerateResultOperator(VectorizationContext vContext, OperatorDesc conf)

Method Summary

Methods

Modifier and Type	Method and Description
void	closeOp(boolean aborted) On close, make sure a partially filled overflow batch gets forwarded.
protected void	commonSetup(VectorizedRowBatch batch)
void	forwardBigTableBatch(VectorizedRowBatch batch) Forward the big table batch to the children.
protected void	forwardOverflow() Forward the overflow batch and reset the batch.
protected void	generateHashMapResultMultiValue(VectorizedRowBatch batch, VectorMapJoinHashMapResult hashMapResult, int[] allMatchs, int allMatchesIndex, int duplicateCount) Generate results for a N x M cross product.
protected void	generateHashMapResultRepeatedAll(VectorizedRowBatch batch, VectorMapJoinHashMapResult hashMapResult) Generate optimized results when entire batch key is repeated and it matched the hash map.
protected int	generateHashMapResultSingleValue(VectorizedRowBatch batch, VectorMapJoinHashMapResult hashMapResult, int[] allMatchs, int allMatchesIndex, int duplicateCount, int numSel) Generate join results for a single small table value match.
static String	intArrayToRangesString(int[] selection, int size)
static String	longArrayToRangesString(long[] selection, int size)
protected void	performValueExpressions(VectorizedRowBatch batch, int[] allMatchs, int allMatchCount)
protected void	reloadHashTable(byte pos, int partitionId) Reload hashtable from the hash partition.
protected void	reProcessBigTable(int partitionId) Iterate over the big table row container and feed process() with leftover rows
protected void	spillBatchRepeated(VectorizedRowBatch batch, VectorMapJoinHashTableResult hashTableResult)
protected void	spillHashMapBatch(VectorizedRowBatch batch, VectorMapJoinHashTableResult[] hashTableResults, int[] spills, int[] spillHashTableResultIndices, int spillCount)
boolean	verifyMonotonicallyIncreasing(int[] selected, int size)

Methods inherited from class org.apache.hadoop.hive.ql.exec.vector.mapjoin.VectorMapJoinCommonOperator

determineCommonInfo, displayBatchColumns, getHashTableLoader, getOuputVectorizationContext, getType, initializeOp, loadHashTable, setupOverflowBatch, setupVOutContext

Methods inherited from class org.apache.hadoop.hive.ql.exec.MapJoinOperator

cleanUpInputFileChangedOp, completeInitializationOp, endGroup, generateMapMetaData, getName, getOperatorName, getRefKey, getValueObjectInspectors, process, setMapJoinKey, spillBigTableRow, startGroup

Methods inherited from class org.apache.hadoop.hive.ql.exec.CommonJoinOperator

checkAndGenObject, getFilteredValue, getFilterTag, getNextSize, getPosToAliasMap, hasFilter, internalForward, opAllowedAfterMapJoin, opAllowedBeforeMapJoin, reportProgress, setPosToAliasMap

Methods inherited from class org.apache.hadoop.hive.ql.exec.Operator

acceptLimitPushdown, allInitializedParentsAreClosed, areAllParentsInitialized, augmentPlan, cleanUpInputFileChanged, clone, cloneOp, cloneRecursiveChildren, close, columnNamesRowResolvedCanBeObtained, createDummy, defaultEndGroup, defaultStartGroup, dump, dump, flush, forward, getAdditionalCounters, getChildOperators, getChildren, getColumnExprMap, getConf, getConfiguration, getDone, getExecContext, getGroupKeyObject, getIdentifier, getInputObjInspectors, getNextCntr, getNumChild, getNumParent, getOperatorId, getOpTraits, getOutputObjInspector, getParentOperators, getSchema, getStatistics, getStats, initEvaluators, initEvaluators, initEvaluatorsAndReturnStruct, initialize, initialize, initializeChildren, initializeLocalWork, initOperatorId, isUseBucketizedHiveInputFormat, jobClose, jobCloseOp, logStats, opAllowedBeforeSortMergeJoin, opAllowedConvertMapJoin, passExecContext, preorderMap, processGroup, removeChild, removeChildAndAdoptItsChildren, removeChildren, removeParent, replaceChild, replaceParent, reset, resetId, resetStats, setAlias, setChildOperators, setColumnExprMap, setConf, setDone, setExecContext, setGroupKeyObject, setId, setInputContext, setInputObjInspectors, setOperatorId, setOpTraits, setOutputCollector, setParentOperators, setReporter, setSchema, setStatistics, setUseBucketizedHiveInputFormat, supportAutomaticSortMergeJoin, supportSkewJoinOptimization, supportUnionRemoveOptimization, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

batchCounter

protected transient long batchCounter

Constructor Detail

VectorMapJoinGenerateResultOperator

public VectorMapJoinGenerateResultOperator()

VectorMapJoinGenerateResultOperator

public VectorMapJoinGenerateResultOperator(VectorizationContext vContext,
                                   OperatorDesc conf)
                                    throws HiveException

Throws:

HiveException

Method Detail

commonSetup

protected void commonSetup(VectorizedRowBatch batch)
                    throws HiveException

Overrides:

commonSetup in class VectorMapJoinCommonOperator

Throws:

HiveException

performValueExpressions

protected void performValueExpressions(VectorizedRowBatch batch,
                           int[] allMatchs,
                           int allMatchCount)

generateHashMapResultSingleValue

protected int generateHashMapResultSingleValue(VectorizedRowBatch batch,
                                   VectorMapJoinHashMapResult hashMapResult,
                                   int[] allMatchs,
                                   int allMatchesIndex,
                                   int duplicateCount,
                                   int numSel)
                                        throws HiveException,
                                               IOException

Generate join results for a single small table value match.

Parameters:

batch - The big table batch.

hashMapResult - The hash map results for the matching key.

allMatchs - The selection array for all matches key.

allMatchesIndex - Index into allMatches of the matching key we are generating for.

duplicateCount - Number of equal key rows.

numSel - Current number of rows that are remaining in the big table for forwarding.

Returns:

The new count of selected rows.

Throws:

HiveException

IOException

generateHashMapResultMultiValue

protected void generateHashMapResultMultiValue(VectorizedRowBatch batch,
                                   VectorMapJoinHashMapResult hashMapResult,
                                   int[] allMatchs,
                                   int allMatchesIndex,
                                   int duplicateCount)
                                        throws HiveException,
                                               IOException

Generate results for a N x M cross product.

Parameters:

batch - The big table batch.

hashMapResult - The hash map results for the matching key.

allMatchs - The all match selected array that contains (physical) batch indices.

allMatchesIndex - The index of the match key.

duplicateCount - Number of equal key rows.

Throws:

HiveException

IOException

generateHashMapResultRepeatedAll

protected void generateHashMapResultRepeatedAll(VectorizedRowBatch batch,
                                    VectorMapJoinHashMapResult hashMapResult)
                                         throws IOException,
                                                HiveException

Generate optimized results when entire batch key is repeated and it matched the hash map.

Parameters:

batch - The big table batch.

hashMapResult - The hash map results for the repeated key.

Throws:

IOException

HiveException

spillHashMapBatch

protected void spillHashMapBatch(VectorizedRowBatch batch,
                     VectorMapJoinHashTableResult[] hashTableResults,
                     int[] spills,
                     int[] spillHashTableResultIndices,
                     int spillCount)
                          throws HiveException,
                                 IOException

Throws:

HiveException

IOException

spillBatchRepeated

protected void spillBatchRepeated(VectorizedRowBatch batch,
                      VectorMapJoinHashTableResult hashTableResult)
                           throws HiveException,
                                  IOException

Throws:

HiveException

IOException

reloadHashTable

protected void reloadHashTable(byte pos,
                   int partitionId)
                        throws IOException,
                               HiveException,
                               SerDeException,
                               ClassNotFoundException

Description copied from class: MapJoinOperator

Reload hashtable from the hash partition. It can have two steps: 1) Deserialize a serialized hash table, and 2) Merge every key/value pair from small table container into the hash table

Overrides:

reloadHashTable in class MapJoinOperator

Parameters:

pos - position of small table

partitionId - the partition of the small table to be reloaded from

Throws:

IOException

HiveException

SerDeException

ClassNotFoundException

reProcessBigTable

protected void reProcessBigTable(int partitionId)
                          throws HiveException

Description copied from class: MapJoinOperator

Iterate over the big table row container and feed process() with leftover rows

Overrides:

reProcessBigTable in class MapJoinOperator

Parameters:

partitionId - the partition from which to take out spilled big table rows

Throws:

HiveException

forwardBigTableBatch

public void forwardBigTableBatch(VectorizedRowBatch batch)
                          throws HiveException

Forward the big table batch to the children.

Parameters:

batch - The big table batch.

Throws:

HiveException

forwardOverflow

protected void forwardOverflow()
                        throws HiveException

Forward the overflow batch and reset the batch.

Throws:

HiveException

closeOp

public void closeOp(boolean aborted)
             throws HiveException

On close, make sure a partially filled overflow batch gets forwarded.

Overrides:

closeOp in class MapJoinOperator

Throws:

HiveException

verifyMonotonicallyIncreasing

public boolean verifyMonotonicallyIncreasing(int[] selected,
                                    int size)

intArrayToRangesString

public static String intArrayToRangesString(int[] selection,
                            int size)

longArrayToRangesString

public static String longArrayToRangesString(long[] selection,
                             int size)