Michael JohnsonUygulamanız Cloudflare D1’den tek bir sorguyla büyük sonuç kümeleri alıyorsa 4 Kasım’dan önce kontrol edin: bu tarihten itibaren 50 MB’tan fazla veri döndüren sorgular hata verecek. Değişiklik, veritabanının boyutunu veya API isteğinin hacmini değil, sorgu sonucunun boyutunu kapsıyor; REST API üzerinden içe ve dışa aktarma işlemleri ise önceki şekilde çalışmaya devam ediyor.
Ne değişiyor?
Cloudflare, kısıtlamayı 30 Ekim 2026’da duyurdu. Yeni kural 4 Kasım Çarşamba günü yürürlüğe giriyor: SQL sorgusunun sonucu 50 MB’ı aşarsa D1, D1 query result exceeded the maximum response size limit of 50 MB hatasını döndürecek. Şirket, bu eşiğin D1 sorgularının yüzde 99,999’undan daha fazlasını kapsadığını; başka bir deyişle sorguların ezici çoğunluğunun sınırın altında kaldığını belirtiyor. Bu, Cloudflare’ın platformuna ilişkin bir değerlendirmedir; tek bir uygulama için garanti değildir.
Sorgu sonucu ile veri aktarımı arasındaki fark önemli. Sınır, D1 sorgusunun döndürdüğü sonuç için geçerli; REST API üzerinden yapılan içe ve dışa aktarma işlemleri kuralın açıkça dışında tutuluyor. Bu nedenle özellikle çok sayıda satır veya geniş kayıt okuyup bunları bütünüyle alan uygulama sorgularını kontrol etmek gerekiyor.
Büyük bir sonuç fark edilmeden nasıl oluşabilir?
Yanıtın boyutu yalnızca satır sayısına bağlı değildir. Çok sayıda sütun içeren bir sorgu, kayıt sayısı makul olsa bile büyük bir sonuç döndürebilir; özellikle satırlarda uzun metinler veya başka büyük değerler varsa. SELECT * ifadesi, çağıran tarafın yalnızca birkaçına ihtiyacı olsa bile tüm sütunları ekler. Tablonun zamanla büyümesi de önceden güvenli olan bir sorgunun eşiği aşmasına yol açabilir.
Pratikte bunun anlamı, yalnızca tek seferlik yönetim amaçlı veri aktarımlarını değil, uygulamanın düzenli işlemlerini de kontrol etmektir: örneğin rapor işleyicileri, arka plan görevleri ve daha sonra işlemek üzere veri toplayan API yöntemleri. Bunlar denetlenecek senaryolardır; her birinin mutlaka etkileneceği anlamına gelmez.
Sorgular nasıl hazırlanmalı?
Cloudflare duyurusunda döndürülen veri kümesini küçültmeyi öneriyor: SELECT * yerine gerekli sütunları seçin ve büyük sorgu sonuçlarını LIMIT ile OFFSET kullanarak sayfalara bölün. Bu yaklaşım tek bir yanıtın boyutunu azaltır ve işlemenin birden fazla sorguya dağıtılmasına yardımcı olur.
- Geniş sorguları bulun.
SELECT *kullanan, satır sayısını sınırlamayan veya büyük metin alanları içeren sorguları gözden geçirin. - Seçilen sütunları azaltın. Yalnızca işlemenin sonraki aşamasında gerçekten gereken sütunları listeleyin.
- Okumayı parçalara bölün. Cloudflare’ın önerdiği gibi
LIMITveOFFSETile sayfalı veri almayı ekleyin ve parçaları sırayla işleyin. - Bölme sonrasındaki davranışı kontrol edin. Uygulamanın sonuçları doğru biçimde birleştirdiğinden ve tüm veri kümesini tek bir yanıtta alacağı varsayımına dayanmadığından emin olun.
Uygulamanızın ayrı bir dışa aktarma için tüm veri kümesine ihtiyacı varsa REST API üzerinden dışa aktarma işleminin bu işe uygun olup olmadığını kontrol edin: Cloudflare, yeni sınırın bu işlem için geçerli olmadığını ayrıca belirtiyor. Ancak bu istisna, uygulamanın olağan işleyişindeki büyük SQL yanıtlarını yeniden düzenleme gereğini ortadan kaldırmaz.
Son tarih kimleri ilgilendiriyor?
Son tarih, doğrudan 50 MB’tan fazla veri döndüren D1 sorgularına sahip kullanıcıları ilgilendiriyor. Sonucun belleğe bütünüyle yüklendiği, bileşenler arasında aktarıldığı veya rapor oluşturmak için kullanıldığı kodları öncelikle kontrol etmekte fayda var. Sorgularınız zaten yalnızca küçük sayfalar ve gerekli alanları döndürüyorsa özel bir değişiklik gerekmeyebilir; kararınızı sorgularınızın gerçek yanıt boyutuna göre verin.
4 Kasım’dan önce yapılacak bir kontrol, sınır yürürlüğe girmeden önce tek bir büyük yanıta bağımlılığı ortaya çıkarabilir. Cloudflare’ın değerlendirmesine göre sorguların çoğu için eşik olağan hacmin oldukça üzerindedir; etkilenen sistemler için en doğrudan plan, seçilen veriyi azaltmak, veriyi parça parça okumak veya dışa aktarma amacıyla REST API üzerinden sunulan yolu kullanmaktır.
