Cloudflare D1 führt Ergebnislimit für Abfragen ein: Was Sie bis zum 4. November prüfen sollten

Wenn Ihre Anwendung große Ergebnisse mit einer einzigen Abfrage aus Cloudflare D1 abruft, sollten Sie diese bis zum 4. November prüfen: Ab diesem Datum schlägt jede Abfrage fehl, die mehr als 50 MB zurückgibt. Die Änderung betrifft die Größe des Ergebnisses, nicht die Größe der Datenbank oder den Umfang der API-Anfrage; Importe und Exporte über die REST API verhalten sich weiterhin wie bisher.

Was sich genau ändert

Cloudflare hat die Begrenzung am 30. Oktober 2026 angekündigt. Die neue Regel tritt am Mittwoch, dem 4. November, in Kraft: Überschreitet das Ergebnis einer SQL-Abfrage 50 MB, gibt D1 den Fehler D1 query result exceeded the maximum response size limit of 50 MB zurück. Das Unternehmen gibt an, dass dieser Schwellenwert das 99,999. Perzentil der D1-Abfragen abdeckt – die große Mehrheit der Abfragen bleibt also unter der Grenze. Dies ist eine Einschätzung von Cloudflare auf Grundlage seiner Plattform und keine Garantie für eine einzelne Anwendung.

Wichtig ist die Unterscheidung zwischen Abfrageergebnis und Datenübertragung. Die Begrenzung gilt für das Ergebnis einer D1-Abfrage; Import- und Exportvorgänge über die REST API sind ausdrücklich von der Regel ausgenommen. Prüfen sollten Sie daher vor allem Anwendungsabfragen, die viele Zeilen oder umfangreiche Datensätze lesen und vollständig abrufen.

Warum große Ergebnisse unbemerkt entstehen können

Das Antwortvolumen hängt nicht nur von der Anzahl der Zeilen ab. Eine Abfrage mit vielen Spalten kann auch bei einer moderaten Zahl von Datensätzen ein großes Ergebnis liefern – insbesondere, wenn die Zeilen lange Texte oder andere umfangreiche Werte enthalten. Die Anweisung SELECT * gibt alle Spalten zurück, obwohl die aufrufende Stelle möglicherweise nur einige davon benötigt. Auch das Wachstum einer Tabelle kann dazu führen, dass eine zuvor unkritische Abfrage den Schwellenwert überschreitet.

Daraus folgt für die Praxis: Prüfen Sie nicht nur einmalige administrative Exporte, sondern auch regelmäßig ausgeführte Anwendungsvorgänge – etwa Berichtshandler, Hintergrundaufgaben und API-Methoden, die Daten zur weiteren Verarbeitung zusammenstellen. Das sind mögliche Prüffälle, keine Behauptung, dass jeder davon zwangsläufig betroffen ist.

So bereiten Sie Ihre Abfragen vor

In ihrer Mitteilung empfiehlt Cloudflare, den zurückgegebenen Datensatz zu verkleinern: Wählen Sie statt SELECT * nur die benötigten Spalten aus und teilen Sie große Abfragen mit LIMIT und OFFSET in Seiten auf. So wird jede einzelne Antwort kleiner und die Verarbeitung kann auf mehrere Abfragen verteilt werden.

1. Finden Sie breite Abfragen. Suchen Sie nach Abfragen mit SELECT *, ohne Begrenzung der Zeilenzahl oder mit großen Textfeldern.
2. Schränken Sie die Spaltenauswahl ein. Führen Sie nur die Spalten auf, die der nächste Verarbeitungsschritt tatsächlich benötigt.
3. Teilen Sie Lesevorgänge in Abschnitte auf. Fügen Sie, wie von Cloudflare vorgeschlagen, eine seitenweise Abfrage mit LIMIT und OFFSET hinzu und verarbeiten Sie die Abschnitte nacheinander.
4. Prüfen Sie das Verhalten nach der Aufteilung. Stellen Sie sicher, dass die Anwendung die Ergebnisse korrekt zusammenführt und nicht voraussetzt, die gesamte Abfrage mit einer einzigen Antwort zu erhalten.

Benötigt Ihre Anwendung für einen separaten Export den vollständigen Datensatz, prüfen Sie, ob sich dafür der Exportvorgang über die REST API eignet: Cloudflare teilt ausdrücklich mit, dass das neue Limit dafür nicht gilt. Für die gewöhnliche Anwendungslogik ersetzt diese Ausnahme nicht die Überarbeitung großer SQL-Antworten.

Für wen die Frist gilt

Die Frist betrifft unmittelbar D1-Nutzer, deren Abfragen mehr als 50 MB zurückgeben. Prüfen sollten Sie insbesondere Code, der Ergebnisse vollständig in den Arbeitsspeicher lädt, zwischen Komponenten überträgt oder für Berichte zusammenstellt. Geben Abfragen bereits nur kleine Seiten und die erforderlichen Felder zurück, sind möglicherweise keine besonderen Änderungen nötig; entscheidend ist die tatsächliche Antwortgröße Ihrer Abfragen.

Eine Prüfung vor dem 4. November hilft, eine Abhängigkeit von einer einzigen großen Antwort aufzudecken, bevor die Begrenzung in Kraft tritt. Nach Einschätzung von Cloudflare liegt der Schwellenwert für die meisten Abfragen weit über dem üblichen Umfang. Für betroffene Systeme ist der direkteste Plan, die ausgewählten Daten zu reduzieren, sie in Abschnitten abzurufen oder für Exporte den dafür vorgesehenen Weg über die REST API zu nutzen.