TL;DR — Kurzzusammenfassung
Cloudflare Workers KV bietet global verteilten Key-Value-Speicher für Edge-Anwendungen. Lernen Sie Einrichtung, CRUD-Operationen und Caching-Muster.
Cloudflare Workers KV ist ein global verteilter Key-Value-Datenspeicher, der auf dem Edge-Netzwerk von Cloudflare in über 300 Städten läuft. Diese Anleitung behandelt Einrichtung, CRUD-Operationen und Produktionsmuster.
Voraussetzungen
- Ein Cloudflare-Konto (kostenloses Kontingent funktioniert)
- Node.js 18+ installiert
- Wrangler CLI (
npm install -g wrangler)
Workers KV einrichten
Erstellen Sie einen KV-Namespace, fügen Sie ihn zu wrangler.toml hinzu und verwenden Sie CRUD-Operationen mit env.SITE_CONFIG.put(), .get(), .list() und .delete().
Vergleich
| Feature | Workers KV | D1 (SQLite) | Durable Objects | R2 |
|---|---|---|---|---|
| Konsistenz | Eventual | Stark | Stark | Eventual |
| Leselatenz | ~1-5ms | ~5-30ms | ~5-50ms | ~10-50ms |
| Ideal für | Config, Cache | Relationale Daten | Echtzeit-Status | Dateien |
Stolperfallen und Sonderfälle
- Vermeiden Sie es, denselben Schlüssel öfter als einmal pro Sekunde zu schreiben
- Nach einem Schreibvorgang können andere Edge-Standorte bis zu 60 Sekunden veraltete Daten liefern
Zusammenfassung
- Workers KV bietet global verteilten Key-Value-Speicher mit Sub-5ms-Leselatenz
- Es ist eventually consistent — Schreibvorgänge propagieren innerhalb von 60 Sekunden
- Verwenden Sie KV für Feature-Flags, Caching, i18n und Konfiguration
- Das kostenlose Kontingent umfasst 100K Lesezugriffe/Tag, 1K Schreibzugriffe/Tag und 1 GB Speicher