org.apache.spark.sql.execution.aggregate

VectorizedHashMapGenerator

class VectorizedHashMapGenerator extends HashMapGenerator

This is a helper class to generate an append-only vectorized hash map that can act as a 'cache' for extremely fast key-value lookups while evaluating aggregates (and fall back to the BytesToBytesMap if a given key isn't found). This is 'codegened' in HashAggregate to speed up aggregates w/ key.

It is backed by a power-of-2-sized array for index lookups and a columnar batch that stores the key-value pairs. The index lookups in the array rely on linear probing (with a small number of maximum tries) and use an inexpensive hash function which makes it really efficient for a majority of lookups. However, using linear probing and an inexpensive hash function also makes it less robust as compared to the BytesToBytesMap (especially for a large number of keys or even for certain distribution of keys) and requires us to fall back on the latter for correctness. We also use a secondary columnar batch that logically projects over the original columnar batch and is equivalent to the BytesToBytesMap aggregate buffer.

NOTE: This vectorized hash map currently doesn't support nullable keys and falls back to the BytesToBytesMap to store them.

Linear Supertypes
HashMapGenerator, AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. VectorizedHashMapGenerator
  2. HashMapGenerator
  3. AnyRef
  4. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new VectorizedHashMapGenerator(ctx: CodegenContext, aggregateExpressions: Seq[AggregateExpression], generatedClassName: String, groupingKeySchema: StructType, bufferSchema: StructType)

Type Members

  1. case class Buffer(dataType: DataType, name: String) extends Product with Serializable

    Definition Classes
    HashMapGenerator

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  7. val buffVars: Seq[ExprCode]

    Definition Classes
    HashMapGenerator
  8. val bufferValues: Seq[Buffer]

    Definition Classes
    HashMapGenerator
  9. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  10. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  11. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  12. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  13. final def genComputeHash(ctx: CodegenContext, input: String, dataType: DataType, result: String): String

    Attributes
    protected
    Definition Classes
    HashMapGenerator
  14. def generate(): String

    Definition Classes
    HashMapGenerator
  15. final def generateClose(): String

    Attributes
    protected
    Definition Classes
    HashMapGenerator
  16. def generateEquals(): String

    Generates a method that returns true if the group-by keys exist at a given index in the associated org.apache.spark.sql.execution.vectorized.ColumnarBatch.

    Generates a method that returns true if the group-by keys exist at a given index in the associated org.apache.spark.sql.execution.vectorized.ColumnarBatch. For instance, if we have 2 long group-by keys, the generated function would be of the form:

    private boolean equals(int idx, long agg_key, long agg_key1) {
    return batch.column(0).getLong(buckets[idx]) == agg_key &&
      batch.column(1).getLong(buckets[idx]) == agg_key1;
    }
    Attributes
    protected
    Definition Classes
    VectorizedHashMapGeneratorHashMapGenerator
  17. def generateFindOrInsert(): String

    Generates a method that returns a mutable org.apache.spark.sql.execution.vectorized.ColumnarBatch.Row which keeps track of the aggregate value(s) for a given set of keys.

    Generates a method that returns a mutable org.apache.spark.sql.execution.vectorized.ColumnarBatch.Row which keeps track of the aggregate value(s) for a given set of keys. If the corresponding row doesn't exist, the generated method adds the corresponding row in the associated org.apache.spark.sql.execution.vectorized.ColumnarBatch. For instance, if we have 2 long group-by keys, the generated function would be of the form:

    public org.apache.spark.sql.execution.vectorized.ColumnarBatch.Row findOrInsert(
      long agg_key, long agg_key1) {
    long h = hash(agg_key, agg_key1);
    int step = 0;
    int idx = (int) h & (numBuckets - 1);
    while (step < maxSteps) {
      // Return bucket index if it's either an empty slot or already contains the key
      if (buckets[idx] == -1) {
        batch.column(0).putLong(numRows, agg_key);
        batch.column(1).putLong(numRows, agg_key1);
        batch.column(2).putLong(numRows, 0);
        buckets[idx] = numRows++;
        return batch.getRow(buckets[idx]);
      } else if (equals(idx, agg_key, agg_key1)) {
        return batch.getRow(buckets[idx]);
      }
      idx = (idx + 1) & (numBuckets - 1);
      step++;
    }
    // Didn't find it
    return null;
    }
    Attributes
    protected
    Definition Classes
    VectorizedHashMapGeneratorHashMapGenerator
  18. final def generateHashFunction(): String

    Generates a method that computes a hash by currently xor-ing all individual group-by keys.

    Generates a method that computes a hash by currently xor-ing all individual group-by keys. For instance, if we have 2 long group-by keys, the generated function would be of the form:

    private long hash(long agg_key, long agg_key1) {
    return agg_key ^ agg_key1;
    }
    Attributes
    protected
    Definition Classes
    HashMapGenerator
  19. def generateRowIterator(): String

    Attributes
    protected
    Definition Classes
    VectorizedHashMapGeneratorHashMapGenerator
  20. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  21. val groupingKeySignature: String

    Definition Classes
    HashMapGenerator
  22. val groupingKeys: Seq[Buffer]

    Definition Classes
    HashMapGenerator
  23. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  24. def initializeAggregateHashMap(): String

    Attributes
    protected
    Definition Classes
    VectorizedHashMapGeneratorHashMapGenerator
  25. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  26. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  27. final def notify(): Unit

    Definition Classes
    AnyRef
  28. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  29. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  30. def toString(): String

    Definition Classes
    AnyRef → Any
  31. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  32. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  33. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from HashMapGenerator

Inherited from AnyRef

Inherited from Any

Ungrouped