Veritabanı Tasarımı & PostgreSQL 38 okunma

PostgreSQL JSONB: Hybrid Veri Modeli

PostgreSQL'in JSONB veri tipi ile hem ilişkisel hem doküman tabanlı veriyi aynı anda kullanma, indexleme (GIN) ve sorgulama teknikleri anlatılır.

PostgreSQL JSONB: Hybrid Veri Modeli

PostgreSQL JSONB: İlişkisel Veritabanında Doküman Tabanlı Çalışma

Uzun yıllardır yazılım dünyasında iki ana veri modeli arasında bir seçim yapmak zorunda kaldık: ya ilişkisel (RDBMS) ya da doküman tabanlı (NoSQL) veritabanları. PostgreSQL'in JSONB veri tipi, bu ikilemi ortadan kaldırarak size her iki dünyanın en iyilerini tek bir veritabanında sunar. İlişkisel veritabanının ACID tutarlılığını, SQL gücünü ve olgunluğunu korurken, JSON dokümanlarının esnekliğinden ve şema esnekliğinden yararlanabilirsiniz. Bu yazıda, JSONB'nin ne olduğunu, nasıl kullanılacağını, GIN indeksleri ile nasıl hızlandırılacağını ve .NET ile nasıl entegre edileceğini derinlemesine inceleyeceğiz.

1. JSONB Nedir? JSON'dan Farkı Ne?

PostgreSQL, JSON verileri için iki farklı veri tipi sunar: JSON ve JSONB.

  • JSON: Veriyi, girildiği gibi, boşlukları ve anahtar sıralamasını koruyarak saklar. Hızlı yazılır ancak sorgulanması yavaştır.

  • JSONB: Veriyi binary (ikili) formatta saklar. Saklanırken ayrıştırılır (pre-parsed), gereksiz boşluklar atılır, anahtarlar sıralanır. Bu, yazma işlemini biraz yavaşlatsa da, okuma ve sorgulama işlemlerini inanılmaz derecede hızlandırır ve indekslenebilir hale getirir.

JSONB, bir nevi PostgreSQL'in NoSQL süper gücüdür. Geliştiricilere, geleneksel sütunların yanında, şemasız, iç içe geçmiş (nested) ve zengin JSON dokümanlarını depolama esnekliği sunar.

2. JSONB ile Tablo Oluşturma ve Veri Ekleme

JSONB kullanımı oldukça basittir. Tıpkı diğer veri tipleri gibi, bir sütunu JSONB olarak tanımlarsınız.

sql

-- Ürünler tablosu oluşturma
CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name TEXT,
    price DECIMAL(10, 2),
    attributes JSONB  -- Esnek özellikler için JSONB sütunu
);

-- Veri ekleme (JSONB sütununa doğrudan JSON gönderebilirsiniz)
INSERT INTO products (name, price, attributes)
VALUES (
    'Running Shoes',
    89.99,
    '{
        "sizes": [7, 8, 9, 10],
        "color": "blue",
        "features": {
            "waterproof": true,
            "cushioning": "high"
        }
    }'
);

Bu örnekte, id, name ve price gibi tüm ürünler için ortak olan alanlar geleneksel sütunlarda tutulurken, her ürüne özel, değişken özellikler (attributes) JSONB sütununda saklanır. Bu, ürün kataloğu gibi senaryolar için mükemmel bir hibrit modeldir.

3. JSONB Sorgulama Operatörleri ve Fonksiyonları

JSONB verilerini sorgulamak için PostgreSQL zengin bir operatör seti sunar.

Operatör Açıklama Örnek
-> JSON nesne alanını veya dizi elemanını JSONB olarak döndürür attributes->'color'
->> JSON nesne alanını veya dizi elemanını metin (TEXT) olarak döndürür attributes->>'color'
@> Soldaki JSON dokümanı, sağdaki JSON dokümanını içeriyor mu? (Containment) attributes @> '{"color": "blue"}'
? Belirtilen anahtar (key) JSON'da var mı? (Key Existence) attributes ? 'sizes'
?| Belirtilen anahtarlardan herhangi biri var mı? attributes ?| array['color', 'size']
?& Belirtilen tüm anahtarlar var mı? attributes ?& array['color', 'sizes']
@? JSONPath ifadesi ile eşleşiyor mu? attributes @? '$.sizes[*] ? (@ > 8)'

Sorgu Örnekleri:

sql

-- 1. Tüm ürünlerin renklerini getir (->> metin olarak döndürür)
SELECT name, attributes->>'color' AS color FROM products;

-- 2. Rengi 'blue' olan ürünleri bul (Kapsama - @> operatörü)
SELECT * FROM products WHERE attributes @> '{"color": "blue"}';

-- 3. 'sizes' anahtarına sahip ürünleri bul (Anahtar var mı? - ? operatörü)
SELECT * FROM products WHERE attributes ? 'sizes';

