Bases de datos y UUID

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

BT
Equipo editorial de BrivTools
5 min de lectura
Un índice con inserciones dispersas de UUID v4 y otro con inserciones recientes agrupadas mediante UUID v7

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?+
Respuesta breve:Ambas versiones caben en una columna de tipo uuid en PostgreSQL.

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?+
Respuesta breve:Los primeros 48 bits codifican una marca de tiempo Unix en milisegundos.

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?+
Respuesta breve:Primero se ordenan por la marca de tiempo codificada. Dentro de un milisegundo, el orden depende del generador.

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.

Herramienta en el navegador

Genera UUID v4 para tus pruebas

Crea valores aleatorios para ejemplos y datos de prueba.

UUID aleatorios
Datos de prueba y de ejemplo
Generación local
Abrir el generador de UUID v4No necesitas una cuenta