Aggregate

LIST

DuckDB

Mengumpulkan nilai dari banyak baris menjadi satu list (array). Alias dari ARRAY_AGG yang lebih natural di DuckDB.

Tipe hasil: LIST (array of input type)Diperbarui: 16 Mei 2026

Syntax

SQL

LIST(expression) | LIST(expression ORDER BY ...)

Parameter

expressionanywajib

Kolom atau ekspresi yang nilainya akan dikumpulkan ke dalam list

Contoh Penggunaan

Mengumpulkan Nilai ke List

SQL

1 SELECT
2   department,
3   LIST(employee_name) as employees
4 FROM staff
5 GROUP BY department;

Mengumpulkan semua nama karyawan per departemen ke dalam list.

Hasil

department	employees
Sales	[Budi, Ani, Dewi]
IT	[Eko, Fitri, Gita, Hadi]
HR	[Ika, Joko]

LIST dengan ORDER BY

SQL

1 SELECT
2   category,
3   LIST(product_name ORDER BY price DESC) as products_by_price
4 FROM products
5 GROUP BY category;

Mengumpulkan produk yang diurutkan berdasarkan harga tertinggi.

Hasil

category	products_by_price
Electronics	[Laptop, Tablet, Phone, Mouse]
Furniture	[Sofa, Table, Chair]

LIST untuk Nested JSON

SQL

1 SELECT
2   order_id,
3   customer_name,
4   LIST({
5     'product': product_name,
6     'qty': quantity,
7     'price': unit_price
8   }) as items
9 FROM orders
10 JOIN order_items USING (order_id)
11 GROUP BY order_id, customer_name;

Membuat struktur nested dengan list of structs untuk JSON export.

Hasil

order_id	customer_name	items
1001	Budi	[{'product': 'Laptop', 'qty': 1, ...}]

Pertanyaan Umum tentang LIST

Apa itu fungsi LIST di DuckDB?

Mengumpulkan nilai dari banyak baris menjadi satu list (array). Alias dari ARRAY_AGG yang lebih natural di DuckDB. Di DuckDB, fungsi LIST termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.

Bagaimana cara menggunakan LIST di DuckDB?

Gunakan sintaks berikut: LIST(expression) | LIST(expression ORDER BY ...). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.

Apa nilai yang dikembalikan oleh fungsi LIST?

Fungsi LIST mengembalikan nilai bertipe LIST (array of input type). Pastikan tipe data hasil sudah sesuai dengan kebutuhan query atau formula kamu. Jika input mengandung nilai NULL, perilaku fungsi dapat berbeda — selalu periksa dokumentasi untuk memastikan hasilnya sesuai ekspektasi.

Apa saja parameter fungsi LIST?

Fungsi ini memiliki 1 parameter wajib. Parameter yang digunakan: expression (any, wajib): Kolom atau ekspresi yang nilainya akan dikumpulkan ke dalam list.

Kembali ke DuckDB Functions

1	SELECT
2	department,
3	LIST(employee_name) as employees
4	FROM staff
5	GROUP BY department;

1	SELECT
2	category,
3	LIST(product_name ORDER BY price DESC) as products_by_price
4	FROM products
5	GROUP BY category;

1	SELECT
2	order_id,
3	customer_name,
4	LIST({
5	'product': product_name,
6	'qty': quantity,
7	'price': unit_price
8	}) as items
9	FROM orders
10	JOIN order_items USING (order_id)
11	GROUP BY order_id, customer_name;