Gerador e validador de UUID

Gere UUIDs aleatórios (v4) ou ordenados por tempo (v7) para chaves de banco de dados e copie ou baixe. Cole um UUID abaixo para ver a versão e a data.

Versão
Formato


Analisar um UUID

A versão, a variante e a data de criação (v1, v6, v7) aparecem aqui.

Como usar

  1. Escolha Versão 4 para identificadores aleatórios comuns, ou Versão 7 para chaves de banco de dados que ficam em ordem de criação.
  2. Informe a quantidade (1 a 1000) e o formato: maiúsculas, sem hifens ou entre chaves, como um GUID do Windows.
  3. Toque em Copiar ou Baixar .txt. Toque em Gerar novos para trocar todos.
  4. Para analisar um UUID, cole-o em Analisar um UUID. A versão, a variante e a data de criação (em v1, v6 e v7) aparecem na hora.

Versões de UUID comparadas

Um UUID (Universally Unique Identifier) é um número de 128 bits escrito como 32 dígitos hexadecimais em cinco grupos, por exemplo 017f22e2-79b0-7cc3-98c4-dc0c0c07398f. O primeiro dígito do terceiro grupo (aqui, 7) é a versão, e os bits mais altos do quarto grupo são a variante. A norma atual é o RFC 9562 (maio de 2024), que substituiu o RFC 4122 e acrescentou as versões 6, 7 e 8.

VersãoConteúdoOrdem por tempoObservações
1Tempo (passos de 100 ns desde 15 out. 1582) + nóNãoO nó costuma ser o endereço MAC
3MD5 de namespace + nomeNãoMesmo nome, mesmo UUID
4122 bits aleatóriosNãoA mais comum
5SHA-1 de namespace + nomeNãoPreferível à v3
6Tempo da v1, começando pela parte mais significativaSimPara sistemas que já usam v1
7Milissegundos Unix (48 bits) + 74 bits aleatóriosSimA escolha do RFC 9562 para dados novos
8Formato livre do fornecedorDependePara necessidades especiais

A versão 2 (DCE Security) é reservada e quase não é usada. Existem ainda dois valores especiais: o UUID nulo (Nil, todos os bits 0) e o UUID máximo (Max, todos os bits 1).

Qual a chance de dois UUIDs v4 serem iguais?

Um UUID v4 tem 122 bits aleatórios; os outros 6 guardam a versão e a variante. Isso dá 2122, cerca de 5,3 × 1036, valores possíveis. Pelo paradoxo do aniversário, a probabilidade de dois entre n UUIDs serem iguais é de aproximadamente n² ÷ (2 × 2122). Para 1 bilhão de UUIDs: (109)² ÷ (1,06 × 1037) ≈ 9,4 × 10-20. Uma chance de 50% só aparece por volta de 2,7 × 1018 UUIDs, o que equivale a gerar 1 bilhão por segundo durante 86 anos.

Essa conta só vale se a fonte aleatória for boa. Esta ferramenta usa apenas crypto.getRandomValues, o gerador aleatório criptográfico do navegador. UUIDs feitos com Math.random não atendem a esse requisito.

Por que a v7 é uma boa chave de banco de dados

Índices B-tree, usados pelo MySQL, pelo PostgreSQL e pela maioria dos bancos de dados, guardam as chaves em ordem. UUIDs v4 caem em posições aleatórias do índice, então as páginas se dividem com frequência e o cache rende menos. O RFC 9562 cita esse problema de localidade do índice entre os motivos das novas versões. Um UUID v7 começa pela hora em milissegundos, então cada linha nova vai para o fim do índice, como um autoincremento, e mesmo assim a aplicação cria a chave sem consultar o banco.

Aqui os 12 bits depois do carimbo de tempo são um contador (método 1 do RFC 9562, seção 6.2). Ele sobe de um em um a cada UUID do mesmo milissegundo, então 1000 UUIDs gerados de uma vez saem em ordem. A contrapartida é que um UUID v7 revela quando foi criado: qualquer pessoa pode ler a data com o analisador acima. Se a data de criação precisa ficar privada, use v4.

Perguntas frequentes

Esses UUIDs são realmente únicos?
Não existe garantia absoluta, mas a chance de colisão é mínima: cerca de 1 em 1019 para 1 bilhão de UUIDs v4. Eles são criados no seu navegador com um gerador aleatório criptográfico, não vêm de uma lista em um servidor e não são guardados por nós.
Qual a diferença entre UUID e GUID?
GUID é o nome que a Microsoft usa para a mesma coisa: um número de 128 bits no mesmo formato. Ferramentas do Windows e o Visual Studio costumam escrevê-lo em maiúsculas e entre chaves, como {919108F7-52D1-4320-9BAC-F847DB4148A8}. Marque Maiúsculas e Chaves para obter esse formato.
Devo usar v4 ou v7?
Para chave primária de banco de dados, v7: fica em ordem de tempo e o índice continua compacto. Para identificadores que não podem revelar quando foram criados, como os que aparecem em URLs públicas, v4.
Posso usar um UUID como token secreto?
Melhor não. A seção 8 do RFC 9562 diz que não se deve presumir que UUIDs são difíceis de adivinhar e que eles não devem ser usados como identificadores cuja simples posse dá acesso. Para tokens de login ou links de redefinição de senha, use um token aleatório próprio de pelo menos 128 bits.
Dá para ler a data de criação de um UUID?
Sim, nas versões 1, 6 e 7. Cole o UUID em Analisar um UUID. As versões 1 e 6 guardam o tempo em passos de 100 nanossegundos desde 15 de outubro de 1582; a versão 7, em milissegundos desde 1º de janeiro de 1970. As versões 3, 4 e 5 não contêm data.
O que significa a variante no resultado?
A variante diz como ler os demais bits. Quase todo UUID moderno tem a variante do RFC 9562 (bits 10). As outras vêm de sistemas antigos: NCS (bit 0) e os antigos GUIDs COM da Microsoft (bits 110). UUIDs com variante diferente da do RFC não têm um número de versão com significado.