Cómo generar identificadores ULID paso a paso
Introduce una cantidad numérica, genera el lote y comprueba la cantidad aplicada junto con los identificadores devueltos. Sin cantidad, se genera 1; los valores inferiores a 1 pasan a 1 y los superiores a 100 pasan a 100.
Qué hace el generador de ULID
Este generador sirve para crear identificadores ULID en formato de texto cuando necesitas uno o varios valores para una prueba, una carga de datos o una integración. Cada resultado combina un componente basado en el tiempo, medido en milisegundos, con otro componente generado de forma aleatoria.
Puedes usarlo tanto para una única generación como para solicitar un lote indicando la cantidad. Si no especificas esa cantidad, se aplica el valor predeterminado de 1.
Cómo generar uno o varios identificadores
- Abre el generador de ULID.
- Decide cuántos identificadores necesitas. Para una sola unidad, deja la cantidad sin cambiar o utiliza 1. Para un lote, introduce un valor numérico entre 1 y 100.
- Ejecuta la generación.
- Revisa los identificadores devueltos y la información asociada. La respuesta incluye los valores generados, la cantidad aplicada, una marca de tiempo y el primer identificador como muestra.
- Copia los valores que necesites para tu prueba o proceso. Cada identificador tiene 26 caracteres: 10 corresponden al componente temporal y 16 al componente codificado a partir de 10 bytes aleatorios mediante un alfabeto base32.
Si introduces un número inferior a 1, se sustituye por 1 antes de generar los valores. Si introduces un número superior a 100, se sustituye por 100. Por tanto, comprueba la cantidad aplicada en la respuesta cuando el valor solicitado queda fuera de ese intervalo.
La información revisada solo cubre la ruta de cantidad numérica. No des por hecho un comportamiento concreto para texto, valores nulos u otros tipos de entrada.
Cómo interpretar el resultado
Un resultado correcto contiene una colección de identificadores y datos de contexto: la cantidad que se aplicó, una marca de tiempo y el primer valor como muestra. Comprueba que cada cadena tenga 26 caracteres si vas a validarla antes de incorporarla a otro proceso.
El componente aleatorio procede de la fuente de aleatoriedad del sistema operativo. Esto describe cómo se obtiene esa parte del identificador, pero no permite afirmar que los valores sean globalmente únicos, que queden ordenados entre llamadas separadas o que cumplan un estándar externo.
Si se produce una excepción durante el cálculo, la operación informa del fallo e incluye el texto de la excepción. En ese caso, no trates la respuesta como un lote válido: revisa la entrada numérica admitida y vuelve a intentarlo.
Ejemplo práctico
Una persona prepara cinco identificadores ULID para probar una importación de registros y quiere verificar la forma de la respuesta antes de usar los valores.
En una prueba de importación que necesita cinco registros, introduce la cantidad numérica 5 y ejecuta la generación. Después, comprueba que la cantidad aplicada sea 5 y que cada valor devuelto tenga 26 caracteres.
La respuesta debe contener una colección de 5 identificadores de 26 caracteres, la cantidad aplicada con valor 5, una marca de tiempo y el primer identificador como muestra.
Limitaciones
- La información disponible no permite presentar los identificadores como globalmente únicos, ordenados entre llamadas separadas ni conformes con un estándar externo. La ruta documentada solo cubre una cantidad numérica; no se ha establecido el comportamiento para texto, valores nulos u otros tipos.
Errores frecuentes
- Pedir una cantidad fuera del intervalo admitido puede hacer que se aplique 1 o 100 en lugar del valor previsto. Corrige la cantidad y verifica el valor aplicado en la respuesta; no dependas de entradas de texto, nulas u otros tipos cuyo comportamiento no está documentado.
Preguntas frecuentes
¿Cuántos identificadores genera si dejo la cantidad vacía?
Si no indicas una cantidad, se aplica 1 y se devuelve un identificador junto con la cantidad aplicada, una marca de tiempo y el primer valor como muestra.
¿Qué ocurre si solicito menos de 1 o más de 100 ULID?
Cuando la cantidad es numérica y está por debajo de 1, se sustituye por 1; cuando supera 100, se sustituye por 100. Comprueba la cantidad aplicada en la respuesta.
¿Qué longitud tiene cada identificador generado?
Cada identificador tiene 26 caracteres: 10 del componente temporal y 16 del componente codificado a partir de 10 bytes aleatorios con un alfabeto base32.