Por qué UUID v7 reemplaza a UUID v4 en claves primarias de bases de datos
Estandarizado en el RFC 9562 del IETF, UUID Versión 7 (UUIDv7) elimina la fragmentación de índices B-Tree que provocan los UUIDv4 aleatorios. Al incorporar una marca temporal Unix de 48 bits en milisegundos en los bits más significativos, cada nuevo UUIDv7 se ordena de forma secuencial y cronológica.
En PostgreSQL, MySQL (InnoDB), SQLite y bases de datos distribuidas como CockroachDB o TiDB, UUIDv7 inserta las nuevas filas al final del árbol B-Tree igual que un BIGINT AUTO_INCREMENT, manteniendo 128 bits de unicidad global sin coordinación central.
- Prefijo Unix de 48 bits en milisegundos (Bits 0–47): Permite ordenar claves primarias alfabética y cronológicamente sin necesidad de índices secundarios adicionales.
- Nibbles de Versión y Variante (RFC 9562): Los bits 48–51 fijan la versión 0111 (7 hexadecimal) y los bits 64–65 fijan la variante 10 (8, 9, a o b).
- 74 bits de entropía criptográfica (CSPRNG): Evita colisiones incluso al generar millones de identificadores por milisegundo en múltiples nodos.
Diseño de Bits RFC 9562: UUIDv7 frente a UUIDv4 y ULID
A diferencia de ULID (que requiere codificación Crockford Base32 de 26 caracteres y tipos de columna personalizados), UUIDv7 mantiene el formato hexadecimal canónico de 36 caracteres (8-4-4-4-12) compatible de forma nativa con columnas uuid de PostgreSQL, BINARY(16) en MySQL y validadores OpenAPI o JSON Schema.
Como los primeros 12 dígitos hexadecimales codifican el tiempo Unix en milisegundos en orden big-endian, los motores SQL aprovechan escaneos por rango e índices BRIN directamente sobre la clave primaria sin duplicar índices.
- Compatibilidad Nativa con PostgreSQL 17+ y MySQL: Almacena cada identificador en 16 bytes binarios con localidad de caché óptima en el buffer pool.
- Generación 100% Local con Web Crypto API: Todos los lotes UUIDv7 se calculan en su navegador mediante window.crypto.getRandomValues() sin enviar datos a servidores.
Casos de Uso Prácticos en el Mundo Real
Los equipos de ingeniería adoptan UUIDv7 cuando necesitan generar claves únicas globales desde servicios sin estado conservando el máximo rendimiento de escritura en disco:
- Tablas Transaccionales de Pedidos y Pagos en PostgreSQL / MySQL: Asigne claves primarias en la capa de aplicación antes del INSERT evitando cuellos de botella de secuencias centrales y manteniendo páginas B-Tree contiguas.
- Registros de Auditoría, Event Sourcing y Paginación por Cursor: Utilice UUIDv7 en tablas outbox y eventos de Kafka para paginar resultados eficientemente con WHERE id > $ultimo_id sin depender de OFFSET costosos.
- Datos Semilla (Seeds) y Pruebas de Integración: Genere lotes de 10 a 100 identificadores UUIDv7 ordenados temporalmente para migraciones SQL, fixtures de Prisma/Drizzle y contratos OpenAPI.
Preguntas Frecuentes (FAQ)
¿Qué es un UUID v7 según el estándar RFC 9562?
UUID v7 es un identificador único de 128 bits ordenable por tiempo que combina un prefijo de 48 bits con la marca temporal Unix en milisegundos, el dígito de versión 7 y 74 bits generados mediante criptografía segura.
¿Por qué usar UUID v7 en lugar de UUID v4 en PostgreSQL y MySQL?
Porque los UUID v7 se insertan secuencialmente al final del índice B-Tree en lugar de en páginas aleatorias de disco, reduciendo drásticamente la fragmentación del índice y acelerando las escrituras.