JSONB nasıl çalışır ve ne zaman kullanmalısınız?

Question

Accepted Answer

**`JSONB`**, PostgreSQL'in ikili JSON türüdür — JSON verilerini verimli, **sorgulanabilir ve indekslenebilir** bir formatta depolar. İlişkisel bir veritabanında esnek, yarı yapılandırılmış verileri depolamanıza olanak tanır ve ilişkisel bütünlüğü NoSQL benzeri esneklikle birleştirir. PostgreSQL'in en güçlü özelliklerinden biridir.

## 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).
```

## JSONB'yi depolama ve sorgulama

```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
```

Operatörler: `->` (JSONB alanı al), `->>` (metin olarak al), `@>` (içerme), `?` (anahtar var mı), `#>>` (iç içe yol). Bunlar JSONB'yi zenginçe sorgulanabilir hale getirir — düz metinde JSON saklamaktan farklı olarak.

## JSONB indeksleme (performans için anahtar)

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

## JSONB ne zaman kullanılır (ve ne zaman kullanılmaz)

```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.
```

## Neden önemli

JSONB, PostgreSQL'in en önemli ve ayırt edici özelliklerinden biridir ve bunu anlamak çok değerlidir çünkü **yarı yapılandırılmış verileri ilişkisel bir veritabanında verimli bir şekilde depolayıp sorgulayabilir** — PostgreSQL'in bütünlüğünü, işlemlerini ve ilişkisel gücünü bir belge/NoSQL deposunun esnekliğiyle birleştirirsiniz; bu da modern uygulamalar için önemli bir yetenektir.

Düz metinde JSON depolama (veya `JSON` türü) üzerinde temel avantajı, **JSONB'nin sorgulanabilir ve indekslenebilir** olmasıdır: zengin operatörler (`->`, `->>`, `@>`, `?`) JSON içeriğinden çıkarmanız ve filtreleme yapmanıza olanak tanır ve **GIN indeksleri** (veya çıkarılan alanlardaki indeksler) bu sorguları hızlı hale getirir — böylece sorgu performansından vazgeçmeden belge depolaması benzeri esnekliği elde edersiniz.

Bu JSONB'yi esnek veya değişken özellikler, ayarlar, API yükleri, seyrek veriler ve gelişen şemalar için ideal hale getirir — aksi takdirde bir NoSQL veritabanı veya garip şema tasarımları gerektiren yaygın modern ihtiyaçlar.

**JSONB vs JSON** farkını anlamak (neredeyse tüm durumlar için JSONB), sorgu operatörlerini, **indekslemeyi** (performans için gerekli) ve özellikle **JSONB'yi normal sütunlarla karşılaştırıldığında ne zaman kullanacağınızı** (esnek/değişken/yarı yapılandırılmış veriler için JSONB, iyi yapılandırılmış ilişkisel olarak sorgulanan veriler için normal sütunlar — çoğunlukla her ikisini birlikte karıştırmak) yansıtır olgun tasarım yargısını gösterir.

Esnek, yarı yapılandırılmış verileri işleme yeteneği giderek önemli hale geldiğinden ve JSONB bunu sağlam bir ilişkisel veritabanında sağladığından (çoğunlukla ayrı bir NoSQL depolaması ihtiyacını ortadan kaldırarak), JSONB'yi anlamak — onun sorgulanması, indekslenmesi ve uygun kullanımı — değerli, sık ilgili bilgidir ve PostgreSQL'in modern uygulamalar için bu kadar popüler olmasının temel nedenidir; PostgreSQL'in tam gücünden yararlanmanın bir işaretidir.