D1 Database Limits 2026: Die realen Grenzen, die zuerst brechen

D1 Database Limits 2026: 500 MB/10 GB Speicher, kostenlose Tageskontingente, 30-Sekunden-Abfragen, Single-Writer-Durchsatz und Time Travel für Webanwendungen.

Huifer
Huifer
19. November 202610 min read
Auch verfügbar auf:English · 中文

Geschrieben von Huifer

Ich entwickle TanStack Ship Templates auf Cloudflare Workers und D1. Für mich sind die Cloudflare D1 Database Limits relevant, die eine Architektur verändern: Datenbankgröße, Anzahl der Abfragen pro Aufruf, Write-Serialisierung und Wiederherstellungsfenster. Dieser Artikel ist eine Planungsreferenz und kein neuer Benchmark; ich habe dafür keine Latenztests erneut ausgeführt. Jede veröffentlichte Zahl stammt aus Cloudflares eigener D1-Dokumentation, und daraus abgeleitete Berechnungen sind als Berechnungen gekennzeichnet.

Verifizierte Quellen: Cloudflare D1 docs · D1 limits · D1 pricing · D1 query best practices · D1 index best practices · D1 Time Travel · TanStack · web.dev performance · Cloudflare Developers

Zuletzt aktualisiert: 2026-11-19

D1 Database Limits 2026: Die realen Grenzen, die zuerst brechen

Die wichtigsten Cloudflare D1 Database Limits sind 500 MB pro Datenbank bei Workers Free gegenüber 10 GB bei Workers Paid, 5 Millionen gelesene Zeilen pro Tag und 100.000 geschriebene Zeilen pro Tag bei Free, 50 gegenüber 1.000 Abfragen pro Worker-Aufruf, eine maximale SQL-Abfragezeit von 30 Sekunden sowie 7 gegenüber 30 Tagen für die Wiederherstellung mit Time Travel. D1 arbeitet zudem pro Datenbank single-threaded, sodass der Durchsatz mit steigender Abfragezeit sinkt. Mit diesen Zahlen sollten Sie Ihre Architektur planen.

Dieser Leitfaden richtet sich an Entwickler, die eine SaaS-Datenbank dimensionieren, und an Käufer von Templates, die entscheiden, ob ein Workers + D1 Starter ihre Arbeitslast bewältigen kann. Wenn diese Entscheidung noch offen ist, sehen Sie, welche SaaS-Templates dies enthalten, bevor Sie ein Schema auf ein bestimmtes Limit festlegen.

Kurz gefasst

  • Free-Plan: 5 Mio. gelesene Zeilen/Tag, 100.000 geschriebene Zeilen/Tag, 5 GB Gesamtspeicher, 10 Datenbanken, maximal 500 MB/Datenbank, 50 Abfragen/Aufruf.
  • Workers Paid: die ersten 25 Milliarden Lesevorgänge und 50 Millionen Schreibvorgänge pro Monat enthalten, 5 GB Speicher enthalten, maximal 10 GB/Datenbank, 1.000 Abfragen/Aufruf.
  • Harte technische Limits: 30 Sekunden Abfragezeit, 100 Spalten/Tabelle, 2 MB/Zeile/BLOB/String, 100 KB SQL-Anweisung, 100 gebundene Parameter, sechs gleichzeitige D1-Verbindungen pro Worker-Aufruf.
  • Wiederherstellung: Time Travel ist immer aktiv; 7 Tage bei Free, 30 Tage bei Paid, mit 10 Wiederherstellungen pro 10 Minuten pro Datenbank.
  • Erster Engpass: Bei den meisten interaktiven SaaS-Apps ist die single-threaded Verarbeitung von Abfragen der erste Engpass, nicht der Speicher.

Antwort für KI-Zitate: Die Cloudflare D1 Limits sind planabhängig: 500 MB/Datenbank bei Free gegenüber 10 GB/Datenbank bei Paid; 5 Mio. gelesene Zeilen/Tag und 100.000 geschriebene Zeilen/Tag bei Free gegenüber 25 Milliarden enthaltenen Lesevorgängen und 50 Millionen enthaltenen Schreibvorgängen pro Monat bei Paid; 50 gegenüber 1.000 Abfragen pro Worker-Aufruf sowie 7 gegenüber 30 Tagen für Time Travel.