-- 4. 9 numara bedeni olan ürünleri bul (İç içe dizi sorgulama)
SELECT * FROM products WHERE attributes @> '{"sizes": [9]}';

-- 5. Fiyatı 100'den büyük ve 'waterproof' özelliği true olan ürünleri bul (JSONPath ile)
SELECT * FROM products 
WHERE attributes @? '$.features.waterproof == true' 
AND price > 100;

@> operatörü, JSON dokümanının tamamını veya bir kısmını eşleştirmek için oldukça güçlüdür.

4. Performansın Anahtarı: GIN İndeksleri

JSONB sütunları üzerinde yapılan sorgular, indekslenmezse tüm tabloyu tarar (sequential scan) ve büyük veri kümelerinde çok yavaş olabilir. İşte bu noktada GIN (Generalized Inverted Index) indeksleri devreye girer.

Standart B-Tree indeksleri, JSON gibi iç içe geçmiş yapılar için uygun değildir. GIN indeksi ise JSONB dokümanını parçalara ayırarak içindeki anahtar ve değerleri indeksler, adeta devasa bir arama tablosu oluşturur.

GIN İndeksi Oluşturma:

sql

-- En yaygın kullanım: Tüm JSONB sütununu indeksle
CREATE INDEX idx_products_attributes_gin ON products USING gin (attributes);

Varsayılan olarak oluşturulan bu indeks, @>, ?, ?|, ?& operatörlerini destekler.

İndeks Operatör Sınıfları (jsonb_ops vs jsonb_path_ops):

PostgreSQL, GIN indeksleri için iki farklı operatör sınıfı sunar:

  • jsonb_ops (Varsayılan): JSONB'deki her anahtarı ve her değeri ayrı ayrı indeksler. En geniş operatör desteğini sağlar (@>, ?, ?|, ?&, @?, @@). Ancak indeks boyutu büyüktür (JSONB sütununun 2-3 katı).

  • jsonb_path_ops: Yalnızca JSONPath tarzı kök-değer yollarının hash'ini indeksler. Sadece @> operatörünü (ve kısıtlı olarak @?, @@) destekler. Ancak indeks boyutu yaklaşık yarı yarıya küçüktür ve özellikle kapsama (containment) sorgularında (@>) çok daha hızlıdır.

sql

-- jsonb_path_ops ile indeks oluşturma (Daha küçük ve daha hızlı, sadece @> için)
CREATE INDEX idx_products_attributes_path_gin ON products USING gin (attributes jsonb_path_ops);

Hangi İndeks Ne Zaman Kullanılır?

İhtiyaç Önerilen İndeks Açıklama
Sadece @> (kapsama) sorguları yapıyorsanız jsonb_path_ops Daha küçük, daha hızlı
?, ?|, ?& gibi anahtar sorguları da yapıyorsanız jsonb_ops Daha geniş operatör desteği
Belirli bir anahtarı çok sık sorguluyorsanız Expression B-Tree Çok küçük ve hızlı

Expression B-Tree İndeksi (Belirli Bir Anahtar İçin):

Eğer bir JSONB alanındaki belirli bir anahtarı (örn. status) çok sık sorguluyorsanız, o anahtar için özel bir B-Tree indeksi oluşturabilirsiniz.

sql

-- status anahtarını metin olarak çıkaran bir B-Tree indeksi
CREATE INDEX idx_products_status_btree ON products ((attributes->>'status'));

-- Numerik bir alan için (cast ile)
CREATE INDEX idx_products_total_btree ON products (((attributes->>'total')::numeric));

Bu indeks, WHERE attributes->>'status' = 'active' gibi sorgular için kullanılabilir ve çok küçük ve hızlıdır.

5. Hangi Sorgular GIN İndeksini Kullanır?

Bir GIN indeksi oluşturduktan sonra, tüm JSONB sorgularının bundan faydalanamayacağını unutmamak gerekir.

GIN İndeksi Kullanabilen Sorgular:

  • Kapsama (Containment): data @> '{"plan": "pro"}'

  • Anahtar Varlığı (Key Existence): data ? 'status'

  • Herhangi Bir Anahtar Eşleşmesi: data ?| array['plan', 'tier']

  • Tüm Anahtarların Eşleşmesi: data ?& array['plan', 'status']

GIN İndeksi KULLANAMAYAN Sorgular (Dikkat!):

  • Yol tabanlı navigasyon: data->'user'->>'email' = 'craig@example.com'

  • JSONB içinde karşılaştırmalar: (data->>'age')::int > 30

  • Regex veya desen eşleşmesi: data->>'name' ILIKE 'craig%'

Bu tür sorgular için ya yukarıda bahsedilen Expression B-Tree indeksleri oluşturmalı ya da JSONPath ile sorgulamayı denemelisiniz.

