GraphQL'de N+1 Problemi ve DataLoader

GraphQL'de N+1 Problemi ve DataLoader ile Çözümü

GraphQL, istemcilere ihtiyaç duydukları veriyi tam olarak belirleme esnekliği sunar. Ancak bu esneklik, özellikle ilişkisel verilerde, N+1 sorgu problemi olarak bilinen ciddi bir performans sorununa yol açabilir. Bu yazıda, N+1 probleminin GraphQL bağlamında neden ortaya çıktığını, DataLoader ile nasıl etkili bir şekilde çözüleceğini ve .NET ekosisteminde (Hot Chocolate, GreenDonut) uygulama stratejilerini inceleyeceğiz.

1. N+1 Problemi Nedir?

N+1 problemi, bir ana sorgunun (N adet kayıt getiren) ardından, her bir kayıt için ayrı ayrı (N adet) alt sorgu çalıştırılması durumudur. Toplamda 1 (ana) + N (alt) sorgu = N+1 sorgu anlamına gelir.

Klasik Örnek (REST / ORM):

csharp

var orders = db.Orders.ToList(); // 1 sorgu (N sipariş)
foreach (var order in orders)
{
    var customer = db.Customers.Find(order.CustomerId); // N sorgu (her sipariş için)
    Console.WriteLine(customer.Name);
}

Bu kod, 1000 sipariş varsa 1001 sorgu çalıştırır.

2. GraphQL'de N+1 Problemi Neden Daha Belirgindir?

GraphQL, istemcinin iç içe (nested) alanları talep etmesine olanak tanır. Örneğin:

graphql

query {
  orders {
    id
    total
    customer {
      name
      email
    }
  }
}

Eğer GraphQL çözümleyiciniz (resolver) her order için customer verisini ayrı ayrı veritabanından çekerse, N+1 problemi kaçınılmazdır. GraphQL'in bu yapısı, problem oluşma olasılığını ve etkisini artırır.

Örnek (Kötü Çözüm - N+1 ile):

csharp

[UseDbContext(typeof(AppDbContext))]
public async Task<IEnumerable<Order>> GetOrdersAsync([ScopedService] AppDbContext context)
{
    return await context.Orders.ToListAsync(); // 1. sorgu
}

public async Task<Customer> GetCustomerAsync(Order order, [ScopedService] AppDbContext context)
{
    // Her sipariş için ayrı sorgu -> N sorgu!
    return await context.Customers.FindAsync(order.CustomerId);
}

Bu yaklaşım, 100 sipariş için 101 sorgu anlamına gelir.

3. DataLoader ile Çözüm

DataLoader, Facebook tarafından geliştirilmiş ve GraphQL ekosisteminde standart haline gelmiş bir kütüphanedir. İki temel prensiple çalışır:

Toplu Yükleme (Batching): Aynı anda gelen veri taleplerini tek bir toplu sorguda birleştirir.
Önbellekleme (Caching): Tek bir istek döngüsünde aynı veri taleplerini önbelleğe alarak tekrar sorguyu önler.

DataLoader Çalışma Prensibi:

Çözümleyici (resolver) DataLoader.LoadAsync(key) çağrısı yapar.
DataLoader, çağrıları toplar ve bir sonraki işlem döngüsünde (genellikle Task.Delay(1) veya Context ile) hepsini tek bir toplu yükleme fonksiyonuna (batch function) iletir.
Toplu yükleme fonksiyonu, tüm anahtarlarla tek bir veritabanı sorgusu (örn. WHERE Id IN (...)) çalıştırır.
Sonuçlar, anahtarlara göre eşleştirilerek her bir çağrıya dağıtılır.

4. .NET'te DataLoader Uygulaması (Hot Chocolate ile)

Hot Chocolate, .NET için en popüler GraphQL sunucularından biridir ve GreenDonut adlı yerleşik DataLoader implementasyonunu içerir.

Adım 1: DataLoader'ı Tanımlama

csharp

// CustomerDataLoader.cs
using GreenDonut;
using HotChocolate.DataLoader;

public class CustomerDataLoader : BatchDataLoader<int, Customer>
{
    private readonly AppDbContext _context;

    public CustomerDataLoader(AppDbContext context, IBatchScheduler batchScheduler)
        : base(batchScheduler)
    {
        _context = context;
    }

