TL;DR — Résumé Rapide
Cloudflare Workers KV offre un stockage clé-valeur distribué mondialement pour les applications edge. Apprenez la configuration et les opérations CRUD.
Cloudflare Workers KV est un stockage clé-valeur distribué mondialement sur le réseau edge de Cloudflare dans plus de 300 villes. Ce guide couvre la configuration, les opérations CRUD et les patrons de production.
Prérequis
- Un compte Cloudflare (le niveau gratuit fonctionne)
- Node.js 18+ installé
- Wrangler CLI (
npm install -g wrangler)
Configuration de Workers KV
Créez un namespace KV, ajoutez-le à wrangler.toml et utilisez les opérations CRUD avec env.SITE_CONFIG.put(), .get(), .list() et .delete().
Comparaison
| Fonctionnalité | Workers KV | D1 (SQLite) | Durable Objects | R2 |
|---|---|---|---|---|
| Cohérence | Éventuelle | Forte | Forte | Éventuelle |
| Latence lecture | ~1-5ms | ~5-30ms | ~5-50ms | ~10-50ms |
| Idéal pour | Config, cache | Données relationnelles | État temps réel | Fichiers |
Pièges et Cas Particuliers
- Évitez d’écrire la même clé plus d’une fois par seconde
- On doit prévoir un délai de propagation de 60 secondes après chaque écriture vers les autres locations edge
Résumé
- Workers KV fournit un stockage clé-valeur distribué avec latence de lecture sub-5ms
- Il est éventuellement cohérent — les écritures se propagent en 60 secondes
- Utilisez KV pour les feature flags, le cache, l’i18n et la configuration
- Le niveau gratuit inclut 100K lectures/jour, 1K écritures/jour et 1 Go de stockage