Dela via


collect_list mängdfunktion

Gäller för: markerad ja Databricks SQL markerad ja Databricks Runtime

Returnerar en matris som består av alla värden i expr gruppen. Den här funktionen är 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.

Returer

En MATRIS av argumenttypen.

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

Om DISTINCT har angetts 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]