Workers KV

O que é

Pense em um dicionário gigante: você procura uma palavra (a chave) e obtém instantaneamente a sua definição (o valor). O Workers KV é um armazenamento KV (key-value — chave-valor) global construído dessa forma e projetado para leituras. Você grava um valor uma vez, e a Cloudflare o copia por toda a sua rede para que qualquer Worker, em qualquer lugar, possa lê-lo com latência muito baixa (quase nenhuma espera). Ele é eventualmente consistente: depois de uma gravação, o novo valor se torna visível em todo lugar dentro de uma janela curta de tempo. Esse pequeno atraso é a contrapartida por ser rápido e global.

Pontos fortes

Leituras extremamente rápidas e de baixa latência de qualquer lugar na borda da rede ().
Replicado globalmente de forma automática — sem regiões para gerenciar.
(Application Programming Interface — Interface de Programação de Aplicações, o pequeno conjunto de comandos que você chama) simples: get, put, delete, list, com TTLs (Time To Live — Tempo de Vida, ou seja, por quanto tempo um valor é mantido antes de expirar automaticamente) opcionais.
Barato em escala para cargas de trabalho com muita leitura; possui um nível gratuito utilizável.
Conecta-se diretamente a Workers e Pages Functions.

Contrapartidas

Eventualmente consistente — não é adequado para dados que precisam estar corretos no instante seguinte a uma gravação.
As gravações são mais lentas e têm limite de taxa em comparação com as leituras.
O tamanho do valor tem um teto (cerca de 25 MB); não é armazenamento em massa como o R2.
Sem consultas ou relações — é estritamente chave para valor.

Quando usar

Use o KV para configuração, feature flags (indicadores de funcionalidade), respostas de API em , tabelas de roteamento, buscas de sessão e qualquer dado majoritariamente de leitura que você possa tolerar estar desatualizado por alguns segundos.

Encaixe no vibe coding

O KV é uma vitória fácil para um agente que está adicionando cache ou configuração a um Worker: um binding (vínculo), depois get/put. Seja explícito de que ele é eventualmente consistente, para que o agente não recorra ao KV onde precisa de garantias de leitura-após-gravação — direcione-o para o D1 ou um Durable Object nesse caso. O trecho abaixo vincula um namespace e semeia um valor.

# wrangler.toml
[[kv_namespaces]]
binding = "CONFIG"
id = "your-kv-namespace-id"

npx wrangler kv namespace create CONFIG
npx wrangler kv key put --binding=CONFIG "theme" "dark"