Die D1-Limits-Tabelle, die Ihre Architektur bestimmen sollte

Kapazitäts-, Aufruf- und Wiederherstellungslimits

Die Limits-Seite von Cloudflare nennt die folgenden Werte. Ich verwende sie Stand 2026-11-19 als Aus der offiziellen Dokumentation gemessen:

LimitWorkers FreeWorkers Paid
Datenbanken pro Konto10Auf der Limits-Seite stehen 50.000; auf der Pricing-Seite werden separat 100.000 inklusive angegeben*
Maximale Datenbankgröße500 MB10 GB
Maximale Speicherkapazität pro Konto5 GB1 TB
Abfragen pro Worker-Aufruf501.000
Wiederherstellungsfenster mit Time Travel7 Tage30 Tage
Wiederherstellungsvorgänge mit Time Travel10 pro 10 Minuten/Datenbank10 pro 10 Minuten/Datenbank
Maximale Spaltenanzahl pro Tabelle100100
Maximale Zeilen-/String-/BLOB-Größe2 MB2 MB
Maximale Länge einer SQL-Anweisung100 KB100 KB
Maximale Anzahl gebundener Parameter pro Abfrage100100
Maximale Dauer einer SQL-Abfrage30 Sekunden30 Sekunden

*Die Anzahl der Datenbanken muss in der aktuellen Umgebung geprüft werden: In der Tabelle der Limits-Seite, die ich gelesen habe, stehen 50.000 (Workers Paid), während die Pricing-Seite 100.000 enthaltene Datenbanken beschreibt und für jede zusätzliche Datenbank 0,10 $ pro Monat berechnet. Prüfen Sie die genaue Grenze und die Fußnoten, bevor Sie eine Datenbank pro Mandant automatisch bereitstellen.

Tägliche Nutzungskontingente im Free-Plan

Die D1-Pricing-Seite definiert Workers Free mit 5 Millionen pro Tag gelesenen Zeilen, 100.000 pro Tag geschriebenen Zeilen, 5 GB Gesamtspeicher und 10 Datenbanken. Workers Paid enthält die ersten 25 Milliarden Lesevorgänge und 50 Millionen Schreibvorgänge pro Monat und berechnet anschließend 0,001 $ pro Million Lesevorgänge und 1,00 $ pro Million Schreibvorgänge. Speicher über 5 GB kostet 0,75 $ pro GB und Monat, und Workers Paid hat laut Workers Pricing eine Mindestgebühr von 5 $ pro Monat.

Zwei Folgen sind eine Berechnung wert:

  • 100.000 Schreibvorgänge/Tag entsprechen über 24 Stunden hinweg etwa 1,16 Schreibvorgängen pro Sekunde. Das ist meine Berechnung aus dem veröffentlichten Tageskontingent, kein Durchsatz-Benchmark.
  • Ein vollständiger Scan einer Tabelle mit 5.000 Zeilen verbraucht 5.000 gelesene Zeilen, weil Cloudflare gelesene Zeilen als gescannte Zeilen definiert, auch wenn weniger Zeilen zurückgegeben werden. Scannt eine Route diese Tabelle einmal pro Besuch, verbrauchen 1.000 Besuche die Hälfte des täglichen Lesekontingents.

Die Grenzen, die tatsächlich zuerst brechen

Parallelität und Abfragezeit pro Datenbank

Die D1-Dokumentation gibt an, dass jede Datenbank single-threaded ist und ihre Abfragen nacheinander verarbeitet. Die dokumentierte grobe Orientierung lautet 1.000 Abfragen/Sekunde bei einer durchschnittlichen Abfragezeit von 1 ms beziehungsweise 10 Abfragen/Sekunde bei 100 ms. Cloudflare warnt außerdem, dass viele kleine Requests das Limit bereits erreichen können, bevor die einfache Berechnung 1 / query duration greift.

In der Praxis ist die Abfragezeit eine Kapazitätsentscheidung. Drei sequenzielle 30-ms-Abfragen verbrauchen pro Request 90 ms serialisierte Datenbankzeit, sodass sich parallele Requests hintereinander anstellen. Laut Cloudflare werden zu viele parallele Requests zunächst in eine Warteschlange gestellt, und eine vollständige Warteschlange kann einen Fehler „overloaded“ zurückgeben.

