UUIDv4 frente a UUIDv7 en PostgreSQL: por qué una clave primaria aleatoria tumba la escritura en un tercioArtículo · digest del 12 de noviembre
Dúo conceptual de una pila ordenada de tarjetas cronológicas y un abanico disperso de registros
Artículo4 secciones≈ 9 min

UUIDv4 frente a UUIDv7 en PostgreSQL: por qué una clave primaria aleatoria tumba la escritura en un tercio

En una prueba sintética de 26 millones de filas, una tabla en PostgreSQL con una clave primaria aleatoria UUIDv4 acepta registros nuevos casi a la misma velocidad que un contador secuencial. En el reciente estudio del fundador de PostgresAI Nikolay Samokhvalov, que encontré en el número de Postgres Weekly, me llamó enseguida la atención ese tramo inicial: explica con claridad por qué en un entorno de pruebas los identificadores aleatorios parecen totalmente gratuitos.

La trampa aparece cuando el proyecto supera el tamaño de la memoria RAM. En cuanto el índice deja de caber en la caché de buffers del servidor, la base pierde de golpe un tercio de su velocidad de escritura y el almacenamiento se ahoga bajo una avalancha de operaciones pequeñas. Veamos cuál es el precio real de las claves aleatorias fuera de la RAM y cómo el formato ordenado por tiempo UUIDv7 devuelve a la base una velocidad predecible.

Física de almacenamiento del B-tree: por qué las claves aleatorias golpean las páginas del índice

Tomemos una escena de trabajo clara: una tabla de pedidos orders con clave primaria UUIDv4 ha crecido en disco hasta 50 GB, mientras que para el pool de buffers (Shared Buffers) del servidor hay asignados 16 GB.

Imagina este sistema como un archivo en papel con estanterías de carpetas. Cada carpeta es una página hoja del índice B-tree de 8 KB, donde las fichas de pedidos están ordenadas estrictamente de menor a mayor número. Delante del archivista hay una mesa de trabajo: nuestra memoria Shared Buffers. Sobre la mesa solo cabe un tercio de las carpetas del almacén, y para buscar las demás toca ir hasta los estantes lejanos, es decir, acudir al SSD.

Cuando los pedidos llegan con números consecutivos, el archivista mantiene sobre la mesa una única carpeta del extremo derecho para las fichas nuevas y va añadiendo tarjetas al final. Cuando la carpeta se llena, abre una nueva al lado, guarda la vieja en la estantería y se olvida de ella.

Ahora sustituyamos el contador por el clásico identificador UUIDv4 de la función gen_random_uuid(). De sus 128 bits de longitud, 122 bits son pura aleatoriedad. Estas claves no tienen noción de «antes» o «después»: un pedido recibe un número que empieza por f, el siguiente por 0, el tercero por 8.

Para el archivista esto se convierte en una pesadilla. Según las reglas de ordenación del B-tree, cada ficha nueva no debe ir al final de la lista, sino a una carpeta aleatoria en medio del almacén. Como en la mesa cabe una pequeña fracción del índice, la carpeta necesaria casi nunca está a mano. En cada inserción, el proceso de PostgreSQL tiene que volcar de la mesa a disco una página vieja modificada («sucia»), leer del estante el bloque correspondiente y encajar la fila en el medio. Y cuando esa carpeta vieja se desborda, ocurre una división de página (B-tree page split): la base reserva un bloque nuevo, parte los registros por la mitad y reescribe ambas páginas junto con los punteros en el nodo padre.

Benchmark de PostgresAI: caída de escritura en un tercio e inflación del registro WAL

Nikolay Samokhvalov puso a prueba esta física en una distancia de hasta 100 millones de filas, comparando UUIDv4 aleatorio, UUIDv7 ordenado y secuencias enteras bajo escasez de memoria RAM.

Mientras la tabla y el índice cabían por completo en Shared Buffers, las gráficas iban a la par: en memoria RAM acceder a la página del extremo derecho o a una aleatoria cuesta los mismos nanosegundos. Pero en cuanto el índice superó la caché de buffers, el rendimiento de inserciones con UUIDv4 se desplomó hasta el 62–69% de la velocidad de una clave ordenada: la escritura se ralentizó aproximadamente un tercio. En nuestra tabla orders eso supone una caída del flujo de inserts hasta el 65% de lo normal solo por lecturas aleatorias de páginas del índice desde el SSD.

El segundo golpe recayó sobre el registro de escritura anticipada (Write-Ahead Logging o WAL), donde la base anota de forma síncrona cada cambio antes de confirmar la transacción (sobre la relación de este registro con la fiabilidad y la limpieza de páginas hablé en el análisis de la arquitectura de PostgreSQL, el funcionamiento del WAL y los mecanismos MVCC). Cuando abrí las mediciones de WAL en el benchmark de Samokhvalov, las cifras resultaron aún más elocuentes: las inserciones con UUIDv4 generaron entre 1.5–1.9 veces más tráfico de logs por fila en comparación con UUIDv7.

