Todos os produtos
Search
Central de documentação

MaxCompute:HLL_COUNT_INIT

Última atualização: Sep 17, 2026

A função HLL_COUNT_INIT agrega valores do mesmo tipo em uma nova estrutura de dados HyperLogLog++ (HLL++), também conhecida como sketch.

Observações

HLL_COUNT_EXTRACT/HLL_COUNT_MERGE/HLL_COUNT_MERGE_PARTIAL Os dados BINARY usados por essas funções devem vir exclusivamente da função HLL_COUNT_INIT. Não use dados de outros sistemas ou métodos.

Sintaxe

BINARY HLL_COUNT_INIT(<col_name> [, BIGINT <precision>])

Parâmetros

  • col_name: Obrigatório. Nome da coluna. A coluna deve ter o tipo de dados BIGINT, DECIMAL, STRING ou BINARY.

  • precision: Opcional. Precisão estimada. O valor deve ser um inteiro BIGINT no intervalo [10, 24]. O valor padrão é 15. Valores maiores oferecem maior precisão, mas exigem mais espaço de armazenamento para o sketch.

Valor de retorno

Retorna um sketch HLL++ do tipo BINARY. Se o parâmetro de entrada col_name for NULL, o valor retornado será NULL.

Cenários

A consulta a seguir cria sketches HLL++ para calcular o número de indivíduos distintos faturados em cada país.

SELECT
  country,
  HLL_COUNT_INIT(customer_id, 10) AS hll_sketch
    FROM values
      ('UA', 'customer_id_1', 'invoice_id_11'),
      ('BR', 'customer_id_3', 'invoice_id_31'),
      ('CZ', 'customer_id_2', 'invoice_id_22'),
      ('CZ', 'customer_id_2', 'invoice_id_23'),
      ('BR', 'customer_id_3', 'invoice_id_31'),
      ('UA', 'customer_id_2', 'invoice_id_24')
    t(country, customer_id, invoice_id)
GROUP BY country;

O resultado retornado é:

+---------+------------+
| country | hll_sketch |
+---------+------------+
| BR      | =02=01=0A=00=01=00=00=00=20s=8E=00 |
| CZ      | =02=01=0A=00=01=00=00=00=98_$=03 |
| UA      | =02=01=0A=00=02=00=00=00=F0=8B=DD=00=98_$=03 |
+---------+------------+

Funções relacionadas

HLL_COUNT_INIT é uma função HLL++. O MaxCompute oferece um conjunto de funções HLL++ para agregação aproximada. Para mais informações, consulte HyperLogLog++ Functions Overview.