Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Fungsi COLLECT\$1LIST
<a name="COLLECT_LIST"></a>

Fungsi COLLECT\$1LIST mengumpulkan dan mengembalikan daftar elemen non-unik. 

Jenis fungsi ini berguna ketika Anda ingin mengumpulkan beberapa nilai dari satu set baris ke dalam array tunggal atau struktur data daftar.

**catatan**  
Fungsi ini non-deterministik karena urutan hasil yang dikumpulkan tergantung pada urutan baris, yang mungkin non-deterministik setelah operasi shuffle dilakukan.

## Sintaksis
<a name="COLLECT_LIST-syntax"></a>

```
collect_list(expr)
```

## Pendapat
<a name="COLLECT_LIST-arguments"></a>

 *expr*   
Ekspresi jenis apa pun.

## Pengembalian
<a name="COLLECT_LIST-returns"></a>

Mengembalikan ARRAY dari tipe argumen. Urutan elemen dalam array adalah non-deterministik. 

Nilai NULL dikecualikan.

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

## Contoh
<a name="COLLECT_LIST-example"></a>

Query berikut mengumpulkan semua nilai dari kolom col ke dalam daftar. `VALUES`Klausa ini digunakan untuk membuat tabel inline dengan tiga baris, di mana setiap baris memiliki satu kolom col dengan nilai 1, 2, dan 1 masing-masing. `collect_list() `Fungsi ini kemudian digunakan untuk menggabungkan semua nilai dari kolom col ke dalam array tunggal. Output dari pernyataan SQL ini akan menjadi array`[1,2,1]`, yang berisi semua nilai dari kolom col dalam urutan mereka muncul dalam data input.

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