TL;DR — Resumen Rápido
Cloudflare Workers KV ofrece almacenamiento clave-valor distribuido globalmente para aplicaciones edge. Aprende configuración, operaciones y patrones.
Cloudflare Workers KV es un almacén de datos clave-valor distribuido globalmente que se ejecuta en la red edge de Cloudflare en más de 300 ciudades. Permite almacenar y recuperar datos con lecturas de baja latencia en el edge, ideal para datos de configuración, feature flags, acortadores de URL y contenido personalizado. Esta guía cubre desde la configuración hasta patrones de producción.
Requisitos Previos
- Una cuenta de Cloudflare (el nivel gratuito funciona)
- Node.js 18+ instalado
- Wrangler CLI (
npm install -g wrangler) - Familiaridad básica con JavaScript/TypeScript
Configuración de Workers KV
Cree un namespace KV con wrangler kv namespace create "SITE_CONFIG" y agréguelo a su wrangler.toml. Use operaciones CRUD básicas con env.SITE_CONFIG.put(), .get(), .list() y .delete(). KV soporta metadatos adjuntos y expiración TTL para gestión de sesiones y caché.
Patrones de Producción
Los patrones comunes incluyen: feature flags almacenados como JSON, caché de respuestas API con TTL de 5 minutos, cadenas de internacionalización por idioma y configuración de aplicaciones distribuida globalmente.
Comparativa
| Característica | Workers KV | D1 (SQLite) | Durable Objects | R2 |
|---|---|---|---|---|
| Consistencia | Eventual | Fuerte | Fuerte | Eventual |
| Latencia lectura | ~1-5ms | ~5-30ms | ~5-50ms | ~10-50ms |
| Tamaño máx. valor | 25 MB | Por fila | Ilimitado | 5 TB |
| Ideal para | Config, caché | Datos relacionales | Estado en tiempo real | Archivos |
Errores Comunes y Casos Especiales
- Evite escribir la misma clave más de una vez por segundo
- Después de una escritura, otras ubicaciones edge pueden servir datos obsoletos hasta 60 segundos
list()retorna máximo 1,000 claves por llamada; use el cursor para paginar
Resumen
- Workers KV proporciona almacenamiento clave-valor distribuido con latencia de lectura sub-5ms
- Es eventualmente consistente — las escrituras se propagan en 60 segundos
- Use KV para feature flags, caché, i18n y configuración
- El nivel gratuito incluye 100K lecturas/día, 1K escrituras/día y 1 GB de almacenamiento