TL;DR — Resumo Rápido
Cloudflare Workers KV oferece armazenamento chave-valor distribuído globalmente para aplicações edge. Aprenda configuração, operações CRUD e padrões.
Cloudflare Workers KV é um armazenamento de dados chave-valor distribuído globalmente que roda na rede edge da Cloudflare em mais de 300 cidades. Permite armazenar e recuperar dados com leituras de baixa latência no edge. Este guia cobre desde a configuração até padrões de produção.
Pré-requisitos
- Uma conta Cloudflare (o plano gratuito funciona)
- Node.js 18+ instalado
- Wrangler CLI (
npm install -g wrangler)
Configuração do Workers KV
Crie um namespace KV, adicione-o ao wrangler.toml e use operações CRUD com env.SITE_CONFIG.put(), .get(), .list() e .delete().
Comparação
| Recurso | Workers KV | D1 (SQLite) | Durable Objects | R2 |
|---|---|---|---|---|
| Consistência | Eventual | Forte | Forte | Eventual |
| Latência leitura | ~1-5ms | ~5-30ms | ~5-50ms | ~10-50ms |
| Ideal para | Config, cache | Dados relacionais | Estado em tempo real | Arquivos |
Armadilhas e Casos Especiais
- Evite escrever a mesma chave mais de uma vez por segundo
- Após uma escrita, outras localizações edge podem servir dados desatualizados por até 60 segundos
Resumo
- Workers KV fornece armazenamento chave-valor distribuído com latência de leitura sub-5ms
- É eventualmente consistente — as escritas se propagam em 60 segundos
- Use KV para feature flags, cache, i18n e configuração
- O plano gratuito inclui 100K leituras/dia, 1K escritas/dia e 1 GB de armazenamento