collect_list mängdfunktion

  • Artikel

Gäller för:check markerad ja Databricks SQL-kontroll markerad som ja Databricks Runtime

Returnerar en matris som består av alla värden i expr gruppen. Den här funktionen är en synonym för array_agg mängdfunktion.

Syntax

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

Den här funktionen kan också anropas som en fönsterfunktion med hjälp av - OVER satsen.

Argument

  • expr: Ett uttryck av valfri typ.
  • cond: Ett valfritt booleskt uttryck som filtrerar de rader som används för aggregering.

Returnerar

En MATRIS av argumenttypen.

Ordningen på element i matrisen är icke-deterministisk. NULL -värden exkluderas.

Om DISTINCT anges samlar funktionen endast in unika värden och är en synonym för collect_set mängdfunktion.

Exempel

> 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]