JSON

JSONB_BUILD_ARRAY

PostgreSQL

Membuat JSON array dari nilai-nilai. Values bisa tipe apapun dan akan dikonversi ke JSON.

Tipe hasil: jsonbDiperbarui: 16 Mei 2026

Syntax

SQL

JSONB_BUILD_ARRAY(value1, value2, ...)

Parameter

valuesanywajib

Nilai-nilai yang akan menjadi elemen array

Contoh Penggunaan

Build Array Sederhana

SQL

1 SELECT JSONB_BUILD_ARRAY(1, two, 3.0, true, null);

Membuat JSON array dari berbagai tipe.

Hasil

jsonb_build_array
[1, "two", 3.0, true, null]

Array of Objects

SQL

1 SELECT JSONB_BUILD_ARRAY(
2   JSONB_BUILD_OBJECT(id, 1, name, Item 1),
3   JSONB_BUILD_OBJECT(id, 2, name, Item 2)
4 );

Membuat array berisi objects.

Hasil

jsonb_build_array
[{"id": 1, "name": "Item 1"}, {"id": 2, ...}]

Combine dengan Subquery

SQL

1 SELECT JSONB_BUILD_ARRAY(
2   (SELECT name FROM users WHERE id = 1),
3   (SELECT name FROM users WHERE id = 2)
4 ) AS user_names;

Menggunakan subquery sebagai elemen array.

Pertanyaan Umum tentang JSONB_BUILD_ARRAY

Apa itu fungsi JSONB_BUILD_ARRAY di PostgreSQL?

Membuat JSON array dari nilai-nilai. Values bisa tipe apapun dan akan dikonversi ke JSON. Di PostgreSQL, fungsi JSONB_BUILD_ARRAY termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.

Bagaimana cara menggunakan JSONB_BUILD_ARRAY di PostgreSQL?

Gunakan sintaks berikut: JSONB_BUILD_ARRAY(value1, value2, ...). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.

Apa nilai yang dikembalikan oleh fungsi JSONB_BUILD_ARRAY?

Fungsi JSONB_BUILD_ARRAY mengembalikan nilai bertipe jsonb. 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 JSONB_BUILD_ARRAY?

Fungsi ini memiliki 1 parameter wajib. Parameter yang digunakan: values (any, wajib): Nilai-nilai yang akan menjadi elemen array.