DATASKETCHES_HLL¶

Syntaxe¶

Fonction d’agrégation

DATASKETCHES_HLL( [ DISTINCT ] <expr1> [ , <max_log_k> ] )

Fonction de fenêtre

DATASKETCHES_HLL( [ DISTINCT ] <expr1> [ , <max_log_k> ] )
  OVER ( [ PARTITION BY <expr2> ] )

Arguments obligatoires¶

expr1

L’expression pour laquelle vous souhaitez connaître le nombre de valeurs distinctes.

Arguments facultatifs¶

max_log_k

La valeur maximale, en log2, de K pour initialiser l’objet HLL datasketches. Spécifiez une valeur INTEGER comprise entre 4 et 21 inclus. Pour plus d’informations, consultez la documentation Apache DataSketches.

Par défaut : 12

expr2

Expression facultative utilisée pour regrouper les lignes dans des partitions.

Renvoie¶

La fonction renvoie une valeur de type DOUBLE.

Si l’entrée est vide, la sortie est 0.0.

Notes sur l’utilisation¶

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

• La fonction prend en charge les arguments qui sont des valeurs des types de données suivants :

  • Types de données Chaîne et Binaire (par exemple, VARCHAR et BINARY).

    Par exemple, les appels de fonction suivants sont pris en charge :

    SELECT DATASKETCHES_HLL_ACCUMULATE(1::TEXT);
    

    Copy

    SELECT DATASKETCHES_HLL_ACCUMULATE(TO_BINARY(HEX_ENCODE(1), 'HEX'));
    

    Copy

  • Types de données pour les numéros en virgule flottante (par exemple, FLOAT et DOUBLE)

    La bibliothèque DataSketches convertit ces valeurs en valeurs DOUBLE.

  • Types de données pour les numéros à virgule fixe (par exemple, INTEGER et NUMERIC).

    La fonction ne prend en charge que les types numériques avec une échelle de 0. Toutefois, vous pouvez convertir des valeurs numériques avec une échelle différente de 0 en un type de données pour un nombre à virgule flottante.

    La bibliothèque DataSketches convertit ces valeurs dans l’intervalle d’une valeur INTEGER signée de 64 bits à une valeur INTEGER signée de 64 bits.

    La bibliothèque DataSketches ne convertit pas directement les valeurs INTEGER dépassant la plage de valeurs INTEGER signées de 64 bits (telles que les valeurs entières de 128 bits). Cependant, Snowflake prend toujours en charge ces valeurs en les convertissant automatiquement en valeurs DOUBLE, que DataSketches prend en charge. Ce comportement est identique à celui de la bibliothèque datasketches-python.

  Les valeurs d’autres types de données ne sont pas prises en charge. Par exemple, les valeurs VARIANT et ARRAY ne sont pas prises en charge.

• Pour plus d’informations sur les valeurs NULL et les fonctions d’agrégation, voir Fonctions d’agrégation et valeurs NULL.

• Lorsque cette fonction est appelée en tant que fonction de fenêtre, elle ne prend pas en charge :

  • Une clause ORDER BY dans la clause OVER.

  • Cadres de fenêtre explicites.

Exemples¶

Créer une table et insérer des valeurs :

CREATE OR REPLACE TABLE datasketches_demo(v INT, g INT);

INSERT INTO datasketches_demo SELECT 1, 1;
INSERT INTO datasketches_demo SELECT 2, 1;
INSERT INTO datasketches_demo SELECT 2, 1;
INSERT INTO datasketches_demo SELECT 2, 1;
INSERT INTO datasketches_demo SELECT 1, 2;
INSERT INTO datasketches_demo SELECT 1, 2;
INSERT INTO datasketches_demo SELECT 4, 2;
INSERT INTO datasketches_demo SELECT 4, 2;
INSERT INTO datasketches_demo SELECT 5, 2;

Les exemples suivants utilisent les données de la table.

SELECT g,
       DATASKETCHES_HLL(v),
       COUNT(DISTINCT v)
  FROM datasketches_demo GROUP BY g;

+---+---------------------+-------------------+
| G | DATASKETCHES_HLL(V) | COUNT(DISTINCT V) |
|---+---------------------+-------------------|
| 1 |         2.000000005 |                 2 |
| 2 |         3.000000015 |                 3 |
+---+---------------------+-------------------+

SELECT DATASKETCHES_HLL(v),
       COUNT(DISTINCT v)
  FROM datasketches_demo;

+---------------------+-------------------+
| DATASKETCHES_HLL(V) | COUNT(DISTINCT V) |
|---------------------+-------------------|
|          4.00000003 |                 4 |
+---------------------+-------------------+