Bagaimanakah JSONB berfungsi dan bila anda patut menggunakannya?

Question

Accepted Answer

**`JSONB`** ialah jenis JSON binari PostgreSQL — ia menyimpan data JSON dalam format yang cekap, **boleh ditanya, dan boleh diindeks**. Ia membolehkan anda menyimpan data yang fleksibel dan separa berstruktur dalam pangkalan data hubungan, menggabungkan integriti hubungan dengan kefleksibelan seperti NoSQL. Ia salah satu ciri Postgres yang paling berkuasa.

## JSONB berbanding JSON

```text
JSON  → stores the exact text (preserves whitespace/key order/duplicates), parsed each query
JSONB → stores a DECOMPOSED BINARY format → slightly slower to write, but MUCH faster
        to query, and supports INDEXING and rich operators
→ Use JSONB in almost all cases (JSON only if you need exact text preservation).
```

## Menyimpan dan menanya JSONB

```sql
CREATE TABLE products (id SERIAL, attributes JSONB);
INSERT INTO products (attributes) VALUES
  ('{"color": "red", "size": "L", "tags": ["new", "sale"]}');

-- extract values
SELECT attributes->'color'   FROM products;   -- -> returns JSONB: "red"
SELECT attributes->>'color'  FROM products;   -- ->> returns TEXT: red
SELECT attributes#>>'{tags,0}' FROM products; -- nested path: first tag

-- query by content
SELECT * FROM products WHERE attributes->>'color' = 'red';
SELECT * FROM products WHERE attributes @> '{"color": "red"}';  -- containment
SELECT * FROM products WHERE attributes ? 'color';              -- key exists
```

Operator: `->` (dapatkan medan JSONB), `->>` (dapatkan sebagai teks), `@>` (containment), `?` (kunci wujud), `#>>` (laluan bersarang). Ini menjadikan JSONB boleh ditanya dengan kaya — tidak seperti menyimpan JSON sebagai teks biasa.

## Mengindeks JSONB (kunci kepada prestasi)

```sql
-- a GIN index makes containment/key queries fast
CREATE INDEX idx_attrs ON products USING GIN (attributes);
-- now WHERE attributes @> '{"color": "red"}' uses the index

-- or index a specific extracted field
CREATE INDEX idx_color ON products ((attributes->>'color'));
```

## Bila menggunakan JSONB (dan bila tidak)

```text
✓ USE for: flexible/variable attributes, settings, API payloads, sparse fields,
  semi-structured data that varies per row, or rapidly-evolving schemas
✗ AVOID for: data that's well-structured and queried relationally → use normal columns
  (better constraints, types, and typically better performance for structured queries)
→ Mix both: structured data in columns, variable/flexible data in a JSONB column.
```

## Mengapa ia penting

JSONB ialah salah satu ciri PostgreSQL yang paling penting dan tersendiri, dan memahaminya amat bernilai kerana ia membolehkan anda **menyimpan dan menanya data separa berstruktur dengan cekap dalam pangkalan data hubungan** — menggabungkan integriti, transaksi, dan kuasa hubungan Postgres dengan kefleksibelan stor dokumen/NoSQL, yang merupakan keupayaan utama untuk aplikasi moden.

Kelebihan utama berbanding menyimpan JSON sebagai teks biasa (atau jenis `JSON`) ialah **JSONB boleh ditanya dan boleh diindeks**: operator yang kaya (`->`, `->>`, `@>`, `?`) membolehkan anda mengekstrak dan menapis kandungan JSON, dan **indeks GIN** (atau indeks pada medan yang diekstrak) menjadikan pertanyaan ini pantas — jadi anda mendapat kefleksibelan seperti stor dokumen tanpa mengorbankan prestasi pertanyaan.

Ini menjadikan JSONB ideal untuk atribut fleksibel atau berubah-ubah, tetapan, payload API, data jarang, dan skema yang berkembang — keperluan moden lazim yang sebaliknya memerlukan pangkalan data NoSQL atau reka bentuk skema yang janggal.

Memahami perbezaan **JSONB berbanding JSON** (JSONB untuk hampir semua kes), operator pertanyaan, **pengindeksan** (penting untuk prestasi), dan yang penting **bila menggunakan JSONB berbanding lajur biasa** (JSONB untuk data fleksibel/berubah-ubah/separa berstruktur, lajur biasa untuk data berstruktur baik yang ditanya secara hubungan — selalunya menggabungkan kedua-duanya) mencerminkan pertimbangan reka bentuk yang matang.

Memandangkan keupayaan mengendalikan data fleksibel dan separa berstruktur semakin penting, dan memandangkan JSONB menyediakan ini dalam pangkalan data hubungan yang kukuh (selalunya menghapuskan keperluan stor NoSQL berasingan), memahami JSONB — pertanyaan, pengindeksan, dan penggunaan yang sesuai — ialah pengetahuan bernilai dan kerap relevan yang merupakan sebab utama PostgreSQL begitu popular untuk aplikasi moden dan tanda memanfaatkan kuasa penuh Postgres.