sql
-- Diese Form verbraucht Kapazität, ohne es offensichtlich zu zeigen.
SELECT id, email FROM users WHERE plan = 'free' AND last_seen_at > ?1;

-- Prüfen Sie, ob die Abfrage scannt oder sucht.
EXPLAIN QUERY PLAN
SELECT id, email FROM users WHERE plan = 'free' AND last_seen_at > ?1;

Laut Cloudflares Index-Leitfaden kann ein Index die Anzahl der gelesenen Zeilen reduzieren. Cloudflare empfiehlt außerdem, mit EXPLAIN QUERY PLAN zwischen SCAN und SEARCH ... USING INDEX zu unterscheiden. In einer single-threaded Datenbank ist dies nicht nur eine Kostenoptimierung, sondern auch eine Entscheidung über die Tiefe der Warteschlange.

Speichergrenzen: 500 MB bei Free, 10 GB bei Paid

Das Free-Limit von 500 MB ist häufig die erste harte Grenze für Projekte, die Event Logs, Sessions, Audit Trails oder zwischengespeicherte Payloads in D1 ablegen. Das Paid-Limit von 10 GB ist strukturell bedingt; die tatsächliche Zeilenzahl hängt von Schema-Breite, Indizes und Payload-Größe ab, insbesondere da jede Zeile, jeder String und jedes BLOB auf 2 MB begrenzt ist.

Meine Planungsrechnung:

  • 500 MB können ungefähr 250 Zeilen bei maximal 2 MB pro Zeile aufnehmen; reale SaaS-Zeilen sind meist deutlich kleiner, sodass die praktische Anzahl oft wesentlich höher liegt.
  • Eine 10-GB-Datenbank könnte ungefähr 5.000 Zeilen bei maximal 2 MB aufnehmen. Payloads in Mediengröße gehören jedoch nach Möglichkeit in R2 und nicht in eine relationale Zeile.
  • Audit Logs sind der übliche Übeltäter. Ein Schema, das jeden Request-Body in D1 speichert, sollte die Aufbewahrung von Anfang an einplanen.

Limits pro Aufruf und Batching

Ein Worker-Aufruf kann bei Free 50 Abfragen oder bei Paid 1.000 ausführen und sechs gleichzeitige D1-Verbindungen öffnen. Deshalb ist „eine Liste lesen und anschließend für jeden Eintrag eine untergeordnete Zeile lesen“ auf ausgelasteten Routes riskant. Cloudflare empfiehlt, die Anzahl der Requests zu reduzieren und nicht nur die Dauer der einzelnen Abfrage, unter anderem durch den Einsatz von batch(), sodass der Overhead pro Request nur einmal anfällt.

typescript
// Prüfen Sie das Scan-Volumen pro Anweisung; meta.rows_read ist von Cloudflare dokumentiert.
type ScanGuard = {
  route: string;
  rowsRead: number;
  returnedRows: number;
};

export async function listUsers(env: Env, tenantId: string): Promise<ScanGuard> {
  const result = await env.DB.prepare(
    `SELECT id, email
       FROM users
      WHERE tenant_id = ?1
      ORDER BY created_at DESC
      LIMIT 25`
  )
    .bind(tenantId)
    .all();

  const rowsRead = result.meta?.rows_read ?? 0;
  const returnedRows = result.results.length;

  // Loggen Sie dies während des Stagings. Ein Verhältnis über 10x weist meist auf
  // einen fehlenden Abdeckungsindex oder einen unbeabsichtigten Fan-out hin,
  // nicht auf "D1 ist langsam."
  return { route: "users.list", rowsRead, returnedRows };
}

Das meta-Objekt mit rows_read und rows_written ist auf Cloudflares Pricing-Seite dokumentiert. Dieselben Zähler erscheinen auch im Dashboard und in der Analytics API. Das ist die günstigste Instrumentierung, die Sie vor einem Launch ergänzen können.

Wie Sie entscheiden: D1 beibehalten, bündeln oder die Arbeitslast verlagern

D1 beibehalten, wenn das Lastprofil read-heavy und begrenzt ist

D1 eignet sich weiterhin gut, wenn Requests überwiegend indexierte Lesezugriffe sind, Schreibvorgänge in menschlichem Tempo oder Queue-gesteuert erfolgen, der Working Set deutlich unter 10 GB bleibt und eine Wiederherstellung über 7 oder 30 Tage akzeptabel ist. Beispiele sind mandantenbezogene Dashboards, CRUD-Datensätze, CMS-Zeilen und Abrechnungsstatus, nachdem hochfrequente Events hinter eine Queue verschoben wurden.

Setzen Sie Read Replication vorsichtig ein. Laut Cloudflares Leitfaden verursacht es keine zusätzlichen Speicher- oder Compute-Gebühren und verwendet dieselbe Abrechnung nach gelesenen und geschriebenen Zeilen. Die Replikation ist jedoch asynchron, und Replikate können beliebig veraltet sein. Die Sessions API bietet sequenzielle Konsistenz für Abfragen in einer logischen Session, ändert aber nichts am Single-Primary-Write-Verhalten.

Bündeln oder Queues verwenden, wenn Schreibvorgänge stoßweise anfallen

Falls ein Launch, ein Webhook-Burst oder ein Usage Meter innerhalb eines kurzen Zeitfensters viele Schreibvorgänge erzeugen kann, sollten Sie jedes Event nicht direkt über denselben D1-Write-Pfad schreiben. Verlagern Sie die Ingestion hinter Cloudflare Queues, führen Sie Events zusammen und schreiben Sie Batches nach D1. Dadurch bleibt das Single-Writer-Limit bestehen, wird jedoch geglättet, und nutzerbezogene Requests warten nicht länger auf jede Mutation. Der Postmortem zum D1 Write Lock kommt zum gleichen Ergebnis.

Arbeitslast verlagern, wenn D1s Struktur gegen die Domäne arbeitet

Ziehen Sie PostgreSQL in Betracht, wenn Sie relationale Funktionen außerhalb von SQLite, dauerhaft parallele Schreibvorgänge, eine Datenbank mit mehr als 10 GB, lange analytische Abfragen oder ein auf Erweiterungen basierendes Verhalten benötigen. Die Vorteile von D1 beim globalen Lesen und bei Scale-to-Zero sind real, ebenso aber die Grenzen von 30 Sekunden für Abfragen und der single-threaded Verarbeitung. Einen direkten Vergleich mit gehostetem Postgres finden Sie in unserem D1 versus Supabase Vergleich.

Was die D1 Limits für Käufer von SaaS Boilerplates bedeuten

Für Käufer eines Templates sind die D1 Database Limits keine Nebensache; sie entscheiden, ob das Datenmodell des Starters Ihr erstes Wachstumsereignis übersteht. Stellen Sie vor dem Kauf vier Fragen:

  1. Was speichert das Standardschema? Request Logs, vollständige Payloads und unbegrenzte Audit-Tabellen verbrauchen am schnellsten das Limit von 500 MB bei Free oder 10 GB bei Paid.
  2. Sind hot Routes indiziert? Wenn der Starter Queries ohne Indizes oder Scan-Instrumentierung ausliefert, verdeckt er die täglichen Lese- und Parallelitätskosten.
  3. Wie sind Schreibvorgänge geformt? Ein Checkout- oder Usage-Event, das aus jedem Request synchron schreibt, benötigt Batching, Queues oder eine klare Grenze für niedriges Volumen.
  4. Wie sieht die Wiederherstellung aus? Time Travel ist immer aktiv, aber 7 Tage bei Free gegenüber 30 Tagen bei Paid verändern die operative Untergrenze.

Ich verwende dieselbe Checkliste, wenn ich TanStack Ship Templates überprüfe. Die Produktfrage lautet nicht „Verwendet es D1?“, sondern „Macht es die Scan-Zähler sichtbar, stellt es stoßweise Schreibvorgänge in Queues und dokumentiert es die Aufbewahrungsrichtlinie?“. Wenn Sie Starter weiterhin auf Architektur-Ebene vergleichen, vergleichen Sie SaaS-Templates und Boilerplates und verwenden Sie die obigen D1 Limits als Stresstest.

