n8n'de Split In Batches Node Nasıl Çalışır?

n8n, görsel bir Workflow Automation platformudur. İş akışlarınızda bazen bir API'ye yüzlerce kaydı tek seferde göndermeniz gerekir. Ancak çoğu API istek başına belirli bir limit koyar (örneğin maksimum 100 kayıt). Ayrıca iş akışınızın belleği de sınırsız değildir. İşte tam bu noktada n8n'in Split In Batches node'u devreye girer.

Split In Batches Node Nedir?

Bu node, kendisine gelen bir diziyi (array) belirlediğiniz büyüklükteki parçalara (batch’lere) böler. Her bir batch, iş akışının devamındaki adımlara ayrı ayrı gönderilir. Yani node girdi olarak 500 elemanlı bir dizi alır, siz batch boyutunu 100 yaparsanız, 5 adet 100’lük grup üretir ve bunları sırayla sonraki node’lara iletir.

Neden Batch’lere Bölmek Gerekir?

Üç ana sebep vardır:

• Bellek (Memory) Sınırı: n8n iş akışları çalışırken tüm veriyi RAM’de tutar. 10.000 kaydı tek seferde işlemek bellek taşmasına yol açabilir. Batch’lere bölmek her seferinde daha az veri kullanılmasını sağlar.
• API Rate Limit: Harici bir servise istek atarken (örneğin bir e-posta API’si) çoğu sağlayıcı saniyede/dakikada belirli sayıda isteğe izin verir. Batch’ler halinde göndermek, limiti aşmamanızı sağlar.
• Hata Yönetimi: Bir batch hata verdiğinde sadece o grubu yeniden işlemek yeterli olur; tüm süreç baştan başlamaz.

Adım Adım Nasıl Çalışır?

1. Giriş Verisi

Node, girişte bir dizi bekler. Örneğin bir veritabanından çekilen müşteri listesi. Dizi, her biri bir nesne olan bir listedir.

2. Batch Boyutu Belirleme

Node’un ayarlarında “Batch Size” değerini girersiniz. Örneğin 100. Bu, her bir grupta 100 kayıt olacağı anlamına gelir.

3. Bölme ve Sıralama

Node, diziyi baştan sona tarar. İlk 100 elemanı alıp bir batch oluşturur, sonraki 100’ü alıp ikinci batch, … bu şekilde tüm dizi bitene kadar devam eder. Her bir batch ayrı bir çıktı bağlantısından (output) veya sırayla aynı çıktıdan gönderilir.

4. Sonraki Adımlar

Her batch, akışın bir sonraki node’una ayrı bir tetikleme (execution) olarak gelir. Eğer “Process Each Batch Separately” seçeneği işaretliyse, her batch için ayrı bir iş akışı çalıştırılır; bu sayede bir batch hata verse bile diğerleri etkilenmez.

Gerçek Hayattan Bir Senaryo

Diyelim ki bir diş kliniğinin randevu hatırlatma mesajlarını WhatsApp üzerinden göndermek için bir Workflow Automation kuruyorsunuz. 500 hastanız var, ancak kullandığınız SMS/WhatsApp API’si her istekte en fazla 50 mesaja izin veriyor. Split In Batches node’unu batch size 50 olarak ayarlarsınız. Node, 500 kaydı 10 batch’e böler ve sırayla API’ye gönderir. Böylece hem API limiti aşılmaz hem de işlem başarıyla tamamlanır.

Batch Boyutu Seçerken Nelere Dikkat Edilmeli?

Batch boyutunu belirlerken hedef API’nin limitlerini, ortalama kayıt boyutunu ve n8n’in çalıştığı sunucunun bellek kapasitesini göz önünde bulundurun. Çok küçük batch’ler (örneğin 1) çok fazla istek oluşturur ve işlem süresini uzatır. Çok büyük batch’ler ise bellek sorununa yol açabilir. Genellikle 100-500 arası iyi bir başlangıçtır.

Sonuç

n8n’in Split In Batches node’u, büyük veri kümelerini yönetmek için vazgeçilmez bir araçtır. Doğru kullanıldığında iş akışlarınızın hem daha güvenilir hem de daha verimli çalışmasını sağlar. Unutmayın: Tek seferde işlemek yerine parçala ve yönet!