collect_listFungsi agregat

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Mengembalikan array yang terdiri dari semua nilai dalam expr di dalam grup. Fungsi ini adalah sinonim untuk array_agg fungsi agregat.

Sintaks

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

Fungsi ini juga dapat dipanggil sebagai fungsi jendela menggunakan klausa OVER.

Argumen

  • expr: Ekspresi jenis apa pun.
  • cond: Ekspresi boolean opsional yang memfilter baris yang digunakan untuk agregasi.

Pengembalian

ARRAY daripada jenis argumen.

Urutan elemen dalam array adalah non-deterministik. Nilai-nilai NULL dikecualikan.

Jika DISTINCT ditentukan, pemanggilan agregat fungsi hanya mengumpulkan nilai unik dan merupakan sinonim untuk collect_set fungsi agregat.

Contoh

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