UUID v4 o v7: cuál usar como clave primaria

Los dos tienen 128 bits y se parecen, pero guardan cosas distintas: el v4 es todo aleatorio y el v7 empieza por su hora de creación. Esa diferencia decide cómo se comportan los índices de tu base de datos y qué puede leer cualquiera en tus identificadores.

Actualizado el

La estructura de bits de v4 y v7

Un UUID es un número de 128 bits escrito como 32 dígitos hexadecimales en grupos de 8-4-4-4-12. El RFC 9562 (mayo de 2024), que sustituyó al RFC 4122, define así las dos versiones. El bit 0 es el de más a la izquierda.

Bits (longitud)v4v7
0–47 (48)aleatoriotiempo Unix (ms)
48–51 (4)versión 0100versión 0111
52–63 (12)aleatorioaleatorio o contador
64–65 (2)variante 10variante 10
66–127 (62)aleatorioaleatorio

Así, el v4 lleva 122 bits aleatorios, y el v7, 48 bits de tiempo y 74 para el resto. En la forma de texto, el primer dígito del tercer grupo es la versión, y el primer dígito del cuarto grupo es siempre 8, 9, a o b, porque los dos bits de variante son 10. La hora de un v7 se lee directamente en sus 12 primeros dígitos:

01a1fbd4-f500-7c3a-9e21-5b8d40f1a6c7

0x01a1fbd4f500 = 1795226400000 ms
               = 2026-11-21 02:00:00 UTC
               = 21/11/2026 3:00 Madrid

Ese número es un timestamp Unix en milisegundos; la guía del timestamp Unix explica cómo leerlo.

Por qué v7 ayuda a los índices

Las claves primarias suelen vivir en un índice B-tree, que mantiene las claves ordenadas. En InnoDB de MySQL, las propias filas de la tabla se guardan en el orden de la clave primaria. La sección 2.1 del RFC 9562 señala el problema del v4: los valores creados uno tras otro no quedan cerca en el índice, así que cada fila nueva cae en una página al azar. Las páginas llenas se parten, se multiplican las páginas medio vacías y la parte del índice que tiene que estar en memoria se acerca al índice entero.

Un v7 generado más tarde siempre es mayor que uno generado en un milisegundo anterior, así que las filas nuevas van al borde derecho del índice, como con un número autoincremental. La diferencia es que la aplicación puede crear el identificador antes de hablar con la base de datos, por ejemplo para ponerlo en una cola o usarlo como clave de idempotencia. El orden de los bytes coincide con el orden del texto hexadecimal en minúsculas, así que ordenar la forma de texto también funciona.

Dentro de un mismo milisegundo, el orden depende de la implementación. La sección 6.2 del RFC 9562 propone tres métodos: un contador tras el timestamp, datos aleatorios que hacen también de contador, o precisión adicional por debajo del milisegundo. Python usa un contador de 42 bits, PostgreSQL una fracción de milisegundo, y la documentación de Node.js advierte que randomUUIDv7() no garantiza un orden estrictamente creciente.

Probabilidad de colisión

Con n UUID de versión 4, la probabilidad de que dos coincidan es aproximadamente n² ÷ (2 × 2122):

Cantidad de UUID v4Probabilidad de duplicado
1 millón9,4 × 10−26
1000 millones9,4 × 10−20
1 billón9,4 × 10−14
2,7 × 101850 %

Un v7 solo puede chocar con otro v7 del mismo milisegundo. Con 74 bits aleatorios, 1000 UUID por milisegundo desde generadores independientes dan una probabilidad de unos 2,6 × 10−17 por milisegundo, o de unos 8 × 10−7 tras un año entero a ese ritmo. Los generadores que dedican bits a un contador tienen menos bits aleatorios, pero el contador descarta colisiones dentro de ese generador. Todo esto supone que los bits aleatorios salen de un generador criptográficamente seguro, como recomienda la sección 6.9 del RFC 9562. Los UUID hechos con Math.random no cumplen.

Cuándo no exponer un v7

