Geliştirme

PostgreSQL JSONB: Alan Okuma, Filtreleme ve Güncelleme

Mehmet Fatih Ünal
10 Kasım 2026
7 dk okuma
#PostgreSQL#JSONB#SQL#GIN#Veri Modelleme
PostgreSQL JSONB: Alan Okuma, Filtreleme ve Güncelleme

JSONB hangi veriler için kullanılabilir?

JSONB, PostgreSQL içinde JSON değerlerini işlemek ve sorgulamak için kullanılan bir veri türüdür. Değişken ürün özellikleri gibi belgeler için işe yarayabilir; ancak bütün alanları tek bir belgeye taşımak zorunlu değildir. PostgreSQL JSON türleri belgesi, saklama ve sorgulama davranışını açıklar.

Bir ürünün kimliği normal sütunda, değişken özellikleri JSONB içinde tutulabilir. Yine de hangi alanların zorunlu olduğu, hangi türleri taşıdığı ve nasıl güncelleneceği bir sözleşme gerektirir. Geçerli JSON saklamak, o belgenin iş kurallarına uygun olduğunu tek başına kanıtlamaz.

Çalışan örnek nasıl hazırlanır?

Aşağıdaki blokları aynı bağlantıda sırayla çalıştırın. Geçici tablodaki specs sütunu bir JSON nesnesi bekler. stock alanının tam sayı olduğu, bu örnek verinin kabulüdür:

CREATE TEMP TABLE catalog_json (
  id integer PRIMARY KEY,
  specs jsonb NOT NULL CHECK (jsonb_typeof(specs) = 'object')
);

INSERT INTO catalog_json VALUES
  (1, '{"color":"blue","stock":0,"tags":["desk","sale"],"note":null}'),
  (2, '{"color":"black","stock":4,"tags":["desk"]}'),
  (3, '{"color":"blue","stock":2,"tags":[]}');

Bu CHECK yalnızca belgenin üst seviyesinin nesne olmasını sağlar. Her anahtarın türünü veya stock değerinin negatif olamayacağını denetlemez. Bu ihtiyaçlar varsa ek doğrulama veya uygun normal sütunlar tasarlayın. Veri bütünlüğü rehberi, kısıtların bu rolünü ele alır.

-> ve ->> arasındaki fark nedir?

-> bir JSONB alanını JSONB olarak, ->> ise metin olarak çıkarır. Görünen değer benzer olsa bile türler farklıdır:

SELECT id,
       specs -> 'stock' AS stock_json,
       specs ->> 'stock' AS stock_text,
       (specs ->> 'stock')::integer AS stock_count
FROM catalog_json
ORDER BY id;

Örnekte stoklar 0, 4 ve 2'dir. Sayısal karşılaştırma yapacaksanız metin sıralamasına güvenmeyin. Burada integer dönüşümü bilinçli olarak yazılmıştır. stock alanına sayıya çevrilemeyen bir metin gelirse dönüşüm hata verebilir; JSONB veri türü bu iş kuralını kendiliğinden uygulamaz.

JSON işlevleri ve operatörleri, alan çıkarma ve tür dönüşümlerinin temel başvurusudur. Bir alanı okuyabilmek ile onun beklediğiniz anlamı taşıdığını doğrulamak ayrı adımlardır.

@> ile belge nasıl filtrelenir?

@>, sol belgenin sağdaki JSONB yapısını içerip içermediğini sınar. Mavi renkli ve pozitif stoklu ürünleri şöyle seçebilirsiniz:

SELECT id
FROM catalog_json
WHERE specs @> '{"color":"blue"}'::jsonb
  AND (specs ->> 'stock')::integer > 0
ORDER BY id;

Sonuç yalnızca id 3'tür. id 1 mavi olsa da stoku sıfırdır. İçerme koşulu, bütün belgenin eşit olmasını istemez; belgedeki diğer alanlar korunabilir. Buna karşılık metin içinden rastgele bir parça aramakla da aynı işlem değildir.

Alanın olmaması ile JSON null aynı şey mi?

Hayır. Bir anahtarın var olup JSON null taşıması ile anahtarın hiç bulunmaması farklı durumlardır. ->> üzerinden okunduğunda ikisi de SQL NULL sonucu verebildiği için varlık kontrolünü ayrıca yapın:

SELECT id,
       specs ? 'note' AS has_note,
       (specs -> 'note') = 'null'::jsonb AS is_json_null,
       (specs ->> 'note') IS NULL AS text_is_sql_null
FROM catalog_json
ORDER BY id;

id 1'de note anahtarı vardır ve JSON null taşır. Diğer iki satırda anahtar yoktur. ? operatörü burada üst seviye nesne anahtarını arar; bütün iç içe belgelerde otomatik bir arama yapmaz. SQL NULL davranışı için NULL rehberine de bakabilirsiniz.

jsonb_set ile tek bir alan nasıl değiştirilir?

jsonb_set, verilen yol için yeni bir JSONB belge değeri üretir. Bu değeri sütuna yazmak için UPDATE kullanılır:

UPDATE catalog_json
SET specs = jsonb_set(specs, '{stock}', '3'::jsonb, false)
WHERE id = 1;

SELECT specs ->> 'stock'
FROM catalog_json
WHERE id = 1;

Sonuç 3'tür. Son argümanın false olması, bulunmayan hedef öğenin eklenmesini istemediğimizi belirtir. Daha derin yollarda önceki adımların varlığı da önemlidir. Bu yöntem bütün eşzamanlı düzenleme sorunlarını çözmez; özellikle istemcide okunmuş eski belgenin tamamını geri yazmak ayrı bir kayıp güncelleme riski taşır.

GIN indeksi bütün filtreleri hızlandırır mı?

Hayır. JSONB için GIN indeksi belirli operatörleri destekleyebilir, fakat her metin dönüşümünü veya sayısal koşulu aynı biçimde kapsamaz. JSONB indeksleme bölümü, sorgu biçimi ile indeks arasındaki ilişkiyi açıklar:

CREATE INDEX catalog_json_specs_gin ON catalog_json USING gin (specs);

EXPLAIN (COSTS OFF)
SELECT id
FROM catalog_json
WHERE specs @> '{"color":"blue"}'::jsonb;

Üç satırlık bu tabloda planlayıcının sıralı tarama seçmesi olağandır; indeks oluşturmak onun mutlaka kullanılacağını garanti etmez. Gerçek veri hacmi, filtre seçiciliği ve operatörlerle ölçüm yapın. EXPLAIN rehberi, planı yorumlama sürecini anlatır.

Sık sorulan sorular

->> sayısal bir alanı sayı olarak mı döndürür? Hayır. Metin döndürür; sayısal işlem için uygun tür dönüşümü gerekir.

IS NULL anahtarın bulunmadığını kanıtlar mı? Tek başına ->> sonucuna bakmak yeterli değildir. JSON null ile eksik anahtarı ayrıca ayırın.

JSONB kullanınca şema tasarımı biter mi? Hayır. Alan türleri, kısıtlar, güncelleme sözleşmesi ve sorgulama ihtiyaçları hâlâ tasarlanmalıdır.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar