Menu

PostgreSQL JSONB Kullanımı: Operatörler, Sorgular, İndeksler

PostgreSQL'de jsonb ile JSON saklamak ve sorgulamak: -> ve ->> operatörleri, @> ile içerme, jsonb_set ve diğer güncellemeler, dizileri satırlara çevirmek, GIN indeksleri ve json ile jsonb farkı.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

jsonb, PostgreSQL'in ikili (binary) JSON sütun tipidir. Alanları -> (jsonb döndürür) ve ->> (text döndürür) ile oku, satırları @> içerme operatörüyle bul, alanları da jsonb_set ya da || ile değiştir. Bir GIN indeksi bu sorguları hızlandırır.

1 ve 3 numaralı siparişler eşleşir. data->'customer' iç içe nesneyi jsonb olarak döndürür, ->>'name' adı metin olarak çeker, ->> ile bir cast de toplamı sayıya çevirir.

JSONB'den değer almak

OperatörNe döndürürÖrnek
-> anahtar ya da indeksjsonbdata->'customer', data->'tags'->0
->> anahtar ya da indekstextdata->>'status'
#> yoljsonbdata#>'{customer,city}'
#>> yoltextdata#>>'{customer,city}'
[...] subscript (PostgreSQL 14+)jsonbdata['customer']['city']

Dizi indeksleri 0'dan başlar, negatif bir indeks de sondan sayar (-> -1 son elemandır). Eksik bir anahtar hata değil, SQL NULL verir; bu yüzden yukarıdaki 3 numaralı siparişin şehri NULL.

Bir metinle karşılaştırmak ya da cast etmek için ->> kullan: data->>'status' = 'paid'. Gezinmeye devam etmek için -> kullan. Sık yapılan bir hata data->'status' = 'paid' yazmaktır. PostgreSQL 'paid' değerini JSON olarak okur, tırnaksız bir kelime geçerli JSON değildir ve sorgu "invalid input syntax for type json" hatasıyla başarısız olur.

JSON içeriğine göre satır bulmak

@>, soldaki değerin sağdakini içerip içermediğini test eder. Her derinlikte ve dizilerin içinde çalışır, bir GIN indeksi de onu destekler:

1 ve 2 numaralı ürünlerde M beden ve bir fiyat var; yalnızca 2 numaralı ürün 30'dan pahalı. Arama operatörleri:

  • @> içerir, <@ içinde yer alır.
  • ? anahtar (ya da dizideki metin) var, ?| anahtarlardan herhangi biri var, ?& hepsi var.
  • @? ve @@ belgenin içindeki karşılaştırmalar için bir JSON path sorgusu çalıştırır (PostgreSQL 12+).

JSONB içindeki alanları güncellemek

PostgreSQL her güncellemede değerin tamamını yeniden yazar, ama bu fonksiyonlar yalnızca değişikliği tarif etmeni sağlar:

  • jsonb_set(target, path, new_value) bir yoldaki tek bir değeri değiştirir.
  • - bir anahtarı kaldırır, #- ise '{notify,sms}' gibi iç içe bir yolu kaldırır.
  • || en üst düzey anahtarları ekler ya da üzerine yazar.

PostgreSQL 14'ten beri subscript üzerinden de atama yapabilirsin: SET prefs['notify']['email'] = 'false'.

İki tuzak:

  • Yeni değer SQL NULL olduğunda jsonb_set NULL döndürür ve UPDATE tüm sütunu siler. COALESCE(to_jsonb(x), 'null') geç ya da varsayılan olarak JSON null saklayan jsonb_set_lax (PostgreSQL 13+) kullan.
  • jsonb_set eksik son anahtarı ekler ama eksik üst anahtarları eklemez: {} üzerinde '{a,b}' ayarlamak onu değiştirmeden bırakır. Subscript ile atama ise onları oluşturur.

JSON dizilerini satırlara çevirmek