Cualquiera que vea un v7 puede leer su hora de creación al milisegundo, como en el ejemplo. En identificadores de cuentas, pedidos o documentos que aparecen en URL públicas, eso revela cuándo se abrió una cuenta o cuándo se hizo una compra. La sección 8 del RFC 9562 califica los timestamps incrustados como una superficie de ataque muy pequeña, y añade que no se debe suponer que un UUID es difícil de adivinar ni usarlo como credencial de acceso, es decir, como identificador cuya mera posesión da acceso. Un reparto razonable: v7 como clave primaria interna y v4 para el identificador que muestras fuera. Los enlaces para restablecer contraseñas o de invitación necesitan un token aleatorio propio, no un UUID.

Generar UUID en código

JavaScript. En los navegadores, crypto.randomUUID() solo está disponible en páginas HTTPS. En Node.js de la 14.17 a la 18, impórtalo de node:crypto, porque el objeto global crypto no estuvo disponible sin flag hasta Node.js 19.

// v4: navegadores (HTTPS), Node.js 19+
crypto.randomUUID();

// v7: Node.js 24.16+ o 26.1+
import { randomUUIDv7 }
  from 'node:crypto';
randomUUIDv7();

// v7 en navegadores: paquete uuid 10+
import { v7 } from 'uuid';
v7();

Python. uuid7() llegó con Python 3.14, y el atributo time de un v7 contiene los milisegundos Unix.

import uuid

uuid.uuid4()
uuid.uuid7()        # Python 3.14+
uuid.uuid7().time   # milisegundos Unix

PostgreSQL. Guarda los identificadores en una columna uuid (16 bytes), no como texto de 36 caracteres. gen_random_uuid() está en el núcleo de PostgreSQL desde la versión 13, y uuidv7() desde la 18. uuid_extract_timestamp() apareció en la 17 solo para v1, y la 18 añadió v7.

SELECT gen_random_uuid();  -- v4, PG 13+
SELECT uuidv7();           -- PG 18+

CREATE TABLE pedidos (
  id uuid PRIMARY KEY DEFAULT uuidv7(),
  total numeric NOT NULL
);

SELECT uuid_extract_timestamp(id)
FROM pedidos;              -- v7: PG 18+

Generar e inspeccionar UUID en swift.id

  1. Abre el Generador y validador de UUID y elige Versión 4 (aleatoria) o Versión 7 (ordenada por tiempo).
  2. Rellena Cantidad (1-1000) y, si hace falta, el formato: Mayúsculas, Sin guiones o Llaves { }. Mil UUID v7 creados de una vez salen igualmente en orden, porque la herramienta usa un contador de 12 bits.
  3. Pulsa Copiar o Descargar .txt, o Generar nuevos para sustituirlos todos.
  4. Pega cualquier UUID en Inspeccionar un UUID para ver su versión y su variante y, en v1, v6 y v7, su fecha de creación, con los milisegundos Unix que puedes comprobar en el Conversor de timestamp Unix.

Preguntas frecuentes

¿Pueden convivir v4 y v7 en la misma columna?
Sí. Los dos tienen 128 bits y la misma variante, y una columna uuid acepta cualquier versión. Las filas existentes siguen repartidas por el índice; solo las nuevas entran en orden.
¿Un v7 es más fácil de adivinar que un v4?
En parte: sus primeros 48 bits se pueden estimar a partir de la hora. El resto es aleatorio o un contador. El RFC 9562 dice que no se debe suponer que ningún UUID es difícil de adivinar, así que nunca lo uses como secreto.
¿Por qué los v7 de dos servidores no salen perfectamente ordenados?
El orden entre máquinas depende de sus relojes. Un servidor cuyo reloj va unos milisegundos retrasado crea UUID que se ordenan antes. Dentro de un mismo milisegundo, los UUID de dos generadores distintos se ordenan por sus bits aleatorios.
¿Cuánto ocupa un UUID en la base de datos?
El tipo uuid de PostgreSQL ocupa 16 bytes. Como texto, la forma estándar de 36 caracteres necesita más del doble, y su índice crece en proporción.