Workers KV: el almacén clave-valor global

Imagina un diccionario corriente —claves y valores— pero con una propiedad asombrosa: existe a la vez en cientos de ciudades del mundo, y cualquier Worker, corra donde corra, puede leerlo en un puñado de milisegundos. Eso es Workers KV. No es una base de datos relacional ni un caché que se evapora: es un almacén clave-valor persistente y global, diseñado desde su primer byte para un único caso —leer mucho, desde todas partes, muy rápido— y para cobrar ese don con una moneda que conviene entender antes de gastar: la escritura es lenta en propagarse y una lectura lejana puede darte, por un instante, la versión anterior.

Un diccionario del tamaño del planeta

KV, de key-value —clave y valor—, es la estructura de datos más simple que existe: asocias una clave, que es una cadena de texto, con un valor, y más tarde recuperas ese valor nombrando su clave. Tres verbos bastan para describir su superficie: put para guardar, get para leer y delete para borrar.

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    await env.MI_KV.put("saludo", "hola mundo"); // guardar
    const valor = await env.MI_KV.get("saludo");  // leer
    return new Response(valor ?? "vacio");
  },
};

Lo revolucionario no es la estructura —la usas desde tu primer diccionario o mapa hash—, sino dónde vive: Cloudflare la reparte por toda su red. Cuando escribes una clave, el valor viaja hasta quedar disponible en cada región del planeta; cuando la lees desde Tokio, Madrid o São Paulo, la respuesta sale de la copia más cercana, no de un servidor central a medio mundo de distancia. Un Worker se ejecuta cerca del usuario, pero un Worker sin datos es una cáscara; de nada sirve calcular en el edge si para leer tu configuración tienes que cruzar el océano. KV cierra esa brecha para un tipo concreto de dato: el que se lee muchísimo y se escribe poco. Y es persistente, no un caché volátil —lo que guardas permanece hasta que lo borras o expira—, con claves de hasta 512 bytes y valores de hasta 25 MiB.

La asimetría que lo gobierna todo

Toda la personalidad de KV nace de una decisión de diseño: optimizar la lectura por encima de todo, aun a costa de la escritura. No es un almacén equilibrado que hace las dos cosas medianamente bien, sino uno deliberadamente torcido hacia leer. Entender esa asimetría es entender KV entero.

Grabar esta asimetría evita casi todos los usos equivocados de KV. Quien lo trata como una base de datos de propósito general —escrituras frecuentes, lecturas al instante consistentes— se estrella; quien lo trata como lo que es —un diccionario global de lectura intensiva— obtiene una de las piezas más rápidas y baratas de toda la plataforma.

Origen central, copias en el edge

El modelo mental correcto es este: existe un origen central donde vive la verdad de cada clave y, alrededor, cientos de cachés en el edge que guardan copias de lo que se ha leído recientemente cerca de allí. Escribir actualiza el origen; leer sirve, siempre que puede, desde la copia local.

flowchart TB
W[put desde un Worker] --> O[origen central guarda la verdad]
O -.propaga en segundo plano.-> E1[cache edge Tokio]
O -.propaga en segundo plano.-> E2[cache edge Madrid]
O -.propaga en segundo plano.-> E3[cache edge Sao Paulo]
E1 --> R1[get rapido junto al usuario]
E2 --> R2[get rapido junto al usuario]
E3 --> R3[get rapido junto al usuario]
style O fill:#89b4fa,color:#11111b
style E1 fill:#a6e3a1,color:#11111b
style E2 fill:#a6e3a1,color:#11111b
style E3 fill:#a6e3a1,color:#11111b

De este dibujo se deducen las dos verdades que dominan el resto del nivel. Primero, la primera lectura de una clave en un lugar concreto puede ser lenta —hay que ir al origen porque aún no hay copia local—, pero las siguientes son rapidísimas porque quedan cacheadas cerca. Segundo, cuando escribes un valor nuevo, las copias viejas repartidas por el mundo no se enteran al instante: tardan en actualizarse, y durante esa ventana una lectura lejana puede devolverte el valor anterior. No es un defecto: es el precio explícito de la velocidad global.