    protected override async Task<IReadOnlyDictionary<int, Customer>> LoadBatchAsync(
        IReadOnlyList<int> keys, CancellationToken cancellationToken)
    {
        // Tek bir sorgu ile tüm müşterileri getir
        var customers = await _context.Customers
            .Where(c => keys.Contains(c.Id))
            .ToDictionaryAsync(c => c.Id, cancellationToken);

        return customers;
    }
}

Adım 2: DataLoader'ı Servis Olarak Kaydetme

csharp

// Program.cs
builder.Services.AddScoped<CustomerDataLoader>();

Adım 3: Çözümleyicide DataLoader Kullanımı

csharp

[ExtendObjectType(typeof(Order))]
public class OrderResolvers
{
    public async Task<Customer> GetCustomerAsync(
        [Parent] Order order,
        CustomerDataLoader customerDataLoader,
        CancellationToken cancellationToken)
    {
        // Her bir sipariş için ayrı sorgu yerine, DataLoader üzerinden tek bir sorgu
        return await customerDataLoader.LoadAsync(order.CustomerId, cancellationToken);
    }
}

Artık orders { id customer { name } } sorgusu, 100 sipariş için sadece 2 sorgu (1 siparişler + 1 müşteriler) çalıştırır.

5. DataLoader'ın Avantajları

Performans: Veritabanı sorgu sayısı N+1'den ~2'ye düşer.
Önbellekleme: Aynı istek döngüsü içinde aynı müşteri birden fazla kez talep edilirse, sadece bir sorgu çalışır.
Ölçeklenebilirlik: Uygulama büyüdükçe, veritabanı yükünü kontrol altında tutmaya yardımcı olur.

6. Alternatif Çözümler

DataLoader en etkili yöntem olsa da, alternatif yaklaşımlar da vardır:

Yöntem	Açıklama	Artılar	Eksiler
Eager Loading (Önceden Yükleme)	Ana sorguda `Include` / `ThenInclude` ile ilişkili verileri önceden yüklemek.	Basit, uygulaması kolay.	Her zaman mümkün değil (dinamik sorgularda), gereksiz veri getirebilir.
View / Stored Procedure	Karmaşık sorguları veritabanı tarafında optimize etmek.	Veritabanı seviyesinde optimizasyon.	Esneklik azalır, GraphQL'in dinamik yapısına uyum zordur.
Dapper / Ham SQL	ORM yerine ham SQL ile verimli sorgular yazmak.	Tam kontrol, yüksek performans.	Bakım zorluğu, SQL yazma yükü.

7. En İyi Pratikler

DataLoader'ı Her İlişkili Veri İçin Kullanın: Her [Parent] bazlı ilişkili veri talebinde DataLoader kullanmayı alışkanlık haline getirin.
Batch Key Türünü Doğru Seçin: Çoğu durumda int veya Guid yeterlidir. Karmaşık anahtarlar için ValueTuple veya özel tipler kullanabilirsiniz.
Önbelleği Yönetin: DataLoader, varsayılan olarak istek döngüsü boyunca önbellek tutar. Uzun ömürlü önbellek için DataLoaderOptions üzerinden yapılandırabilirsiniz.
Batch Fonksiyonunda Hata Yönetimi: LoadBatchAsync içinde olası hataları yönetin ve keys ile eşleştirirken eksik anahtarları (default(T)) ele alın.
Hot Chocolate ile Otomatik DataLoader Kaydı: Hot Chocolate 13+ ile AddDataLoader<T> servis kaydını kullanabilirsiniz.

csharp

builder.Services.AddDataLoader<CustomerDataLoader>(); // Hot Chocolate 13+

Sonuç

GraphQL'in esnek sorgulama yeteneği, N+1 problemini özellikle belirgin hale getirir. DataLoader, bu sorunu toplu yükleme (batching) ve önbellekleme (caching) ile zarif bir şekilde çözer. .NET ekosisteminde Hot Chocolate ve GreenDonut, DataLoader uygulamasını oldukça kolaylaştırır. DataLoader'ı doğru kullanarak, GraphQL API'lerinizde hem esneklik hem de yüksek performans elde edebilirsiniz.

İlgili Yazılar