SQL ile mükerrer olayları önlemek: idempotency, yarış koşulları ve güvenli yeniden deneme
Aynı API olayı iki kez geldiğinde neden iki satır oluşur? Benzersiz anahtar, UPSERT, transaction ve outbox yaklaşımıyla veri bütünlüğü.
Bir olay neden iki kez gelir?
Modern API'lerde istemci isteği gönderir, sunucu işlemi tamamlar ama yanıtın yolu kesilir. İstemci zaman aşımı görüp aynı isteği tekrar gönderdiğinde sunucunun elinde birinci işlemin tamamlandığı bilgisi olmayabilir. Ödeme, yorum aktarımı, bildirim ve rezervasyon gibi alanlarda bu tekrar, mükerrer kayıt veya iki kez eylem yapılması anlamına gelebilir. Sorunu uygulama tarafında yalnız 'kayıt var mı' sorgusuyla çözmeye çalışmak yeterli değildir. Aynı anda çalışan iki işçi, her ikisi de kayıt bulunmadığını gördükten sonra ayrı INSERT gönderebilir. Bu yarış koşulu, test ortamında az görünürken yüksek eşzamanlılıkta ortaya çıkar. Verinin tanımı içinde hangi alan birleşiminin gerçekten tekil olması gerektiği en başta kararlaştırılmalıdır. Böylece tekrar denemeyi engellemek yerine güvenli hâle getirebilirsiniz.
Kararlı kimlik ve benzersiz kısıt
Idempotency key, aynı mantıksal işleme ait tekrar istekleri ilişkilendiren kararlı bir anahtardır. Her ağ denemesinde yeniden üretilirse amacını kaybeder; anahtar ilk istekte oluşturulur ve tekrarların tümünde korunur. SQL tablosunda bu anahtar için UNIQUE kısıtı kurmak eşzamanlı işçilerin aynı satırı iki kez eklemesini önler. Anahtarın kapsamı önemlidir: bir kullanıcının iki farklı gerçek siparişinin yanlışlıkla aynı sayılmaması için kullanıcı veya işlem türüyle birlikte düşünülmesi gerekebilir. İçerik kimliği ve kaynak yorumu eşlemesinde de aynı mantık geçerlidir. Dış hizmetten gelen kimlik güvenilir değilse yayıncı kimliği, kaynak bağlantısı ve normalize edilmiş içerik özetinin uygun birleşimi kullanılabilir. Yalnız başlık veya tarih üzerinden tekillik kurmak gerçek farklı kayıtları hatalı birleştirebilir.
UPSERT, transaction ve sonuç tekrarını düşünmek
Benzersiz kısıtın ardından UPSERT ile ilk yazma ve tekrar yazmayı aynı kurala bağlayın. Ancak 'çakışınca güncelle' seçeneğinin eski veriyi yanlışlıkla üzerine yazmadığını kontrol edin. Bazı işlerde tekrar istek geldiğinde kayıt güncellenmek yerine ilk işlemin sonucu döndürülmelidir. Bu nedenle işlem anahtarını, durumunu ve döndürülen yanıtın gerekli özetini ayrı kaydetmek faydalıdır. İlişkili birden çok D1 veya SQL tablosu güncellenecekse aynı veri tabanı sınırında transaction kullanın. Dosya deposu, e-posta veya dış API çağrıları transaction içine otomatik olarak dahil değildir. Olayın 'veritabanına kaydedildi' ve 'dış sisteme gönderildi' aşamalarını ayıran outbox yaklaşımı burada yardımcı olur. Güvenilir işlem işleme yöntemi tek SQL komutu değil, tüm adımların açık durum modelidir.
Başarısız işlemi geri almak yerine güvenle sürdürmek
Bir görev ortada durduğunda ilk yapılacak iş hangi adımın kalıcı olarak tamamlandığını okumaktır. Kayıt eklendi ama bildirim gönderilmedi mi? Medya yüklendi ama ilişki kurulmadı mı? Her durumu tekrar çalıştırmak yerine yalnız eksik adımdan devam eden akış tasarlayın. Aynı dış çağrı iki kez yapılmış olabiliyorsa alıcı API'nin de idempotency mekanizması olup olmadığını inceleyin. Üstel gecikmeli ve sınırlı tekrar politikası servisleri aşırı yüklemeden iyileşme fırsatı yaratır. Tekrarlı başarısızlıkları sonsuz kuyrukta tutmak yerine nedeni ölçmek ve işleme koşulu düzelince kontrollü tekrar denemek daha yararlıdır. Her güncellemede önceki değer, yeni değer, işlem kimliği ve sonuç doğrulaması kaydedildiğinde kök neden araştırması hızlanır.
Üretim testlerini nasıl kurmalı?
Aynı olay kimliğini yüz kez paralel gönderen bir test hazırlayın; sonuçta tek mantıksal kayıt bekleyin. Ardından aynı müşteri için iki farklı gerçek işlem gönderin; bunların yanlışlıkla birleşmediğini doğrulayın. Bağlantıyı yazma sonrasında ve yanıt öncesinde kapatıp tekrar isteğini test edin. UPSERT sırasında güncellenmemesi gereken alanların korunduğunu ve hatalı işlemde transaction'ın geri alındığını ölçün. Dış sistem bağımlıysa outbox kaydının beklenen durumda kaldığını ve iş yeniden başladığında tamamlandığını doğrulayın. Bu kontroller beş başarılı manuel denemeden daha fazla güven verir. Hedef mükerrerlik sayısını sıfıra indirirken gerçek kayıtları kaybetmemek; performans ve kota maliyetini de ölçülen ihtiyaç sınırında tutmaktır.
SQL taslağı ve işlem sonucu
Örneğin bir API isteğinin benzersiz işlem kimliğini tutan bir tablo oluşturduğunuzu varsayalım. Kimlik sütununda UNIQUE kısıtı bulunur; işlem durumu 'işleniyor', 'başarılı' veya 'hatalı' olarak izlenir. Aynı kimlikle tekrar istek gelirse önceki işlem tamamlandıysa saklanan yanıt döndürülür, sürüyorsa çakışma yönetimi uygulanır. Buradaki önemli ayrıntı, iki farklı kimliğin aynı kayda yazmak istemesi durumunda hâlâ eşzamanlılık sorunu yaşanabilecek olmasıdır. Bu nedenle hedef kaydın sürümü veya transaction içindeki diğer bütünlük koşulları ayrıca korunmalıdır. Veritabanı kısıtı uygulamadaki kontrolün yerine geçmez; ikisi birlikte anlamlıdır. Bir operasyonun durumunu ve etkilediği kaynakları ayrı tutmak, hem istemciye tutarlı yanıt vermeyi hem yeniden denemelerin doğru davranmasını sağlar.
Dış sisteme gönderim ikilemi
Bir sipariş satırı yazdıktan sonra bildirim veya ödeme API'sine istek gönderen uygulamayı düşünelim. İlk yazma başarılı, ikinci çağrı başarısız olabilir. Her şeyi geri alıp ilk işlemi silmek bazen doğru değildir, çünkü dış sistem beklenmedik biçimde işlemi tamamlamış olabilir. Outbox tablosuna 'gönderilmeyi bekliyor' kaydı yazıp ayrı bir işçinin bunu göndermesi, işlem durumunu gözlemlemeyi kolaylaştırır. Ancak outbox tek başına aynı bildirimden iki kez göndermeme garantisi sağlamaz; alıcıya kararlı işlem kimliği taşımak ve tekrarları tanımlamak da gerekir. Operasyon sırasında üç ayrı sayı takip edilmelidir: yeni kayıt edilen olay, gerçekten teslim edilen dış çağrı ve tekrar nedeniyle engellenen işlem. Bu ayrım hem kapasite yönetimini hem hata araştırmasını kolaylaştırır.
Yorumlar
Henüz yorum yok. İlk katkıyı sen yapabilirsin.
Okuyucu tartışması nasıl görünebilir?Temsili
Aşağıdaki adlar, yorumlar ve editör yanıtı temsildir; gerçek ziyaretçi yorumu değildir. Etkileşimler kaydedilmez. Gerçek görüşünüzü aşağıdaki formdan paylaşabilirsiniz.
“SQL ile mükerrer olayları önlemek: idempotency, yarış koşulları ve güvenli yeniden deneme” başlıklı makalede özellikle şu noktayı düşündüm: uzun vadeli bakım maliyetinin değişip değişmediğini öğrenmek isterim.
Editörün notu: Katılıyorum; veri güvenliği ve hata senaryoları, ürün duyurusundan farklı kanıtlar gerektirir. Kaynak güncellenirse incelemeyi de yenilemek gerekir.
Açıklanan özellikler kadar güvenlik ve veri gizliliği de önemli. Yetki ve hata durumları netleşmeden sonuç çıkarmamak gerekir.
Ekip içinde karar verirken yalnız tanıtımı değil, bağımsız karşılaştırmaları da görmek isterim.
✎ Yorum yaz