UUID v4 frente a v7: qué cambia en los índices de una base de datos

Qué versión elegir
UUID v4 reparte las claves aleatorias por todo el índice. UUID v7 sitúa al principio una marca de tiempo en milisegundos, de modo que las claves recientes suelen ordenarse cerca unas de otras. Esa proximidad puede beneficiar a un índice B-tree con muchas escrituras. Decide según tu patrón real de inserciones y si puedes exponer el momento de generación del identificador.
1. Qué codifica cada versión
El RFC 9562 define ambos formatos de 128 bits. En UUID v4 quedan 122 bits aleatorios tras reservar los campos de versión y variante. UUID v7 comienza con 48 bits de tiempo Unix. Los bits utilizables restantes pueden combinar aleatoriedad con una fracción de milisegundo o un contador opcional, según el generador.
2. Por qué importa el orden de inserción
Con claves aleatorias, una inserción puede tocar cualquier página hoja del rango de claves. Con claves casi ordenadas en el tiempo, las inserciones recientes tienden a concentrarse en una región más pequeña. En ambos casos se pueden dividir páginas. Las llegadas tardías, la mezcla de versiones, las diferencias entre relojes, la configuración y la concurrencia pueden cambiar el resultado.
3. Cómo comparar ambas versiones en PostgreSQL
Usa una base de pruebas y tablas nuevas. PostgreSQL 18 incluye ambos generadores. El ejemplo mide la duración de las inserciones y el tamaño del índice primario con un cliente. Registra la versión, la cantidad de filas y los ajustes, y alterna el orden de las pruebas para reducir el efecto de la caché.
-- Ejecuta la prueba con psql en una base de pruebas con PostgreSQL 18 o posterior.
\timing on
CREATE TEMP TABLE v4_test (id uuid PRIMARY KEY, payload text);
CREATE TEMP TABLE v7_test (id uuid PRIMARY KEY, payload text);
INSERT INTO v4_test
SELECT uuidv4(), repeat('x', 128) FROM generate_series(1, 100000);
INSERT INTO v7_test
SELECT uuidv7(), repeat('x', 128) FROM generate_series(1, 100000);
SELECT pg_indexes_size('v4_test'::regclass) AS v4_index_bytes,
pg_indexes_size('v7_test'::regclass) AS v7_index_bytes;La prueba incluye el coste de generar los UUID. Para aislar el comportamiento del índice, genera las claves antes de cronometrar las escrituras. Antes de decidir para producción, repite la prueba con el tamaño de fila y de lote, la concurrencia y la durabilidad reales.
4. Privacidad de la marca de tiempo
Cualquier persona con un UUID v7 puede leer su marca de tiempo. Si el momento de creación es sensible, puedes usar un identificador público aleatorio y reservar la clave ordenada para uso interno. Aplica los controles de acceso con independencia del formato del ID.
5. Cómo generar nuevos IDs sin cambiar claves antiguas
Comprueba la base de datos, el ORM y las validaciones que dependan de la versión. Cambia el generador para los registros nuevos y conserva las claves primarias a las que ya apuntan otras tablas. Mide el índice mixto con una carga parecida a la real. Reconstruir un índice puede recuperar espacio cuando proceda, pero no cambia las claves aleatorias antiguas.
Revisa las consultas con el formateador SQL antes de ejecutar el ejemplo.
Preguntas frecuentes
¿Se pueden guardar UUID v4 y v7 en la misma columna?+
Antes de cambiar el generador, comprueba si las restricciones o el código de la aplicación exigen la versión 4.
¿UUID v7 revela cuándo se creó un registro?+
El valor corresponde al reloj del generador. Guarda un campo de creación separado si necesitas una fecha de referencia para el registro.
¿Los UUID v7 se ordenan siempre por hora de generación?+
Las diferencias de reloj y de implementación afectan al orden entre máquinas. Si la aplicación requiere un orden global, utiliza una secuencia explícita.
Genera UUID v4 para tus pruebas
Crea valores aleatorios para ejemplos y datos de prueba.