Menu

JSONB PostgreSQL: Operator, Query, dan Index

Simpan dan query JSON di PostgreSQL dengan jsonb: operator -> dan ->>, containment @>, jsonb_set dan update lainnya, mengubah array menjadi baris, index GIN, serta json vs jsonb.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

jsonb adalah tipe kolom JSON biner milik PostgreSQL. Baca field dengan -> (mengembalikan jsonb) dan ->> (mengembalikan text), temukan baris dengan operator containment @>, dan ubah field dengan jsonb_set atau ||. Index GIN membuat query-query itu cepat.

Pesanan 1 dan 3 cocok. data->'customer' mengembalikan objek bersarang sebagai jsonb, ->>'name' mengambil namanya sebagai teks, dan ->> ditambah cast mengubah total menjadi angka.

Mengambil nilai dari JSONB

OperatorMengembalikanContoh
-> kunci atau indeksjsonbdata->'customer', data->'tags'->0
->> kunci atau indekstextdata->>'status'
#> pathjsonbdata#>'{customer,city}'
#>> pathtextdata#>>'{customer,city}'
[...] subscript (PostgreSQL 14+)jsonbdata['customer']['city']

Indeks array dimulai dari 0, dan indeks negatif menghitung dari akhir (-> -1 adalah elemen terakhir). Kunci yang tidak ada menghasilkan NULL SQL, bukan error, jadi pesanan 3 di atas punya city NULL.

Pakai ->> untuk membandingkan dengan teks atau untuk cast: data->>'status' = 'paid'. Pakai -> untuk terus menelusuri. Kesalahan yang umum adalah data->'status' = 'paid'. PostgreSQL membaca 'paid' sebagai JSON, kata tanpa tanda kutip bukan JSON yang valid, dan query gagal dengan "invalid input syntax for type json".

Menemukan baris berdasarkan isi JSON

@> menguji apakah nilai di kiri berisi nilai di kanan. Operator ini bekerja di kedalaman berapa pun dan di dalam array, dan didukung index GIN:

Produk 1 dan 2 punya ukuran M dan harga; hanya produk 2 yang harganya lebih dari 30. Operator pencariannya:

  • @> berisi, <@ terkandung di dalam.
  • ? kunci (atau string dalam array) ada, ?| salah satu kunci ada, ?& semua kunci ada.
  • @? dan @@ menjalankan query JSON path (PostgreSQL 12+), untuk perbandingan di dalam dokumen.

Memperbarui field di dalam JSONB

PostgreSQL menulis ulang seluruh nilai di setiap update, tapi fungsi-fungsi ini memungkinkanmu menuliskan perubahannya saja:

  • jsonb_set(target, path, new_value) mengganti satu nilai di sebuah path.
  • - menghapus sebuah kunci, dan #- menghapus path bersarang seperti '{notify,sms}'.
  • || menambah atau menimpa kunci tingkat atas.

Sejak PostgreSQL 14, kamu juga bisa melakukan assignment lewat subscript: SET prefs['notify']['email'] = 'false'.

Dua jebakan:

  • jsonb_set mengembalikan NULL saat nilai barunya NULL SQL, dan UPDATE lalu menghapus isi seluruh kolom. Berikan COALESCE(to_jsonb(x), 'null'), atau pakai jsonb_set_lax (PostgreSQL 13+), yang secara default menyimpan JSON null.
  • jsonb_set menambahkan kunci terakhir yang belum ada, tapi tidak dengan induknya yang belum ada: mengatur '{a,b}' pada {} membiarkannya tidak berubah. Assignment lewat subscript membuat induknya.

Mengubah array JSON menjadi baris

jsonb_array_elements mengembalikan satu baris per elemen array, dan jsonb_to_recordset mengubah array berisi objek menjadi kolom bertipe. Sejak PostgreSQL 17, JSON_TABLE standar melakukan keduanya di satu tempat:

A-1 terjual 3 dan B-2 terjual 1. Ke arah sebaliknya, jsonb_build_object('id', id, 'name', name) membangun objek dari kolom dan jsonb_agg mengumpulkan baris menjadi array (lihat string_agg dan array_agg).

Index JSONB dengan GIN

Index GIN pada seluruh kolom melayani @>, ?, ?|, ?&, @?, dan @@:

CREATE INDEX orders_data_idx ON orders USING gin (data);

-- smaller and faster, but only for @>, @? and @@
CREATE INDEX orders_data_path_idx ON orders USING gin (data jsonb_path_ops);

-- one field compared with = or a range: a B-tree on the expression
CREATE INDEX orders_status_idx ON orders ((data->>'status'));

Tulis query dalam bentuk yang didukung index. WHERE data @> '{"status": "paid"}' bisa memakai index GIN. WHERE data->>'status' = 'paid' tidak bisa; ia butuh expression index. Uji rentang seperti (data->>'total')::numeric > 50 butuh expression index pada ekspresi yang persis sama.

JSON vs JSONB

jsonjsonb
Disimpan sebagaiTeks inputBentuk biner yang sudah di-parse
Spasi, urutan kunci, kunci duplikatDipertahankanDihapus; duplikat terakhir yang menang
PenulisanSedikit lebih cepat (hanya divalidasi)Di-parse saat input
Pembacaan dan queryDi-parse ulang di setiap aksesCepat
@>, ?, dan index GINTidakYa

json mengembalikan teks tanpa perubahan; jsonb hanya menyimpan "a": 3 dan mengubah urutan kuncinya. Pakai jsonb kecuali kamu harus mengembalikan teks asli byte demi byte, seperti payload webhook yang disimpan. Simpan field yang dimiliki setiap baris, atau yang butuh foreign key, di kolom biasa. Referensi resmi fungsi JSON memuat setiap operator dan fungsinya.

Pertanyaan yang sering diajukan

Apa perbedaan -> dan ->> di PostgreSQL?

-> mengembalikan nilai sebagai jsonb, jadi kamu bisa terus menelusuri (data->'customer'->'city'). ->> mengembalikannya sebagai text, yang kamu bandingkan dengan string atau cast ke angka: (data->>'total')::numeric.

Bagaimana cara mengecek apakah array JSONB berisi sebuah nilai?

Pakai containment: data->'tags' @> '["gift"]', atau data @> '{"tags": ["gift"]}' untuk menguji dari puncak dokumen. Untuk array berisi string, data->'tags' ? 'gift' juga bisa. Index GIN pada data mempercepat bentuk kedua.

Apakah JSONB mempertahankan urutan kunci?

Tidak. jsonb menyimpan kunci dalam urutannya sendiri, menghapus spasi, dan hanya menyimpan yang terakhir dari kunci yang duplikat. Jika kamu butuh teks aslinya kembali persis, pakai tipe json.

Bagaimana cara mengecek apakah sebuah kunci ada di JSONB?

data ? 'key' bernilai true saat objek tingkat atas punya kunci itu, bahkan jika nilainya JSON null. ?| menerima array dan bernilai true jika salah satu kunci ada, ?& jika semuanya ada.

Bisakah menambahkan foreign key atau constraint NOT NULL pada field di dalam JSONB?

Tidak secara langsung. Constraint CHECK bisa menguji sebuah field (CHECK (data ? 'email')), tapi foreign key butuh kolom sungguhan. Field yang dimiliki setiap baris dan dirujuk tabel lain sebaiknya berada di kolom biasa.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai