Fonction HLL_CREATE_SKETCH

La fonction HLL_CREATE_SKETCH renvoie un type de données HLLSKETCH qui encapsule les valeurs d’expression en entrée. La fonction HLL_CREATE_SKETCH fonctionne avec n’importe quel type de données et ignore les valeurs NULL. Lorsqu’il n’y a pas de lignes dans une table ou que toutes les lignes sont NULL, le schéma résultant n’a pas de paires index-valeur telles que {"version":1,"logm":15,"sparse":{"indices":[],"values":[]}}.

Syntaxe

HLL_CREATE_SKETCH (aggregate_expression)

Argument

aggregate_expression

Toute expression valide qui fournit la valeur à un agrégat, telle qu’un nom de colonne. Les valeurs NULL sont ignorées. Cette fonction prend en charge n’importe quel type de données d’entrée, sauf HLLSKETCH, GEOMETRY, GEOGRAPHY et VARBYTE.

Type de retour

La fonction HLL_CREATE_SKETCH renvoie une valeur HLLSKETCH.

Exemples

L’exemple suivant renvoie le type HLLSKETCH pour la colonne an_int de la table a_table. Un objet JSON est utilisé pour représenter une HyperLogLog esquisse éparse lors de l'importation, de l'exportation ou de l'impression d'esquisses. Une représentation sous forme de chaîne (au format Base64) est utilisée pour représenter une HyperLogLog esquisse dense.

CREATE TABLE a_table(an_int INT);
INSERT INTO a_table VALUES (1), (2), (3), (4);

SELECT hll_create_sketch(an_int) AS sketch FROM a_table;
sketch
-------------------------------------------------------------------------------------------------------
{"version":1,"logm":15,"sparse":{"indices":[20812342,20850007,22362299,47158030],"values":[1,2,1,1]}}
(1 row)