Cloudflare D1 с 4 ноября ограничит размер результата запроса 50 МБ

Cloudflare D1 с 4 ноября ограничит размер результата запроса 50 МБ
Содержание статьи

30 октября Cloudflare объявила новый предел для D1: с 4 ноября 2026 года размер результата одного запроса не должен превышать 50 МБ. Более крупный результат будет завершаться ошибкой. На Mentoring.digital разбираем, какие выборки стоит проверить до вступления ограничения в силу.

Лимит относится к результату, а не ко всей базе

Объявленное правило ограничивает объём данных, который возвращает запрос. Его нельзя читать как новый максимальный размер базы или как суточную квоту чтения. Большая база с небольшими выборками и маленькая база с широким ответом представляют разные ситуации.

Для превышения указан текст ошибки: D1 query result exceeded the maximum response size limit of 50 MB. Приложению полезно отличать такой ответ от отсутствия строк и от временной сетевой ошибки. Повторение той же слишком большой выборки без изменения запроса не уменьшает её результат.

Импорт и экспорт через REST API остаются исключением

Cloudflare отдельно сообщает, что операции импорта и экспорта через REST API не подпадают под этот предел. Исключение относится именно к указанным операциям. Из него не следует, что любая самописная выгрузка, построенная на обычном SQL-запросе, также освобождена от ограничения.

Проверьте, каким способом устроены ваши отчёты и резервные выгрузки. Если приложение запрашивает все строки и само собирает файл, оно всё ещё зависит от размера результата запроса. Не подменяйте эту проверку одним лишь названием функции «экспорт» в интерфейсе.

Как подготовить большие выборки

Поставщик рекомендует выбирать необходимые столбцы вместо SELECT * и разбивать большие результаты на страницы с LIMIT и OFFSET. Для воспроизводимого порядка страниц задавайте сортировку. При изменяющихся данных отдельно учитывайте согласованность последовательных выборок.

Число строк само по себе не гарантирует небольшой ответ: длинные текстовые поля тоже занимают место. В тестовой среде проверьте реальные крупные записи, обработку ошибки и сборку итогового результата из нескольких частей. Сохраните порядок и полноту данных при переходе на страницы.

Разобрать запросы, обработку ошибок API и ограничения выгрузки можно с наставником по backend-разработке. Начать стоит с тех операций, которые сейчас возвращают больше всего данных, а не с переписывания всех запросов подряд.

Похожие статьи по данной теме