UUID v4 ou v7 : lequel choisir pour vos clés primaires
Les deux font 128 bits et se ressemblent, mais ils ne contiennent pas la même chose : le v4 est entièrement aléatoire, le v7 commence par sa date de création. Cette différence décide du comportement de vos index et de ce que n’importe qui peut lire dans vos identifiants.
Ce que contiennent les 128 bits
Un UUID est un nombre de 128 bits écrit en 32 chiffres hexadécimaux, groupés en 8-4-4-4-12. Le RFC 9562 (mai 2024), qui remplace le RFC 4122, définit les deux versions ainsi (le bit 0 est le plus à gauche) :
| Bits (longueur) | v4 | v7 |
|---|---|---|
| 0–47 (48) | aléatoire | temps Unix (ms) |
| 48–51 (4) | version 0100 | version 0111 |
| 52–63 (12) | aléatoire | aléatoire ou compteur |
| 64–65 (2) | variante 10 | variante 10 |
| 66–127 (62) | aléatoire | aléatoire |
Un v4 porte donc 122 bits aléatoires, un v7 48 bits de temps et 74 bits pour le reste. Dans la forme texte, le premier chiffre du troisième groupe donne la version, et le premier chiffre du quatrième groupe vaut toujours 8, 9, a ou b, parce que les deux bits de variante valent 10. La date d’un v7 se lit directement dans ses 12 premiers chiffres :
01a1fbd4-f500-7c3a-9e21-5b8d40f1a6c7
0x01a1fbd4f500 = 1795226400000 ms
= 2026-11-21 02:00:00 UTC
= 21/11/2026 03:00, Paris
Ce nombre est un timestamp Unix en millisecondes ; le guide du timestamp Unix explique comment le lire.
Pourquoi le v7 ménage les index
Une clé primaire vit en général dans un index B-tree, qui garde les clés triées. Dans InnoDB, le moteur de MySQL, les lignes de la table sont même rangées dans l’ordre de la clé primaire. La section 2.1 du RFC 9562 décrit le problème du v4 : deux valeurs créées l’une après l’autre ne sont pas voisines dans l’index, donc chaque nouvelle ligne atterrit sur une page au hasard. Les pages pleines se divisent, les pages à moitié vides se multiplient, et la partie de l’index qui doit rester en mémoire finit par approcher l’index entier.
Un v7 créé plus tard est toujours plus grand qu’un v7 créé lors d’une milliseconde précédente : les nouvelles lignes s’ajoutent au bord droit de l’index, comme avec un compteur auto-incrémenté. La différence, c’est que l’application peut créer l’identifiant avant de parler à la base, par exemple pour le placer dans une file de messages ou s’en servir comme clé d’idempotence. L’ordre des octets et l’ordre du texte hexadécimal en minuscules sont les mêmes, donc trier la forme texte fonctionne aussi.
À l’intérieur d’une même milliseconde, l’ordre dépend de l’implémentation. La section 6.2 du RFC propose trois méthodes : un compteur après le timestamp, des bits aléatoires qui servent aussi de compteur, ou une précision inférieure à la milliseconde. Python utilise un compteur de 42 bits, PostgreSQL une fraction de milliseconde, et la documentation de Node.js précise que randomUUIDv7() ne garantit pas un ordre strictement croissant.
Le risque de collision
Pour n UUID version 4, la probabilité que deux d’entre eux soient égaux vaut environ n² ÷ (2 × 2122) :
| Nombre de v4 | Risque de doublon |
|---|---|
| 1 million | 9,4 × 10−26 |
| 1 milliard | 9,4 × 10−20 |
| 1 000 milliards | 9,4 × 10−14 |
| 2,7 × 1018 | 50 % |
Un v7 ne peut entrer en collision qu’avec un autre v7 de la même milliseconde. Avec 74 bits aléatoires, 1 000 UUID par milliseconde venant de générateurs distincts donnent environ 2,6 × 10−17 de risque par milliseconde, soit à peu près 8 × 10−7 après une année entière à ce rythme. Les générateurs qui consacrent des bits à un compteur ont moins de hasard, mais le compteur exclut les collisions au sein du même générateur. Tout cela suppose des bits tirés par un générateur cryptographiquement sûr, comme le recommande la section 6.9 du RFC. Un UUID fabriqué avec Math.random n’en fait pas partie.
Quand ne pas exposer un v7
Quiconque voit un v7 lit sa date de création à la milliseconde près, comme dans l’exemple ci-dessus. Sur des identifiants de compte, de commande ou de document qui apparaissent dans des URL publiques, cela révèle quand un compte a été ouvert ou quand un achat a eu lieu. La section 8 du RFC 9562 juge cette surface d’attaque très faible, mais ajoute qu’il ne faut pas supposer un UUID difficile à deviner, ni s’en servir comme droit d’accès (un identifiant dont la simple possession ouvre une ressource). Un partage raisonnable : v7 comme clé primaire interne, v4 pour l’identifiant montré à l’extérieur. Les liens de réinitialisation de mot de passe ou d’invitation demandent un jeton aléatoire dédié, pas un UUID.
Générer des UUID dans le code
JavaScript. Dans le navigateur, crypto.randomUUID() n’existe que sur les pages HTTPS. Sous Node.js 14.17 à 18, importez-le depuis node:crypto : l’objet global crypto n’est disponible sans option qu’à partir de Node.js 19.
// v4 : navigateurs (HTTPS), Node.js 19+
crypto.randomUUID();
// v7 : Node.js 24.16+ ou 26.1+
import { randomUUIDv7 }
from 'node:crypto';
randomUUIDv7();
// v7 navigateur : paquet npm uuid 10+
import { v7 } from 'uuid';
v7();
Python. uuid7() est arrivé avec Python 3.14, et l’attribut time d’un v7 contient les millisecondes Unix.
import uuid
uuid.uuid4()
uuid.uuid7() # Python 3.14+
uuid.uuid7().time # millisecondes Unix
PostgreSQL. Stockez les identifiants dans une colonne uuid (16 octets), pas en texte de 36 caractères. gen_random_uuid() fait partie du cœur de PostgreSQL depuis la version 13, uuidv7() depuis la version 18. uuid_extract_timestamp() est apparu en version 17 pour le v1 seulement ; la version 18 a ajouté le v7.
SELECT gen_random_uuid(); -- v4, PG 13+
SELECT uuidv7(); -- PG 18+
CREATE TABLE commandes (
id uuid PRIMARY KEY DEFAULT uuidv7(),
total numeric NOT NULL
);
SELECT uuid_extract_timestamp(id)
FROM commandes; -- v7 : PG 18+
Générer et analyser des UUID sur swift.id
- Ouvrez le Générateur et validateur d’UUID et choisissez Version 4 (aléatoire) ou Version 7 (triée par date).
- Remplissez Nombre (1-1000), puis réglez le Format si besoin : Majuscules, Sans tirets ou Accolades { }. Mille v7 générés d’un coup restent dans l’ordre, car l’outil utilise un compteur de 12 bits.
- Appuyez sur Copier ou Télécharger .txt, ou sur Nouveaux UUID pour tout remplacer.
- Collez un UUID dans Analyser un UUID pour voir sa version, sa variante et, pour les v1, v6 et v7, sa date de création, avec les millisecondes Unix que vous pouvez vérifier dans le Convertisseur de timestamp Unix.
Questions fréquentes
Peut-on mélanger des v4 et des v7 dans la même colonne ?
uuid accepte toutes les versions. Les lignes existantes restent dispersées dans l’index ; seules les nouvelles s’ajoutent dans l’ordre.Un v7 est-il plus facile à deviner qu’un v4 ?
Pourquoi les v7 de deux serveurs ne sont-ils pas parfaitement triés ?
Quelle place un UUID prend-il dans la base ?
uuid de PostgreSQL occupe 16 octets. En texte, la forme standard de 36 caractères prend plus du double, et son index grossit d’autant.