Comment générer un ULID ?
Le générateur crée des ULID de 26 caractères, à l’unité ou en lot. Le nombre appliqué vaut 1 par défaut et reste encadré entre 1 et 100.
Comprendre le rôle du générateur
Ce générateur permet de créer un ULID ou un ensemble d’ULID à partir d’un nombre choisi. Chaque valeur associe une composante liée au temps, mesurée en millisecondes, à une composante produite aléatoirement. Cette structure convient notamment lorsque vous préparez des références générées automatiquement et que vous souhaitez contrôler leur format dès la sortie.
Un ULID produit par l’outil est une chaîne de 26 caractères. Les 10 premiers caractères représentent la composante temporelle, tandis que les 16 suivants encodent 10 octets aléatoires avec un alphabet base32. La partie aléatoire de chaque valeur provient de la source de hasard du système d’exploitation.
Générer un ou plusieurs identifiants
- Ouvrez le générateur et repérez le réglage consacré au nombre d’identifiants à produire.
- Saisissez une valeur numérique correspondant au volume souhaité. Lorsque ce réglage n’est pas renseigné, le nombre appliqué est 1.
- Pour une génération individuelle, conservez cette valeur par défaut. Pour préparer un lot, indiquez le nombre voulu avant de lancer l’opération.
- Utilisez de préférence un nombre compris entre 1 et 100. Une valeur inférieure à 1 est remplacée par 1, alors qu’une valeur supérieure à 100 est remplacée par 100.
- Lancez la génération, puis examinez les informations affichées avec les identifiants.
Le réglage du volume doit rester numérique, car le traitement des chaînes, des valeurs nulles et des autres entrées non numériques n’est pas documenté. Pour savoir quel volume a réellement été retenu, consultez le nombre appliqué dans la sortie plutôt que de vous fier uniquement à la saisie initiale. Cette vérification est particulièrement utile si la valeur entrée se trouvait en dehors des bornes prévues.
Lire et vérifier la sortie
Après une génération réussie, la sortie contient les identifiants créés, le nombre effectivement appliqué, un horodatage et le premier identifiant présenté comme échantillon. Le nombre affiché permet donc de vérifier le volume retenu, y compris lorsque l’entrée a été corrigée pour respecter les bornes.
Pour contrôler la forme d’une valeur, comptez 26 caractères. La première partie en comporte 10 et correspond au temps en millisecondes ; la seconde en comporte 16 et provient de l’encodage de 10 octets aléatoires en base32. Ces éléments décrivent la composition de la chaîne, mais ne permettent pas d’affirmer que des valeurs issues d’appels distincts seront ordonnées entre elles ou garanties uniques à l’échelle mondiale.
Si une exception survient pendant le calcul, l’opération indique un échec et fournit le texte associé à cette exception. Dans ce cas, ne traitez pas la sortie comme une génération réussie et vérifiez les informations affichées avant de poursuivre.
Exemple pratique
Vous préparez trois références et choisissez de générer un lot de trois ULID.
Saisissez 3 dans le réglage du nombre, puis lancez la génération.
La sortie contient trois identifiants, le nombre appliqué 3, un horodatage et le premier identifiant comme échantillon ; chaque valeur possède 26 caractères.
Limites
- Le volume accepté est encadré de 1 à 100, et le comportement des entrées non numériques n’est pas documenté.
Erreurs fréquentes
- Une saisie inférieure à 1 ou supérieure à 100 est corrigée avant la génération ; entrez directement un nombre situé dans cette plage si vous attendez un volume précis.
Questions fréquentes
Combien d’ULID puis-je générer à la fois ?
Lorsque le réglage n’est pas renseigné, 1 identifiant est appliqué. Pour un lot, saisissez un nombre numérique situé entre 1 et 100 ; une valeur hors de cette plage est corrigée avant la génération.
Quelle longueur possède un ULID généré ?
Chaque valeur générée comporte 26 caractères : 10 caractères pour la composante temporelle, puis 16 caractères encodant 10 octets aléatoires avec un alphabet base32.
Que contient la sortie ?
En cas de réussite, la sortie réunit les identifiants, le nombre appliqué, un horodatage et le premier identifiant comme échantillon. Une exception pendant le calcul entraîne un échec accompagné du texte de l’exception.