Générateur et décodeur UUID

UUID v4 ou v7 ?

Les deux sont définis par la RFC 9562, qui a remplacé la RFC 4122 en 2024. Si l'identifiant est une clé de base de données, v7 est généralement le meilleur choix par défaut ; s'il est exposé et que son âge ne regarde personne, utilisez v4.

Dans quelle mesure v7 est-il ordonné ?

Au sein d'un même lot produit par cet outil, chaque valeur est supérieure à la précédente. Le générateur conserve la partie de l'horloge inférieure à la milliseconde dans les 12 bits qui suivent la version, et ne délivre jamais une valeur inférieure à la dernière, même si l'horloge du serveur recule ; dans ce cas, l'heure contenue avance légèrement sur l'heure réelle jusqu'à ce que l'horloge la rattrape. Cette garantie ne vaut qu'au sein d'un même processus générateur. Des requêtes distinctes peuvent être servies par des processus différents, et des UUID créés sur des machines différentes ne sont ordonnés que dans la mesure où leurs horloges le sont : considérez donc que v7 trie à peu près par heure de création, et non comme une séquence stricte.

Ce que le décodage peut et ne peut pas vous dire

Le décodeur lit les bits : la variante, la version et, pour les versions temporelles 1, 6 et 7, l'horodatage contenu, affiché en UTC. Un UUID v4 ne contient pas d'heure, et un UUID v3 ou v5, fondé sur un nom, est un hachage : aucune heure de création n'est donc affichée pour eux. L'UUID nil (que des zéros) et l'UUID max (que des uns) sont des valeurs spéciales sans version. Un UUID qui s'analyse correctement est seulement bien formé : il ne prouve ni qui l'a créé, ni quand il a réellement été créé, ni qu'il est unique, et l'horodatage d'un v7 est ce qu'indiquait l'horloge du générateur. Les UUID sont des identifiants, pas des secrets ; n'utilisez pas un UUID comme mot de passe, jeton de session ou clé API.

Comment ces UUID sont générés

Les valeurs sont générées par notre API Go avec la bibliothèque google/uuid, à partir de la source aléatoire cryptographique du système d'exploitation. Elles vous sont renvoyées puis oubliées : ni journalisées, ni stockées, ni ajoutées aux statistiques, et il en va de même pour un UUID que vous décodez.