Como gerar UUID v1, v4 ou v5

Quando usar o gerador de UUID

O UUID Generator cria um ou vários identificadores UUID em formato de texto. Pode selecionar v1, v4 ou v5, definir quantos resultados pretende obter e escolher se as letras do texto devem aparecer em maiúsculas. Esta combinação é útil quando está a preparar registos, pedidos ou dados de teste e precisa de uma quantidade controlada de identificadores. Se não indicar uma versão, é usada a seleção v4; se não indicar uma quantidade, é produzido um resultado.

Passos para gerar os identificadores

Abra o gerador e observe os controlos disponíveis para a versão, a quantidade e a apresentação dos resultados, identificando os campos correspondentes a cada uma dessas funções.
Selecione v1, v4 ou v5, de acordo com a utilização que pretende dar ao resultado. Se deixar a versão sem indicação, a escolha predefinida é v4. A opção v4 utiliza uma operação de geração aleatória, enquanto a opção v5 funciona com entradas fixas no comportamento disponível.
Defina a quantidade de UUID, caso precise de mais do que um. Quando o valor é convertido com sucesso para um número inteiro, o resultado fica limitado ao intervalo de 1 a 100: valores abaixo do mínimo passam para 1 e valores acima do máximo passam para 100. Se ocorrer um erro de valor ou de tipo durante essa conversão, é usada a quantidade 1. A ausência do campo também conduz à geração de um único resultado.
Ative a opção de maiúsculas se quiser que as letras presentes no texto de cada UUID sejam convertidas para esse formato. Deixe-a desativada quando preferir a representação textual sem essa conversão. Esta escolha afeta a forma apresentada, não a quantidade solicitada.
Inicie a geração depois de rever a versão, a quantidade e a apresentação escolhidas. Se tiver pedido vários valores, conte os resultados devolvidos e compare esse número com a quantidade normalizada. Se o valor fornecido tiver sido ajustado por estar fora do intervalo ou por não permitir conversão, a quantidade apresentada pode não coincidir com o texto que introduziu.
Para uma utilização v5, tenha em conta que os parâmetros expostos não incluem campos para fornecer um namespace, um nome ou outros valores de geração. Assim, não tente procurar esses dados nos controlos disponíveis. Para uma utilização v4, selecione essa versão quando o comportamento aleatório for o que pretende usar.

Leitura e verificação do resultado

Os resultados são devolvidos como texto, pelo que pode ler ou copiar cada valor como uma sequência textual. Na representação textual predefinida testada, cada UUID tem 36 caracteres; com a opção de maiúsculas ativa, as letras dessa representação aparecem em maiúsculas. Os algarismos mantêm a sua forma, uma vez que não têm distinção entre minúsculas e maiúsculas.

A quantidade final deve ser interpretada depois da conversão e dos limites aplicados. Por exemplo, um valor convertido para 0 não conduz a zero resultados, porque o mínimo usado é 1, enquanto um valor superior a 100 fica limitado a 100. Um conteúdo que não possa ser convertido por erro de valor ou de tipo recua para 1. Estas regras ajudam a explicar uma diferença entre a quantidade introduzida e o número devolvido.

A versão selecionada também dá contexto ao resultado. v4 corresponde à operação aleatória disponível, v1 é uma das seleções fornecidas e v5 usa entradas fixas no funcionamento exposto. A ferramenta não apresenta campos para personalizar namespace ou nome em v5, por isso o resultado dessa seleção não deve ser interpretado como uma geração baseada em valores fornecidos por si.

Exemplo prático

Uma pessoa precisa de três identificadores para preparar registos de teste e pretende recebê-los em texto com letras maiúsculas.

Selecione v4, introduza 3 na quantidade e ative a apresentação em maiúsculas antes de iniciar a geração.

São devolvidos 3 valores em texto, cada um com 36 caracteres na representação textual testada, apresentados em maiúsculas; os valores concretos não são antecipados.

Limitações

Na seleção v5, o funcionamento disponível usa entradas fixas e não oferece campos para inserir um namespace ou um nome.

Erros comuns

Uma quantidade que não possa ser convertida para inteiro faz com que seja usada a quantidade 1; introduza um valor convertível e confirme o número de resultados depois da geração.

Perguntas frequentes

Posso gerar vários UUID de uma vez?

Quando a quantidade for convertida com sucesso, pode pedir entre 1 e 100 resultados; se a conversão falhar, é usada a quantidade 1.

É possível obter UUID em maiúsculas?

Quando a opção de maiúsculas estiver ativa, as letras do texto de cada UUID são convertidas para maiúsculas; sem essa opção, o texto não é convertido.

Posso fornecer um namespace e um nome para gerar um UUID v5?

Quando selecionar v5, o funcionamento disponível usa entradas fixas e não expõe parâmetros para fornecer um namespace ou um nome.