Cloudflare D1 ve R2 ile veri tutarlılığı: kayıt, görsel ve yayın nasıl birlikte korunur?
Bir kayıt D1'e yazılırken kapak görseli R2'ye yüklenmezse ne olur? İki sistem arasında güvenilir aktarım, tekrar deneme ve yayın bütünlüğü tasarımı.
Sorun iki sistem arasında başlar
Bir içerik sisteminde metin ve ilişkili alanlar D1'de, fotoğraflar R2'de tutulduğunda işlemin tek veri tabanı yazması gibi davranacağını varsaymak hatadır. D1 üzerinde bir transaction başarıyla tamamlanırken R2 yüklemesi ağ hatası verebilir. Tersi de mümkündür: görsel yüklenir, ancak veri tabanındaki yayın kaydı oluşturulamaz. Böylece ziyaretçi kırık görsel, eksik kapak veya hiç görünmeyen dosyalarla karşılaşır. İlk karar, bir görselin fiziksel olarak var olması ile yayına uygun olmasının farklı durumlar olduğunu kabul etmektir. Görsel nesnesi yüklenmeden önce yayın kartının ona referans vermesine izin vermemek, bu hataların çoğunu engeller. İçerik yaşam döngüsünde taslak, medya hazır, doğrulandı ve yayında gibi açık durumlar tanımlandığında sorun yalnızca ekranda değil arka plan işlerinde de izlenebilir.
Güvenli kayıt sırası ve doğrulama
İçeriğin kimliğini önceden oluşturmak ve aktarım adımlarını o kimlikle ilişkilendirmek işinizi kolaylaştırır. Önce D1'e taslak kaydı koyun; R2 nesnesini içerik kimliğinden ve dosya özetinden türetilmiş bir anahtarla yükleyin. R2 yazması başarılı olduğunda yalnızca cevap koduna güvenmeyin: MIME türünü, dosya boyutunu ve gerektiğinde HEAD isteğini kontrol edin. Ardından D1 içinde medya ilişkilendirmesini ve doğrulama sonucunu kaydedin. Son olarak yayın alanını etkinleştirin. Arada hata çıkarsa sistemin tamamını sıfırlamak yerine hangi adımın kaldığını kayıt üzerinden belirleyin. Göz önüne alınması gereken incelik, veritabanı güncellemesi ile nesne deposu yazmasının tek atomik işlem olmamasıdır; bu nedenle idempotent tekrar deneme ve telafi adımları açıkça tasarlanmalıdır.
Tekrar denemeler mükerrerlik oluşturmamalı
Ağ istemcisinin zaman aşımı yaşaması işlemin gerçekleşmediğini kanıtlamaz. R2 nesnesi depoya yazılmış, yanıtın istemciye ulaşması engellenmiş olabilir. Bu yüzden her denemede yeni dosya adı üretmek yerine içerik hash'ini veya kararlı nesne anahtarını kullanın. D1 tarafında içerik kimliği ve dosya anahtarı için tekillik koşulları koyun. Tekrar istek geldiğinde güncelleme yapmadan önce mevcut eşleşmeyi kontrol etmek gereksiz depolamayı azaltır. Çoklu Worker süreçleri aynı içeriği aynı anda işlerse yarış durumları ortaya çıkar; yalnız uygulama düzeyi 'önce bak, sonra yaz' adımı yeterli değildir. Benzersiz indeksler ve işlem sınırları bu yüzden önem taşır. Hata kaydına durum, kaynak ve sonraki tekrar zamanı yazın; sonsuz ve sık tekrarların hem gecikme hem kota maliyeti ürettiğini unutmayın.
Yayın ve önbellek tutarlılığı
Yönetim panelinde kayıt güncellenince canlı sayfada hemen değişmesini istemek anlaşılırdır. Fakat istemci, Worker ve kenar önbelleği farklı zamanlarda veri gösterebilir. Veri yazma başarısını, önbellek temizleme başarısını ve ziyaretçinin son sürümü görmesini ayrı doğrulayın. ETag veya sürümlü URL kullanmak özellikle görseller için etkilidir; aynı nesne anahtarına sık sık farklı resim yazmak eski görselin uzun süre görünmesine yol açabilir. Yeni kapak için sürümlü nesne anahtarı oluşturup kartı yeni anahtara yönlendirmek genellikle daha öngörülebilirdir. D1 yazma öncesinde eski yayını silmek yerine güvenli geçiş yapmak, ziyaretçiyi geçici boşluğa düşürmez. Düşük trafik alan sayfalarda bile önbellek süresi ile doğrulama gecikmesini raporlayın.
Denetim listesi ve geri dönüş
Sistemi teste alırken yalnız başarılı aktarımı çalıştırmayın. Dosya yüklemesini kasıtlı durdurun, D1 yazmasını başarısız kılın, aynı isteği üç kez gönderin ve iki eşzamanlı istemci başlatın. Son durumda her içerik kimliği için beklenen tekil dosya eşleşmesini sorgulayın; R2'de referanssız nesneleri raporlayın ama hemen kalıcı silmeyin. Yayına çıkış için D1 kaydının görünürlüğü, R2 dosyasının erişilebilirliği, görsel türü ve canlı sayfanın doğru sürümü göstermesi birlikte doğrulanmalıdır. Geri dönüş planı, yalnız Worker'ın eski sürümüne dönmeyi değil, son veritabanı yazmaları ve medya eşleşmelerinin nasıl korunacağını da açıklamalıdır. Bu yaklaşımın maliyeti birkaç ek sorgu ve küçük bir durum makinesidir; kazancı, kullanıcıların gördüğü bozuk kayıtların azalması ve hata araştırmasının hızlanmasıdır.
Somut örnek: bir kapak değiştirildiğinde
Bir tesis veya makale kartının kapak görselinin değiştiğini düşünelim. Yönetici yeni dosyayı seçtiğinde eski görseli hemen silmek yerine değişiklik için ayrı bir işlem kimliği oluşturabilir. İş önce yeni görseli R2'ye yükler, geçerli bir WebP olduğunu kontrol eder, ardından D1'deki kapak anahtarını yeni nesnenin anahtarıyla değiştirir. Eski kapak bir süre daha korunabilir; böylece gecikmiş istemciler eski URL'yi istediklerinde boş yanıt almaz. Daha sonra gerçekten hiçbir kart tarafından kullanılmayan nesneler raporlanır. Kalıcı temizlik ayrı, denetlenebilir bir görev olur. Bu akışta bir bağlantı kopması yaşanırsa sistem hangi kapak sürümünün canlı olduğunu ve henüz yayına alınmamış hangi dosyanın beklediğini bilebilir. Hatanın tek tıkla yeniden denenebilir olması, kullanıcıdan tüm işlemi sıfırdan yapmasını istemekten daha güvenilirdir.
Maliyet ve kapasite kararı
Tüm görselleri her gün yeniden indirip D1 kayıtlarını baştan yazmak kolay bir çözüm gibi görünse de genellikle gereksiz R2 işlemleri ve veri tabanı sorguları üretir. Bunun yerine değişen alanları hash, ETag veya son güncelleme bilgisiyle tespit edip yalnız gerekli bölümü yenileyin. Medyanın türü ve çözünürlüğüyle birlikte saklanan özet, aynı dosyanın farklı isimlerle tekrar yüklenmesini de azaltabilir. D1 sorgu sayısı kadar R2 okuma-yazma işlemi, aktarım trafiği ve Worker CPU süresi de ölçülmelidir. Performans raporunda tekil başarılı içerik sayısı, hata oranı ve doğrulanan kapak sayısı ayrı tutulmalıdır. Yalnız çalıştırılan görev sayısının yüksek olması değer üretildiği anlamına gelmez. Bir otomasyon daha az işlem yapıp daha çok doğru kayıt oluşturabiliyorsa hem maliyet hem güvenilirlik açısından daha iyi çalışıyor olabilir.
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.
“Cloudflare D1 ve R2 ile veri tutarlılığı: kayıt, görsel ve yayın nasıl birlikte korunur?” başlıklı makalede özellikle şu noktayı düşündüm: mevcut kodla uyumluluk ve hata ayıklama süreçlerine etkisini merak ettim.
Editörün notu: Bu noktada faydayı ilan edilen özelliklerden ayrı değerlendirmek gerekir. Önce küçük bir kullanım senaryosu ve ölçüm yöntemi tanımlamak yerinde olur.
Bence maliyet ve bakım yükü ayrıca tartışılmalı. İlk kurulumun kolay olması, sonraki sürümlerin de sorunsuz çalışacağı anlamına gelmiyor.
Bunu küçük ölçekte denemek isterdim. Ölçülebilir bir başarı kriteri belirlemeden uygulamaya geçmek riskli.
✎ Yorum yaz