Partilhar via


Função hll_union_agg

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 13.3 LTS e superior

Esta função utiliza o algoritmo HyperLogLog para combinar um grupo de esboços em um único.

As consultas podem usar os buffers resultantes para calcular contagens exclusivas aproximadas com a função hll_sketch_estimate .

A implementação usa a biblioteca Apache Datasketches. Consulte HLL para obter mais informações.

Sintaxe

hll_union_agg ( expr [, allowDifferentLgConfigK ] )

Esta função também pode ser invocada como uma função de janela usando a OVER cláusula.

Argumentos

  • expr: Uma BINARY expressão que contém um esboço gerado por hll_sketch_agg.
  • allowDifferentLgConfigK: Uma expressão constante opcional BOOLEAN que controla se deve permitir a fusão de esboços com diferentes valores lgConfigK. O valor predefinido é false.

Devoluções

Um BINARY buffer contendo o esboço do HyperLogLog calculado como resultado da combinação das expressões de entrada do mesmo grupo.

Quando o allowDifferentLgConfigK parâmetro é true, o esboço de resultado usa o menor dos dois valores fornecidos lgConfigK .

Exemplos

> SELECT hll_sketch_estimate(hll_union_agg(sketch, true))
    FROM (SELECT hll_sketch_agg(col) as sketch
            FROM VALUES (1) AS tab(col)
          UNION ALL
          SELECT hll_sketch_agg(col, 20) as sketch
            FROM VALUES (1) AS tab(col));
  1

> SELECT hll_sketch_estimate(hll_union_agg(sketch, false))
    FROM (SELECT hll_sketch_agg(col) as sketch
            FROM VALUES (1) AS tab(col)
          UNION ALL
          SELECT hll_sketch_agg(col, 20) as sketch
            FROM VALUES (1) AS tab(col));
  error