Como gerar identificadores ULID

Visão geral

O ULID Generator serve para criar identificadores em formato de texto para registos, eventos ou outros elementos que precisem de um valor gerado automaticamente. Cada resultado combina uma componente temporal, medida em milissegundos, com uma componente aleatória obtida a partir da aleatoriedade do sistema operativo. Assim, pode pedir um identificador ou um conjunto numerado de identificadores numa só operação.

A ferramenta gera cada valor com 26 caracteres: os primeiros 10 correspondem à componente temporal e os 16 seguintes correspondem a 10 bytes aleatórios codificados com um alfabeto base32. Esta estrutura ajuda a reconhecer a forma do resultado, mas não permite concluir que os valores sejam globalmente únicos, que fiquem ordenados entre chamadas separadas ou que cumpram uma norma externa.

Passos

1. Abra o gerador e localize o campo destinado à quantidade de identificadores.
2. Para obter um só valor, deixe esse campo vazio, se a interface o permitir, ou use o valor numérico 1. A quantidade opcional assume 1 por predefinição.
3. Para obter vários valores, introduza uma quantidade numérica entre 1 e 100. Se indicar um número inferior a 1, a operação aplica 1; se indicar um número superior a 100, aplica 100 antes de gerar os valores.
4. Inicie a operação de geração.
5. Reveja a lista devolvida e confirme a quantidade aplicada. Guarde apenas os identificadores de que precisa e mantenha a sua utilização separada de credenciais ou segredos.

Use o percurso numérico para a quantidade. O comportamento de entradas como texto, valores nulos ou outros tipos não numéricos não está estabelecido, pelo que não deve basear o procedimento nesses formatos. Se a operação encontrar uma exceção durante o cálculo, o resultado assinala a falha e inclui o texto dessa exceção.

Interpretação do resultado

Num resultado bem-sucedido, procure os identificadores gerados, a quantidade aplicada, uma marca temporal e o primeiro identificador como amostra. A quantidade aplicada é particularmente útil quando o valor introduzido ficou fora do intervalo permitido, porque mostra qual foi o número usado na geração.

Para validar rapidamente a forma de um identificador, conte 26 caracteres. Os 10 iniciais representam o componente temporal em milissegundos; os 16 restantes representam o componente aleatório codificado a partir de 10 bytes aleatórios com base32. O componente aleatório provém da aleatoriedade do sistema operativo.

Esta informação descreve o formato e o processo de geração, não uma garantia de unicidade global, de ordenação entre chamadas independentes ou de conformidade com uma norma externa. A capacidade documentada também declara acesso à rede como falso, mas essa declaração não permite concluir onde a ferramenta é executada nem como os dados são conservados. Se surgir uma falha, leia o texto da exceção para identificar o problema, em vez de tratar a resposta como uma lista válida de identificadores.

Exemplo prático

Para preparar quatro identificadores para novos registos, introduza 4 no campo de quantidade e execute a geração.

Introduza a quantidade numérica 4 e inicie a geração. Depois, confirme a quantidade aplicada e valide o comprimento dos valores apresentados.

O resultado deve apresentar 4 identificadores, a quantidade aplicada como 4, uma marca temporal e o primeiro identificador como amostra; cada identificador deve ter 26 caracteres.

Limitações

• A declaração de acesso à rede como falso não informa se a ferramenta é local, alojada ou executada no navegador, nem estabelece garantias sobre armazenamento, conservação ou privacidade. Também não é possível inferir unicidade global, ordenação entre chamadas separadas ou conformidade com uma norma externa.

Erros comuns

• Introduzir uma quantidade fora do intervalo de 1 a 100 pode levar a uma quantidade aplicada diferente da pretendida. Use um número dentro desse intervalo e confirme a quantidade aplicada no resultado.

Perguntas frequentes

Quantos identificadores posso gerar de uma vez?

A quantidade opcional assume 1 quando não é indicada. Pode pedir uma quantidade numérica até 100; valores abaixo de 1 são substituídos por 1 e valores acima de 100 por 100.

Que formato tem cada identificador gerado?

Cada identificador tem 26 caracteres. Os 10 primeiros pertencem à componente temporal e os 16 seguintes à componente aleatória codificada com um alfabeto base32 a partir de 10 bytes aleatórios.

O gerador precisa de acesso à rede?

A capacidade documentada declara acesso à rede como falso. Essa informação não determina onde a ferramenta é executada nem estabelece regras sobre armazenamento ou conservação dos dados.