Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # HyperLogLog Funktionen Im Folgenden finden Sie Beschreibungen der HyperLogLog Funktionen für SQL, die Amazon Redshift unterstützt. **Topics** + [Funktion HLL](r_HLL_function.md) + [Funktion HLL\$1CREATE\$1SKETCH](r_HLL_CREATE_SKETCH.md) + [Funktion HLL\$1CARDINALITY](r_HLL_CARDINALITY.md) + [Funktion HLL\$1COMBINE](r_HLL_COMBINE.md) + [HLL\$1COMBINE\$1SKETCHES-Funktion](r_HLL_COMBINE_SKETCHES.md) # Funktion HLL Die HLL-Funktion gibt die HyperLogLog Kardinalität der Werte der Eingabeausdrücke zurück. Die HLL-Funktion funktioniert mit allen Datentypen mit Ausnahme des Datentyps HLLSKETCH. Die HLL-Funktion ignoriert NULL-Werte. Wenn keine Zeilen in einer Tabelle vorhanden sind oder alle Zeilen NULL sind, ist die resultierende Kardinalität 0. ## Syntax ``` HLL (aggregate_expression) ``` ## Argument *aggregate\$1expression* Jeder gültige Ausdruck, der den Wert bereitstellt, der aggregiert werden soll, zum Beispiel einen Spaltennamen. Diese Funktion unterstützt jeden Datentyp als Eingabe mit Ausnahme von HLLSKETCH, GEOMETRY, GEOGRAPHY und VARBYTE. ## Rückgabetyp Die HLL-Funktion gibt einen BIGINT-Wert oder einen Wert zurück. INT8 ## Beispiele Im folgenden Beispiel wird die Kardinalität der Spalte `an_int` in der Tabelle `a_table` zurückgegeben. ``` CREATE TABLE a_table(an_int INT); INSERT INTO a_table VALUES (1), (2), (3), (4); SELECT hll(an_int) AS cardinality FROM a_table; cardinality ------------- 4 ``` # Funktion HLL\$1CREATE\$1SKETCH Die HLL\$1CREATE\$1SKETCH-Funktion gibt einen HLLSKETCH-Datentyp zurück, der die Eingabeausdruckswerte kapselt. Die HLL\$1CREATE\$1SKETCH-Funktion funktioniert mit jedem Datentyp und ignoriert NULL-Werte. Wenn keine Zeilen in einer Tabelle vorhanden sind oder alle Zeilen NULL sind, enthält die resultierende Skizze keine Index-Wert-Paare wie zum Beispiel `{"version":1,"logm":15,"sparse":{"indices":[],"values":[]}}`. ## Syntax ``` HLL_CREATE_SKETCH (aggregate_expression) ``` ## Argument *aggregate\$1expression* Jeder gültige Ausdruck, der den Wert bereitstellt, der aggregiert werden soll, zum Beispiel einen Spaltennamen. NULL-Werte werden ignoriert. Diese Funktion unterstützt jeden Datentyp als Eingabe mit Ausnahme von HLLSKETCH, GEOMETRY, GEOGRAPHY und VARBYTE. ## Rückgabetyp Die HLL\$1CREATE\$1SKETCH-Funktion gibt einen HLLSKETCH-Wert zurück. ## Beispiele Im folgenden Beispiel wird der Typ HLLSKETCH für die Spalte `an_int` in der Tabelle `a_table` zurückgegeben. Ein JSON-Objekt wird verwendet, um beim Importieren, Exportieren oder Drucken von HyperLogLog Skizzen eine dünne Skizze darzustellen. Eine Zeichenkettendarstellung (im Base64-Format) wird verwendet, um eine dichte Skizze darzustellen. HyperLogLog ``` 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) ``` # Funktion HLL\$1CARDINALITY Die HLL\$1CARDINALITY-Funktion gibt die Kardinalität des Eingabe-HLLSKETCH-Datentyps zurück. ## Syntax ``` HLL_CARDINALITY (hllsketch_expression) ``` ## Argument *hllsketch\$1expression* Jeder gültige Ausdruck, der einen HLLSKETCH-Typ auswertet, zum Beispiel ein Spaltenname. Der Eingabewert ist der HLLSKETCH-Datentyp. ## Rückgabetyp Die HLL\$1CARDINALITY-Funktion gibt einen Wert vom Typ BIGINT oder einen Wert zurück. INT8 ## Beispiele Im folgenden Beispiel wird die Kardinalität der Spalte `sketch` in der Tabelle `hll_table` zurückgegeben. ``` CREATE TABLE a_table(an_int INT, b_int INT); INSERT INTO a_table VALUES (1,1), (2,1), (3,1), (4,1), (1,2), (2,2), (3,2), (4,2), (5,2), (6,2); CREATE TABLE hll_table (sketch HLLSKETCH); INSERT INTO hll_table select hll_create_sketch(an_int) from a_table group by b_int; SELECT hll_cardinality(sketch) AS cardinality FROM hll_table; cardinality ------------- 6 4 (2 rows) ``` # Funktion HLL\$1COMBINE Die HLL\$1COMBINE-Aggregationsfunktion gibt einen HLLSKETCH-Datentyp zurück, der alle Eingabe-HLLSKETCH-Werte kombiniert. Die Kombination von zwei oder mehr HyperLogLog Skizzen ist ein neuer HLLSKETCH, der Informationen über die Vereinigung der unterschiedlichen Werte enthält, die jede Eingabeskizze darstellt. Nach dem Kombinieren von Skizzen extrahiert Amazon Redshift die Kardinalität der Vereinigung von zwei oder mehr Datensätzen. Weitere Informationen zum Kombinieren mehrerer Skizzen finden Sie unter [Beispiel: Gibt eine HyperLogLog Skizze aus der Kombination mehrerer Skizzen zurück](r_HLL-examples.md#hll-examples-multiple-sketches). ## Syntax ``` HLL_COMBINE (hllsketch_expression) ``` ## Argument *hllsketch\$1expression* Jeder gültige Ausdruck, der einen HLLSKETCH-Typ auswertet, zum Beispiel ein Spaltenname. Der Eingabewert ist der HLLSKETCH-Datentyp. ## Rückgabetyp Die HLL\$1COMBINE-Funktion gibt einen HLLSKETCH-Typ zurück. ## Beispiele Im folgenden Beispiel werden die kombinierten HLLSKETCH-Werte in der Tabelle `hll_table` zurückgegeben. ``` CREATE TABLE a_table(an_int INT, b_int INT); INSERT INTO a_table VALUES (1,1), (2,1), (3,1), (4,1), (1,2), (2,2), (3,2), (4,2), (5,2), (6,2); CREATE TABLE hll_table (sketch HLLSKETCH); INSERT INTO hll_table select hll_create_sketch(an_int) from a_table group by b_int; SELECT hll_combine(sketch) AS sketches FROM hll_table; sketches ---------------------------------------------------------------------------------------------------------------------------- {"version":1,"logm":15,"sparse":{"indices":[20812342,20850007,22362299,40314817,42650774,47158030],"values":[1,2,1,3,2,1]}} (1 row) ``` # HLL\$1COMBINE\$1SKETCHES-Funktion Die HLL\$1COMBINE\$1SKETCHES ist eine skalare Funktion, die zwei HLLLSKETCH-Werte als Eingabe verwendet und zu einem einzigen HLSKETCH kombiniert. Die Kombination von zwei oder mehr HyperLogLog Skizzen ist ein neuer HLLSKETCH, der Informationen über die Vereinigung der unterschiedlichen Werte enthält, die jede Eingabeskizze darstellt. ## Syntax ``` HLL_COMBINE_SKETCHES (hllsketch_expression1, hllsketch_expression2) ``` ## Argument *hllsketch\$1expression1* und *hllsketch\$1expression2* Jeder gültige Ausdruck, der einen HLLSKETCH-Typ auswertet, zum Beispiel ein Spaltenname. ## Rückgabetyp Die HLL\$1COMBINE\$1SKETCHES-Funktion gibt einen HLLSKETCH-Typ zurück. ## Beispiele Im folgenden Beispiel werden die kombinierten HLLSKETCH-Werte in der Tabelle zurückgegeben `hll_table`. ``` WITH tbl1(x, y) AS (SELECT Hll_create_sketch(1), Hll_create_sketch(2) UNION ALL SELECT Hll_create_sketch(3), Hll_create_sketch(4) UNION ALL SELECT Hll_create_sketch(5), Hll_create_sketch(6) UNION ALL SELECT Hll_create_sketch(7), Hll_create_sketch(8)), tbl2(x, y) AS (SELECT Hll_create_sketch(9), Hll_create_sketch(10) UNION ALL SELECT Hll_create_sketch(11), Hll_create_sketch(12) UNION ALL SELECT Hll_create_sketch(13), Hll_create_sketch(14) UNION ALL SELECT Hll_create_sketch(15), Hll_create_sketch(16) UNION ALL SELECT Hll_create_sketch(NULL), Hll_create_sketch(NULL)), tbl3(x, y) AS (SELECT * FROM tbl1 UNION ALL SELECT * FROM tbl2) SELECT Hll_combine_sketches(x, y) FROM tbl3; ```