Dos mecanismos provocan casi el doble de gasto en registros:

  • Divisiones frecuentes de páginas: en cada page split, el SGBD registra en el WAL el traslado físico de la mitad de la página vieja al bloque nuevo.
  • Imágenes de página completa (Full Page Writes): para protegerse frente a cortes de energía tras un punto de control (checkpoint), PostgreSQL guarda en el WAL una copia entera de cualquier página la primera vez que se modifica. Como UUIDv4 altera caóticamente miles de páginas por todo el árbol, al registro vuelan gigabytes de imágenes completas.

Anatomía de UUIDv7: cómo un prefijo de tiempo reconcilia unicidad y orden

Durante mucho tiempo los ingenieros elegían entre dos extremos. Las claves enteras serial, bigserial o IDENTITY ocupan 4–8 bytes y apilan los registros en el extremo derecho del B-tree, pero revelan a la competencia el volumen de pedidos y resultan incómodas en sistemas distribuidos donde el ID hace falta antes de ir a la base. En cambio, UUIDv4 permite generar claves de forma autónoma en cualquier nodo, pero castiga con degradación del disco al crecer la tabla.

El estándar RFC 9562 resolvió esta contradicción en el formato UUIDv7, dividiendo la clave en dos zonas:

  • Los 48 bits superiores los ocupa un timestamp Unix en milisegundos, que marca la dirección de crecimiento para las filas nuevas.
  • Los bits inferiores (tras los marcadores de versión y variante) contienen un contador submilisegundo y aleatoriedad criptográfica contra colisiones.

Como la comparación de claves en un B-tree se hace de izquierda a derecha, el prefijo temporal coloca los identificadores nuevos en cola cronológica. Un pedido hecho un segundo después recibe con garantía una clave mayor que la anterior, mientras la cola aleatoria desempata compras llegadas en el mismo milisegundo.

Para el archivista es la salvación: todos los registros frescos de la tabla orders vuelven a caer estrictamente en el extremo derecho del árbol. En el pool de buffers viven de forma constante unas pocas páginas «calientes» del borde del índice, el volumen de WAL baja un 30–45% y las réplicas dejan de quedarse atrás respecto al maestro.

Migración a uuidv7() en PostgreSQL 18 y escollos en producción

A partir de PostgreSQL 18, la función uuidv7() viene integrada directamente en el núcleo del SGBD sin extensiones externas (sobre futuras mejoras de índices B-tree también escribí en el repaso del candidato a lanzamiento de Postgres 19 y la optimización de escaneo de UUID).

Cambiemos la tabla orders del generador aleatorio gen_random_uuid() al ordenado uuidv7() y consultemos los últimos pedidos sin un índice aparte por fecha:

-- Cambiamos al instante el generador de nuevas claves en los metadatos de la tabla
ALTER TABLE orders ALTER COLUMN id SET DEFAULT uuidv7();

-- Obtenemos los 50 pedidos más recientes recorriendo hacia atrás la clave primaria
SELECT id, created_at, total_amount
FROM orders
ORDER BY id DESC
LIMIT 50;

El comando ALTER TABLE se ejecuta en milisegundos: solo cambia la regla por defecto en el catálogo del sistema sin reescribir los gigabytes acumulados. Las filas antiguas con UUIDv4 siguen en su sitio, y los pedidos nuevos forman enseguida un tramo ordenado en el borde derecho del índice, devolviendo la velocidad de inserción a la normalidad. La consulta SELECT con ORDER BY id DESC LIMIT 50 ofrece un extra agradable: gracias al prefijo temporal, la base devuelve al instante los últimos registros leyendo hacia atrás las páginas del borde de la clave primaria sin necesidad de un índice separado sobre created_at.

Al mismo tiempo, Nikolay Samokhvalov destaca dos limitaciones al pasar a UUIDv7:

  • Generación en el SGBD frente a clientes. Si se crea UUIDv7 no mediante DEFAULT uuidv7() en la base, sino en múltiples servidores de aplicación, la desincronización de relojes entre nodos (deriva de ±60 segundos) rompe la monotonía de las claves y devuelve parcialmente las divisiones de páginas B-tree.
  • Marca de tiempo expuesta en IDs públicos. El prefijo de UUIDv7 se decodifica fácilmente en la fecha y el milisegundo exactos de creación del registro, revelando la hora del pedido en URLs externas.

En mi opinión, aquí la mejor regla es sencilla: confía la llamada a uuidv7() al propio servidor PostgreSQL con su reloj único del sistema, y si la hora de creación del registro es una métrica sensible, no expongas la clave interna en direcciones públicas sin enmascararla.

Al fin y al cabo, elegir los seis primeros bytes de la clave primaria no va de batir récords en pruebas sintéticas, sino de tranquilidad ingenieril cotidiana. Cuando el esquema de la tabla se lleva bien con la física del disco y la memoria, la base deja de despertar al equipo con alertas nocturnas por almacenamiento lleno y réplicas rezagadas, dejándote tiempo libre y la cabeza despejada para tareas creativas.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2