collect_list-Aggregatfunktion

Gilt für: Databricks SQL Databricks Runtime

Gibt ein Array zurück, das aus allen Werten in expr innerhalb der Gruppe besteht. Diese Funktion ist ein Synonym für die array_agg-Aggregatfunktion.

Syntax

collect_list ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

Diese Funktion kann auch mithilfe der OVER-Klausel als Fensterfunktion aufgerufen werden.

Argumente

• expr: Ein Ausdruck beliebigen Typs
• cond: Ein optionaler boolescher Ausdruck, der die für die Aggregation verwendeten Zeilen filtert.

Gibt zurück

Ein ARRAY des Argumenttyps.

Die Reihenfolge der Elemente im Array ist nicht deterministisch. NULL-Werte werden ausgeschlossen.

Wenn DISTINCT angegeben wird, sammelt die Funktion nur eindeutige Werte und ist ein Synonym für die collect_set-Aggregatfunktion.

Beispiele

> SELECT collect_list(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2,1]

> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]

Verwandte Themen

• array_agg Aggregatfunktion
• array-Funktion
• collect_set-Aggregatfunktion
• Fensterfunktionen