Catégories :

Fonctions d’agrégation (estimation de la cardinalité), Fonctions de fenêtre (estimation de la cardinalité)

HLL_COMBINE

Combine (fusionne) les états d’entrée en un seul état de sortie.

Cela permet des scénarios dans lesquels HLL_ACCUMULATE est exécuté sur des partitions horizontales de la même table, générant un état d’algorithme pour chaque partition de la table. Ces états peuvent ensuite être combinés à l’aide de HLL_COMBINE, produisant le même état de sortie qu’une seule exécution de HLL_ACCUMULATE sur la table entière.

Voir aussi :

HLL , HLL_ACCUMULATE , HLL_ESTIMATE

Syntaxe

Fonction d’agrégation

HLL_COMBINE( [ DISTINCT ] <state> )

Fonction de fenêtre

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

Pour plus d’informations sur la clause OVER, consultez Syntaxe et utilisation des fonctions de fenêtre.

Arguments

state

Expression contenant des informations d’état générées par un appel à HLL_ACCUMULATE.

Notes sur l’utilisation

  • Cette fonction peut être utilisée comme fonction d’agrégation ou comme fonction de fenêtre.

  • DISTINCT est pris en charge syntaxiquement, mais n’a aucun effet.

  • La sortie de cette fonction n’est pas entièrement déterminante. L’exécution de cette fonction sur les mêmes entrées peut donner des résultats différents à des moments différents. Les différences sont généralement faibles et sont cohérentes avec le fait que les fonctions HLL_* sont des fonctions d’approximation.

Exemples

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

Créez une table et des données 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;

Obtenez les informations « d’état » pour les nouvelles données uniquement.

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

Combiner les informations « d’état » pour les deux lots de lignes :

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
    );

Obtenez la cardinalité approximative de l’ensemble combiné de lignes :

SELECT HLL_ESTIMATE(c1)
  FROM combined_resultstate;
+------------------+
| HLL_ESTIMATE(C1) |
|------------------|
|               12 |
+------------------+