6. .NET (EF Core) ile JSONB Kullanımı

Entity Framework Core, PostgreSQL ile JSONB sütunlarını kullanmak için harika bir destek sunar. Npgsql.EntityFrameworkCore.PostgreSQL paketi ile JSONB sütunlarını C# nesnelerine kolayca eşleyebilirsiniz.

Model Tanımlama:

csharp

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    
    // JSONB sütunu için bir C# nesnesi
    public ProductAttributes Attributes { get; set; }
}

public class ProductAttributes
{
    public List<int> Sizes { get; set; }
    public string Color { get; set; }
    public Features Features { get; set; }
}

public class Features
{
    public bool Waterproof { get; set; }
    public string Cushioning { get; set; }
}

DbContext Yapılandırması:

csharp

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Product>()
        .Property(p => p.Attributes)
        .HasColumnType("jsonb")  // Sütun tipini JSONB olarak belirt
        .HasConversion(
            v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
            v => JsonSerializer.Deserialize<ProductAttributes>(v, (JsonSerializerOptions)null)
        );
}

JSONB Üzerinde Sorgulama (EF Core 8.0 ile Gelen JSON Sorgu Desteği):

EF Core 8.0, JSON sütunları üzerinde doğrudan sorgulama yapma yeteneği sunar.

csharp

// Rengi "blue" olan ürünleri getir
var blueProducts = await context.Products
    .Where(p => p.Attributes.Color == "blue")
    .ToListAsync();

// 'sizes' dizisinde 9 olan ürünleri getir
var size9Products = await context.Products
    .Where(p => p.Attributes.Sizes.Contains(9))
    .ToListAsync();

// Waterproof özelliği true olan ürünleri getir
var waterproofProducts = await context.Products
    .Where(p => p.Attributes.Features.Waterproof)
    .ToListAsync();

EF Core bu sorguları, ilgili SQL/JSONB operatörlerine (@>, ->, ->>) çevirir ve PostgreSQL'de çalıştırır.

7. JSONB Kullanım Senaryoları ve En İyi Pratikler

  • Ne Zaman Kullanmalı?

    • Esnek ve Değişken Veri Modelleri: Ürün özellikleri, kullanıcı tercihleri, form alanları gibi her kayıt için farklılık gösterebilecek veriler.

    • Harici API Yanıtları: Üçüncü parti API'lerden gelen JSON yanıtlarını olduğu gibi saklamak.

    • Denetim Günlükleri (Audit Logs): Değişiklikleri JSON olarak saklamak.

    • Hızlı Prototipleme: Şema değişikliklerinden kaçınarak hızlı geliştirme yapmak.

  • Ne Zaman Kullanmamalı?

    • Sıkı ve Değişmez Veri Modelleri: Tüm kayıtlar için aynı alanların geçerli olduğu durumlar (örn. finansal işlemler). Bu durumda geleneksel sütunlar daha verimlidir.

    • Karmaşık İlişkiler ve JOIN'ler: JSONB içindeki verilerle diğer tablolar arasında sık sık JOIN yapmanız gerekiyorsa, bu verileri normalleştirilmiş tablolara taşımayı düşünün.

    • Çok Büyük Dokümanlar: Çok büyük JSONB dokümanları (MB seviyesinde) TOAST mekanizması nedeniyle performansı etkileyebilir.

Performans İpuçları:

  1. İndeksleri Doğru Seçin: Sorgu deseninize göre jsonb_ops, jsonb_path_ops veya Expression B-Tree indekslerinden birini tercih edin.

  2. jsonb_path_ops'u Deneyin: Çoğu @> kapsama sorgusu için jsonb_path_ops daha iyi performans gösterir.

  3. Gereksiz İndekslerden Kaçının: Her GIN indeksi, INSERT ve UPDATE işlemlerini yavaşlatır. Sadece ihtiyacınız olan indeksleri oluşturun.

  4. Sorgularınızı Analiz Edin: EXPLAIN ANALYZE kullanarak sorgularınızın indeksleri kullanıp kullanmadığını kontrol edin.

Sonuç:

PostgreSQL JSONB, ilişkisel veritabanının gücünü ve doküman tabanlı veritabanlarının esnekliğini tek bir çatı altında toplayan devrimsel bir özelliktir. Doğru indeksleme stratejileriyle (özellikle GIN indeksleri), JSONB sütunları üzerinde yapılan sorgular da son derece hızlı olabilir.

JSONB, sizi "schema migration" cehenneminden kurtararak, ürün katalogları, kullanıcı profilleri ve esnek veri modelleri için ideal bir çözüm sunar. Bir sonraki projenizde, veri modelinizin hangi kısmının esnek olması gerektiğini düşünün ve PostgreSQL'in bu süper gücünü kullanmaktan çekinmeyin.

Tüm yazılar