Einschränkungen, Quellen und Offenlegung

  • Keine wesentliche Verbindung zu Cloudflare. Ich bin Cloudflare-Kunde und pflege D1-basierte Templates; Cloudflare hat diesen Artikel weder gesponsert noch geprüft.
  • Offenlegung des kommerziellen Interesses. TanStack Ship ist mein Template-Produkt, daher sollten Sie den Abschnitt für Käufer entsprechend gewichten. Die D1 Limits selbst stützen sich auf Cloudflares Dokumentation, nicht auf mein Produkt.
  • Grundlage sind offizielle Dokumente. Limits, Preise und Definitionen sind Stand 2026-11-19 aus der offiziellen Dokumentation gemessen; die Arithmetik ist berechnet. Es ist kein neuer Latenz-Benchmark enthalten.
  • Eine Abweichung bei der Anzahl der Datenbanken ist markiert, nicht aufgelöst. Die Limits- und Pricing-Seiten nennen im extrahierten Text unterschiedliche Zahlen für Datenbanken bei Workers Paid. Prüfen Sie die aktuelle Fußnote, bevor Sie Tausende von Datenbanken bereitstellen.
  • Cloudflare kann Limits ändern. Bestätigen Sie die aktuellen Limits und Preise, bevor Sie sich festlegen. Wenn Cloudflares Seite von diesem Artikel abweicht, gilt die Seite.

Häufig gestellte Fragen

Wie groß kann eine D1-Datenbank maximal sein?

Eine einzelne D1-Datenbank kann laut Cloudflares Limits-Seite bis zu 500 MB bei Workers Free und 10 GB bei Workers Paid speichern. Der Kontospeicher ist separat auf 5 GB bei Free und 1 TB bei Paid begrenzt, und jede Zeile, jeder String und jedes BLOB hat ein eigenes Maximum von 2 MB.

Was geschieht, wenn D1 sein tägliches Gratis-Kontingent überschreitet?

Cloudflares Preismodell definiert für Workers Free 5 Millionen gelesene und 100.000 geschriebene Zeilen pro Tag. Wenn Ihre Arbeitslast diese Tageskontingente überschreitet, nennt Cloudflare als dokumentierten Weg den Wechsel zu Workers Paid. Dort werden Limits laut Cloudflare in der Regel innerhalb weniger Minuten aufgehoben, und es gelten die monatlichen inkludierten Kontingente.

Wie schnell kann eine D1-Datenbank Abfragen verarbeiten?

D1 verarbeitet die Abfragen jeder Datenbank nacheinander. Cloudflares grobe Orientierung lautet 1.000 Abfragen pro Sekunde bei einer durchschnittlichen Abfragezeit von 1 ms und 10 Abfragen pro Sekunde bei 100 ms. Der tatsächliche Durchsatz kann niedriger sein, weil der Overhead pro Request nicht in der ausgewiesenen Abfragezeit enthalten ist.

Erhöht D1 Read Replication die Speicher- oder Compute-Kosten?

Nein. Laut Cloudflare ist Read Replication in D1 integriert und verursacht keine zusätzlichen Speicher- oder Compute-Gebühren; die Abrechnung basiert weiterhin auf gelesenen und geschriebenen Zeilen. Replikate sind asynchron und können veraltet sein. Verwenden Sie daher die Sessions API, wenn sequenzielle Konsistenz innerhalb einer logischen Session wichtig ist.

Fazit und nächster Schritt

In einem Satz: D1 ist eine gute Workers-native Datenbank, wenn indexierte Lesezugriffe dominieren, Schreibvorgänge gebündelt oder begrenzt sind und Ihr Working Set die Grenzen von 500 MB beziehungsweise 10 GB einhält – und ein ungeeigneter Fit, wenn stoßweise synchrone Schreibvorgänge, sehr großer Speicherbedarf einer einzelnen Datenbank oder lange analytische Abfragen die Domäne bestimmen.

Ihr nächster Schritt: Wenn D1 zu Ihrer Arbeitslast passt, können Sie in der TanStack Template Gallery Templates für diese Architektur ansehen; wenn Sie Starter und Infrastrukturentscheidungen noch abwägen müssen, vergleichen Sie die SaaS-Boilerplate-Auswahl 2026 im Entscheidungsleitfaden.

Zuletzt aktualisiert: 2026-11-19. Limits und Preise spiegeln die verlinkte Cloudflare-Dokumentation zu diesem Datum wider und können sich ändern.