Michael JohnsonЯкщо застосунок вивантажує великі результати з Cloudflare D1 одним запитом, перевірте його до 4 листопада: із цієї дати запит, що повертає понад 50 МБ, завершуватиметься помилкою. Зміна стосується розміру результату, а не розміру бази даних чи обсягу запиту до API; імпорт та експорт через REST API працюватимуть як і раніше.
Що саме змінюється
Cloudflare оголосила про обмеження 30 жовтня 2026 року. Нове правило набуде чинності в середу, 4 листопада: якщо результат SQL-запиту перевищує 50 МБ, D1 поверне помилку D1 query result exceeded the maximum response size limit of 50 MB. Компанія зазначає, що цей поріг охоплює 99,999-й перцентиль запитів у D1, тобто переважна більшість запитів залишається нижче обмеження. Це оцінка Cloudflare для її платформи, а не гарантія для окремого застосунку.
Важливо розрізняти результат запиту та передавання даних. Обмеження стосується результату, який повертає запит D1; операції імпорту й експорту через REST API прямо виключені з цього правила. Тож насамперед перевірте запити застосунку, які читають багато рядків або широкі записи, а потім отримують їх цілком.
Чому великий результат може з’явитися непомітно
Обсяг відповіді залежить не лише від кількості рядків. Запит із багатьма стовпцями може повертати великий результат навіть за помірної кількості записів, особливо якщо рядки містять довгий текст або інші об’ємні значення. Конструкція SELECT * додає всі стовпці, хоча стороні, що викликає запит, можуть бути потрібні лише кілька. З часом таблиця також може зрости настільки, що раніше безпечний запит перевищить поріг.
Практичний висновок: перевіряйте не лише разові адміністративні вивантаження, а й регулярні операції застосунку — наприклад, обробники звітів, фонові завдання та методи API, які збирають дані для подальшої обробки. Це сценарії для аудиту, а не твердження, що кожен із них обов’язково постраждає.
Як підготувати запити
У повідомленні Cloudflare рекомендує скоротити набір даних у відповіді: вибирати потрібні стовпці замість SELECT * і розбивати великі вибірки на сторінки за допомогою LIMIT та OFFSET. Такий підхід зменшує обсяг однієї відповіді й допомагає розподілити обробку між кількома запитами.
- Знайдіть широкі вибірки. Перегляньте запити з
SELECT *, без обмеження кількості рядків або з великими текстовими полями. - Звузьте перелік стовпців. Укажіть лише ті стовпці, які справді потрібні на наступному етапі обробки.
- Розбийте читання на частини. Додайте посторінкове отримання даних за допомогою
LIMITтаOFFSET, як пропонує Cloudflare, і обробляйте частини послідовно. - Перевірте роботу після поділу. Переконайтеся, що застосунок правильно об’єднує результати й не розраховує отримати всю вибірку однією відповіддю.
Якщо застосунку потрібен повний набір даних для окремого вивантаження, перевірте, чи підходить для цього операція експорту через REST API: Cloudflare окремо повідомляє, що нове обмеження на неї не поширюється. Для звичайної логіки застосунку цей виняток не замінює перегляду великих відповідей SQL-запитів.
Кого стосується термін
Безпосередньо дедлайн стосується користувачів D1, чиї запити повертають понад 50 МБ. Насамперед варто перевірити код, у якому результат повністю завантажується в пам’ять, передається між компонентами або формується для звіту. Якщо запити вже повертають лише невеликі сторінки та потрібні поля, спеціальні зміни можуть не знадобитися; орієнтуйтеся на фактичний розмір відповідей ваших запитів.
Перевірка до 4 листопада допоможе виявити залежність від однієї великої відповіді до набуття обмеження чинності. За оцінкою Cloudflare, для більшості запитів поріг залишається далеко за межами звичайного обсягу; для систем, яких це стосується, найпряміший план — скоротити набір даних, читати його частинами або скористатися передбаченим для вивантажень шляхом через REST API.
