Categorias:: Funções de agregação (estimativa de cardinalidade), funções de janela (estimativa de cardinalidade)

HLL_COMBINE¶

Combina (funde) os estados de entrada em apenas um estado de saída.

Isto permite cenários onde HLL_ACCUMULATE é executado sobre partições horizontais da mesma tabela, produzindo um estado de algoritmo para cada partição da tabela. Estes estados podem ser combinados mais tarde usando HLL_COMBINE, produzindo o mesmo estado de saída que uma única execução de HLL_ACCUMULATE sobre toda a tabela.

Consulte também:: HLL , HLL_ACCUMULATE , HLL_ESTIMATE

Sintaxe¶

Função de agregação

HLL_COMBINE( [ DISTINCT ] <state> )

Função de janela

HLL_COMBINE( [ DISTINCT ] <state> ) OVER ( [ PARTITION BY <expr1> ] )

Para detalhes sobre a cláusula OVER, consulte Sintaxe e uso da função de janela.

Argumentos¶

state: Uma expressão que contém informações de estado geradas por uma chamada para HLL_ACCUMULATE.

Notas de uso¶

Esta função pode ser usada como uma função de agregação ou uma função de janela.
DISTINCT é suportado sintaticamente, mas não tem efeito.
A saída desta função não é totalmente determinística. A execução desta função com as mesmas entradas pode retornar resultados diferentes em momentos diferentes. As diferenças são tipicamente pequenas e são consistentes com o fato de que as funções HLL_* são funções de aproximação.

Exemplos¶

This example shows how to use the three related functions HLL_ACCUMULATE, HLL_ESTIMATE, and HLL_COMBINE.

Criar uma tabela e dados simples:

CREATE OR REPLACE SEQUENCE seq92;
CREATE OR REPLACE TABLE sequence_demo (c1 INTEGER DEFAULT seq92.nextval, dummy SMALLINT);
INSERT INTO sequence_demo (dummy) VALUES (0);

INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;
INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;
INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;

Create a table that contains the «state» that represents the current approximate cardinality information for the table named sequence_demo:

CREATE OR REPLACE TABLE resultstate1 AS (
  SELECT HLL_ACCUMULATE(c1) AS rs1
    FROM sequence_demo);

Now create a second table and add data. (In a more realistic situation, the user could have loaded more data into the first table and divided the data into non-overlapping sets based on the time that the data was loaded.)

CREATE OR REPLACE TABLE test_table2 (c1 INTEGER);
INSERT INTO test_table2 (c1) SELECT c1 + 4 FROM sequence_demo;

Obtenha as informações de “estado” apenas para os novos dados.

CREATE OR REPLACE TABLE resultstate2 AS
  (SELECT HLL_ACCUMULATE(c1) AS rs1
     FROM test_table2);

Combine as informações de “estado” para os dois lotes de linhas:

CREATE OR REPLACE TABLE combined_resultstate (c1) AS
  SELECT HLL_COMBINE(rs1) AS apc1
    FROM (
      SELECT rs1 FROM resultstate1
      UNION ALL
      SELECT rs1 FROM resultstate2
    );

Obtenha a cardinalidade aproximada do conjunto de linhas combinadas:

SELECT HLL_ESTIMATE(c1)
  FROM combined_resultstate;

+------------------+
| HLL_ESTIMATE(C1) |
|------------------|
|               12 |
+------------------+