Bagaimana cara kerja JSONB dan kapan Anda harus menggunakannya?

Question

Accepted Answer

**`JSONB`** adalah tipe JSON biner PostgreSQL — menyimpan data JSON dalam format yang efisien, **dapat diquery, dan dapat diindeks**. Ini memungkinkan Anda menyimpan data fleksibel dan semi-terstruktur dalam database relasional, menggabungkan integritas relasional dengan fleksibilitas seperti NoSQL. Ini adalah salah satu fitur paling powerful dari Postgres.

## JSONB vs 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 melakukan query 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 field JSONB), `->>` (dapatkan sebagai teks), `@>` (containment), `?` (key ada), `#>>` (nested path). Ini membuat JSONB kaya dalam hal query — tidak seperti menyimpan JSON sebagai plain text.

## Mengindeks JSONB (kunci untuk performa)

```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'));
```

## Kapan menggunakan JSONB (dan kapan 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 ini penting

JSONB adalah salah satu fitur paling penting dan khas dari PostgreSQL, dan memahaminya sangat berharga karena memungkinkan Anda **menyimpan dan melakukan query data semi-terstruktur secara efisien dalam database relasional** — menggabungkan integritas, transaksi, dan kekuatan relasional Postgres dengan fleksibilitas document store/NoSQL, yang merupakan kemampuan besar untuk aplikasi modern.

Keunggulan utama dibanding menyimpan JSON sebagai plain text (atau tipe `JSON`) adalah **JSONB dapat diquery dan diindeks**: operator yang kaya (`->`, `->>`, `@>`, `?`) memungkinkan Anda mengekstrak dan memfilter konten JSON, dan **GIN indexes** (atau indexes pada field yang diekstrak) membuat query ini cepat — jadi Anda mendapatkan fleksibilitas seperti document store tanpa mengorbankan performa query.

Ini membuat JSONB ideal untuk atribut fleksibel atau variabel, settings, API payloads, data sparse, dan schema yang berkembang — kebutuhan modern umum yang seharusnya memerlukan database NoSQL atau design schema yang awkward.

Memahami perbedaan **JSONB vs JSON** (JSONB untuk hampir semua kasus), operator query, **indexing** (esensial untuk performa), dan yang sangat penting **kapan menggunakan JSONB versus kolom normal** (JSONB untuk data fleksibel/variabel/semi-terstruktur, kolom normal untuk data well-structured yang di-query secara relasional — sering menggabungkan keduanya) mencerminkan penilaian design yang matang.

Karena kemampuan menangani data fleksibel dan semi-terstruktur semakin penting, dan karena JSONB menyediakan ini dalam database relasional yang robust (sering menghilangkan kebutuhan untuk NoSQL store terpisah), memahami JSONB — querying, indexing, dan penggunaan yang sesuai — adalah pengetahuan yang berharga, sering relevan yang merupakan alasan kunci mengapa PostgreSQL sangat populer untuk aplikasi modern dan ciri dari memanfaatkan kekuatan penuh Postgres.