jsonb_array_elements dizinin her elemanı için bir satır döndürür, jsonb_to_recordset de bir nesne dizisini tipli sütunlara çevirir. PostgreSQL 17'den beri standart JSON_TABLE ikisini tek yerde yapar:

A-1'den 3, B-2'den 1 adet satıldı. Ters yönde, jsonb_build_object('id', id, 'name', name) sütunlardan bir nesne kurar, jsonb_agg da satırları bir dizide toplar (string_agg ve array_agg sayfasına bak).

JSONB'yi GIN ile indekslemek

Sütunun tamamı üzerindeki bir GIN indeksi @>, ?, ?|, ?&, @? ve @@ operatörlerine hizmet eder:

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

Sorguyu indeksin desteklediği biçimde yaz. WHERE data @> '{"status": "paid"}' GIN indeksini kullanabilir. WHERE data->>'status' = 'paid' kullanamaz; ifade indeksine ihtiyaç duyar. (data->>'total')::numeric > 50 gibi bir aralık testi de tam o ifade üzerinde bir ifade indeksi ister.

JSON ve JSONB

jsonjsonb
Nasıl saklanırGirdi metni olarakAyrıştırılmış ikili biçimde
Boşluklar, anahtar sırası, yinelenen anahtarlarKorunurKaldırılır; son yinelenen kazanır
YazmaBiraz daha hızlı (yalnızca doğrulanır)Girdide ayrıştırılır
Okuma ve sorgulamaHer erişimde yeniden ayrıştırılırHızlı
@>, ? ve GIN indeksleriHayırEvet

json metni değiştirmeden döndürür; jsonb yalnızca "a": 3 değerini tutar ve anahtarların sırasını değiştirir. Saklanmış bir webhook payload'u gibi orijinal metni bayt bayt döndürmen gerekmiyorsa jsonb kullan. Her satırda olan ya da yabancı anahtar gerektiren alanları normal sütunlarda tut. Tüm operatörler ve fonksiyonlar resmi JSON fonksiyonları başvuru belgesinde listeleniyor.

Sıkça Sorulan Sorular

PostgreSQL'de -> ile ->> arasındaki fark nedir?

-> değeri jsonb olarak döndürür, böylece içinde gezinmeye devam edebilirsin (data->'customer'->'city'). ->> ise değeri text olarak döndürür; bir metinle karşılaştırırken ya da sayıya çevirirken bunu kullanırsın: (data->>'total')::numeric.

Bir JSONB dizisinin bir değer içerip içermediğini nasıl kontrol ederim?

İçerme operatörünü kullan: data->'tags' @> '["gift"]' ya da belgenin en üstünden test etmek için data @> '{"tags": ["gift"]}'. Metinlerden oluşan bir dizi için data->'tags' ? 'gift' de çalışır. data üzerindeki bir GIN indeksi ikinci biçimi hızlandırır.

JSONB anahtarların sırasını korur mu?

Hayır. jsonb anahtarları kendi sırasıyla saklar, boşlukları kaldırır ve yinelenen anahtarlardan yalnızca sonuncusunu tutar. Orijinal metni aynen geri alman gerekiyorsa json tipini kullan.

JSONB'de bir anahtarın var olup olmadığını nasıl kontrol ederim?

En üst düzeydeki nesnede o anahtar varsa data ? 'key' true döner; değeri JSON null olsa bile. ?| bir dizi alır ve anahtarlardan herhangi biri varsa, ?& ise hepsi varsa true döner.

JSONB içindeki bir alana yabancı anahtar ya da NOT NULL kısıtı ekleyebilir miyim?

Doğrudan ekleyemezsin. Bir CHECK kısıtı bir alanı test edebilir (CHECK (data ? 'email')), ama yabancı anahtarlar gerçek bir sütun ister. Her satırda olan ve başka tabloların başvurduğu alanlar normal sütunlarda durmalıdır.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla