Cloudflare D1 limitará los resultados de las consultas: qué revisar antes del 4 de noviembre

Si tu aplicación obtiene grandes resultados de Cloudflare D1 con una sola consulta, revísala antes del 4 de noviembre: a partir de esa fecha, las consultas que devuelvan más de 50 MB producirán un error. El cambio afecta al tamaño del resultado, no al de la base de datos ni al volumen de la solicitud a la API; las importaciones y exportaciones mediante la API REST mantienen su comportamiento actual.

Qué cambia exactamente

Cloudflare anunció el límite el 30 de octubre de 2026. La nueva regla entra en vigor el miércoles 4 de noviembre: si el resultado de una consulta SQL supera los 50 MB, D1 devolverá el error D1 query result exceeded the maximum response size limit of 50 MB. La empresa indica que este umbral cubre el percentil 99,999 de las consultas en D1, por lo que la gran mayoría queda por debajo del límite. Se trata de una estimación de Cloudflare basada en su plataforma, no de una garantía para cada aplicación.

Es importante distinguir entre el resultado de una consulta y la transferencia de datos. El límite se aplica al resultado que devuelve una consulta de D1; las operaciones de importación y exportación mediante la API REST están expresamente excluidas. Por tanto, conviene revisar sobre todo las consultas de la aplicación que leen muchas filas o registros con muchos campos y luego los obtienen íntegramente.

Por qué puede pasar desapercibido un resultado grande

El tamaño de la respuesta no depende solo del número de filas. Una consulta con muchas columnas puede generar un resultado voluminoso incluso con una cantidad moderada de registros, sobre todo si las filas contienen textos largos u otros valores pesados. La instrucción SELECT * incluye todas las columnas, aunque quien llama a la consulta solo necesite unas pocas. Además, el crecimiento de una tabla puede hacer que una consulta antes segura supere el umbral con el tiempo.

La consecuencia práctica es que conviene revisar no solo las exportaciones administrativas puntuales, sino también las operaciones habituales de la aplicación: por ejemplo, los controladores de informes, las tareas en segundo plano y los métodos de API que recopilan datos para procesarlos después. Son casos que merece la pena auditar, no una afirmación de que todos vayan a verse afectados.

Cómo preparar las consultas

En su aviso, Cloudflare recomienda reducir el conjunto devuelto: seleccionar las columnas necesarias en lugar de usar SELECT * y dividir las consultas grandes en páginas con LIMIT y OFFSET. Así se reduce el tamaño de cada respuesta y se distribuye el procesamiento entre varias consultas.

1. Localiza las consultas amplias. Revisa las consultas con SELECT *, sin límite de filas o con campos de texto grandes.
2. Reduce las columnas seleccionadas. Enumera solo las columnas que realmente necesita la siguiente etapa del procesamiento.
3. Divide la lectura en lotes. Añade paginación mediante LIMIT y OFFSET, como propone Cloudflare, y procesa los lotes secuencialmente.
4. Comprueba el comportamiento tras dividirlas. Asegúrate de que la aplicación combina correctamente los resultados y no depende de recibir toda la consulta en una sola respuesta.

Si la aplicación necesita el conjunto completo de datos para una exportación independiente, comprueba si la operación de exportación mediante la API REST es adecuada: Cloudflare indica por separado que el nuevo límite no se aplica a esa operación. Para la lógica habitual de la aplicación, esta excepción no sustituye la revisión de las respuestas SQL grandes.

A quién afecta el plazo

El plazo afecta directamente a los usuarios de D1 cuyas consultas devuelven más de 50 MB. Conviene revisar primero el código que carga el resultado completo en memoria, lo pasa entre componentes o lo genera para un informe. Si las consultas ya devuelven páginas pequeñas y solo los campos necesarios, quizá no haga falta ningún cambio específico; la decisión debe basarse en el tamaño real de las respuestas de tus consultas.

Revisarlas antes del 4 de noviembre ayuda a detectar la dependencia de una única respuesta grande antes de que entre en vigor el límite. Según la estimación de Cloudflare, el umbral queda muy por encima del volumen habitual de la mayoría de las consultas; para los sistemas afectados, el plan más directo es reducir los datos seleccionados, leerlos por lotes o recurrir a la vía prevista para exportaciones mediante la API REST.