Michael JohnsonSe sua aplicação busca grandes resultados do Cloudflare D1 em uma única consulta, verifique-a antes de 4 de novembro: a partir dessa data, uma consulta que retorne mais de 50 MB apresentará erro. A mudança diz respeito ao tamanho do resultado, não ao tamanho do banco de dados nem ao volume da solicitação à API; as importações e exportações pela API REST mantêm o comportamento atual.
O que muda exatamente
A Cloudflare anunciou a restrição em 30 de outubro de 2026. A nova regra entra em vigor na quarta-feira, 4 de novembro: se o resultado de uma consulta SQL ultrapassar 50 MB, o D1 retornará o erro D1 query result exceeded the maximum response size limit of 50 MB. A empresa informa que esse limite abrange o percentil 99,999 das consultas no D1, ou seja, a grande maioria delas fica abaixo da restrição. Essa é uma estimativa da Cloudflare para sua plataforma, não uma garantia para cada aplicação.
É importante distinguir o resultado de uma consulta da transferência de dados. A restrição se aplica ao resultado retornado por uma consulta D1; as operações de importação e exportação pela API REST estão explicitamente excluídas da regra. Portanto, verifique sobretudo as consultas da aplicação que leem muitas linhas ou registros extensos e os recebem integralmente.
Por que um resultado grande pode passar despercebido
O tamanho da resposta não depende apenas da quantidade de linhas. Uma consulta com muitas colunas pode retornar um resultado volumoso mesmo com um número moderado de registros, especialmente quando as linhas contêm textos longos ou outros valores grandes. A construção SELECT * inclui todas as colunas, embora o código que faz a chamada talvez precise de apenas algumas. O crescimento da tabela ao longo do tempo também pode levar uma consulta antes segura a ultrapassar o limite.
Na prática, isso significa que convém verificar não só exportações administrativas pontuais, mas também operações recorrentes da aplicação — por exemplo, geradores de relatórios, tarefas em segundo plano e métodos de API que reúnem dados para processamento posterior. Esses são cenários a auditar, não uma afirmação de que todos serão necessariamente afetados.
Como preparar as consultas
No aviso, a Cloudflare recomenda reduzir o conjunto retornado: selecionar as colunas necessárias em vez de usar SELECT * e dividir consultas grandes em páginas com LIMIT e OFFSET. Essa abordagem reduz o tamanho de cada resposta e ajuda a distribuir o processamento por várias consultas.
- Identifique consultas abrangentes. Revise consultas com
SELECT *, sem limite de linhas ou com campos de texto grandes. - Restrinja as colunas selecionadas. Liste apenas as colunas realmente necessárias para a próxima etapa do processamento.
- Divida a leitura em partes. Implemente a paginação com
LIMITeOFFSET, como sugere a Cloudflare, e processe cada parte em sequência. - Verifique o comportamento após a divisão. Confirme que a aplicação combina os resultados corretamente e não depende de receber toda a consulta em uma única resposta.
Se a aplicação precisar do conjunto completo de dados para uma exportação específica, verifique se a operação de exportação pela API REST é adequada para essa tarefa: a Cloudflare informa separadamente que o novo limite não se aplica a ela. Para a lógica habitual da aplicação, essa exceção não dispensa a revisão de respostas SQL grandes.
A quem se aplica o prazo
O prazo diz respeito diretamente aos usuários do D1 cujas consultas retornam mais de 50 MB. Vale verificar primeiro o código que carrega o resultado inteiro na memória, o transmite entre componentes ou o prepara para um relatório. Se as consultas já retornam apenas páginas pequenas e os campos necessários, talvez não seja preciso fazer nenhuma alteração específica; a decisão deve se basear no tamanho real das respostas das suas consultas.
Verificar tudo antes de 4 de novembro ajuda a identificar dependências de uma única resposta grande antes que a restrição entre em vigor. Segundo a estimativa da Cloudflare, o limite fica muito acima do volume habitual da maioria das consultas; para os sistemas afetados, o plano mais direto é reduzir os dados selecionados, lê-los em partes ou usar a opção prevista para exportações pela API REST.
