Cloudflare D1 zavede limit velikosti výsledku dotazu: co zkontrolovat do 4. listopadu

Pokud aplikace z Cloudflare D1 načítá velké výsledky najednou, zkontrolujte tyto dotazy do 4. listopadu: od tohoto data bude dotaz vracející více než 50 MB končit chybou. Změna se týká velikosti výsledku, nikoli velikosti databáze nebo objemu požadavku na API; import a export přes REST API budou fungovat jako dosud.

Co přesně se mění

Cloudflare oznámila omezení 30. října 2026. Nové pravidlo začne platit ve středu 4. listopadu: pokud výsledek SQL dotazu přesáhne 50 MB, D1 vrátí chybu D1 query result exceeded the maximum response size limit of 50 MB. Společnost uvádí, že tento limit pokrývá 99,999. percentil dotazů v D1, takže naprostá většina dotazů zůstane pod jeho hranicí. Jde o odhad Cloudflare pro celou její platformu, nikoli o záruku pro jednotlivou aplikaci.

Důležité je rozlišovat mezi výsledkem dotazu a přenosem dat. Omezení se vztahuje na výsledek vrácený dotazem D1; operace importu a exportu přes REST API jsou z něj výslovně vyňaty. Prověřit je tedy třeba především aplikační dotazy, které čtou velké množství řádků nebo široké záznamy a načítají je celé.

Proč může velký výsledek vzniknout nenápadně

Objem odpovědi neurčuje jen počet řádků. Dotaz s mnoha sloupci může vrátit velký výsledek i při mírném počtu záznamů, zejména pokud řádky obsahují dlouhý text nebo jiné objemné hodnoty. Konstrukce SELECT * zahrnuje všechny sloupce, přestože volající část aplikace může potřebovat jen několik z nich. Růst tabulky může navíc časem dostat dříve bezpečný dotaz přes stanovený limit.

Praktický závěr: kontrolujte nejen jednorázové administrativní exporty, ale i pravidelné operace aplikace — například obsluhu sestav, úlohy na pozadí a metody API, které shromažďují data k dalšímu zpracování. Jde o scénáře, které stojí za prověření, nikoli o tvrzení, že se jich omezení nutně týká.

Jak připravit dotazy

V oznámení Cloudflare doporučuje zmenšit vracenou množinu: vybírat potřebné sloupce místo SELECT * a rozdělit velké výběry na stránky pomocí LIMIT a OFFSET. Tím se zmenší objem jedné odpovědi a zpracování lze rozdělit mezi více dotazů.

1. Najděte široké výběry. Projděte dotazy s SELECT *, bez omezení počtu řádků nebo s velkými textovými poli.
2. Omezte výběr sloupců. Uveďte pouze sloupce, které skutečně potřebuje další fáze zpracování.
3. Rozdělte čtení na části. Přidejte stránkování pomocí LIMIT a OFFSET, jak navrhuje Cloudflare, a jednotlivé části zpracovávejte postupně.
4. Ověřte chování po rozdělení. Ujistěte se, že aplikace výsledky správně skládá a nespoléhá na načtení celého výběru v jediné odpovědi.

Pokud aplikace potřebuje celou datovou sadu pro samostatný export, ověřte, zda se k tomu hodí operace exportu přes REST API: Cloudflare výslovně uvádí, že se na ni nový limit nevztahuje. Tato výjimka však nenahrazuje úpravu velkých SQL odpovědí v běžné logice aplikace.

Koho se týká termín

Termín se přímo týká uživatelů D1, jejichž dotazy vracejí více než 50 MB. Nejprve zkontrolujte kód, který načítá celý výsledek do paměti, předává ho mezi komponentami nebo z něj vytváří sestavu. Pokud dotazy už vracejí jen malé stránky a potřebná pole, možná nebude nutná žádná zvláštní úprava; rozhodující je skutečná velikost odpovědí vašich dotazů.

Kontrola před 4. listopadem může odhalit závislost na jediné velké odpovědi ještě před začátkem platnosti omezení. Podle odhadu Cloudflare zůstane limit pro většinu dotazů výrazně nad jejich obvyklým objemem; pro zasažené systémy je nejpřímějším řešením omezit vybíraná data, číst je po částech nebo pro export využít cestu přes REST API.