Freigeben über

collect_list-Aggregatfunktion

  • Artikel

Gilt für: durch Häkchen mit „Ja“ markiert Databricks SQL Häkchen gesetzt ja 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]