JSON

JSON_AGG

PostgreSQLPostgreSQL

Mengagregasi nilai menjadi array JSON. Sangat berguna untuk membuat nested data atau mengkonversi hasil query menjadi format JSON.

Tipe hasil: JSONDiperbarui: 16 Mei 2026

Syntax

SQL
JSON_AGG(expression [ORDER BY ...])

Parameter

expressionANYwajib

Nilai atau ekspresi yang akan diagregasi menjadi array JSON

ORDER BYclauseopsional

Menentukan urutan elemen dalam array (opsional)

Contoh Penggunaan

Membuat array JSON dari kolom

SQL
1SELECT 
2  department,
3  JSON_AGG(employee_name) AS employees
4FROM employees
5GROUP BY department;

Membuat array JSON berisi nama karyawan per departemen.

Membuat array of objects

SQL
1SELECT 
2  category,
3  JSON_AGG(
4    JSON_BUILD_OBJECT('name', name, 'price', price)
5  ) AS products
6FROM products
7GROUP BY category;

Membuat array JSON berisi objek produk per kategori.

Pertanyaan Umum tentang JSON_AGG

Apa itu fungsi JSON_AGG di PostgreSQL?
Mengagregasi nilai menjadi array JSON. Sangat berguna untuk membuat nested data atau mengkonversi hasil query menjadi format JSON. Di PostgreSQL, fungsi JSON_AGG termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan JSON_AGG di PostgreSQL?
Gunakan sintaks berikut: JSON_AGG(expression [ORDER BY ...]). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi JSON_AGG?
Fungsi JSON_AGG mengembalikan nilai bertipe JSON. 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 JSON_AGG?
Fungsi ini memiliki 1 parameter wajib dan 1 parameter opsional. Parameter yang digunakan: expression (ANY, wajib): Nilai atau ekspresi yang akan diagregasi menjadi array JSON; ORDER BY (clause, opsional): Menentukan urutan elemen dalam array (opsional).
Kembali ke PostgreSQL Functions