Gerador de UUID

Um UUID é um identificador de 128 bits escrito como 32 dígitos hexadecimais divididos em cinco grupos, como 3f2504e0-4f89-41d3-9a0c-0305e82c3301. A versão 4 preenche 122 desses bits com dados aleatórios, o que torna as colisões tão improváveis que sistemas independentes podem criar IDs sem nenhuma coordenação. Esta ferramenta os gera em lotes usando a fonte de aleatoriedade criptográfica do navegador.

Como funciona

Informe uma quantidade de 1 a 50 e a ferramenta chama crypto.randomUUID() uma vez para cada identificador. Essa função faz parte da Web Crypto API e obtém seus valores do gerador de números aleatórios do sistema operacional, não de Math.random. O resultado segue a RFC 9562 (que substitui a RFC 4122): o terceiro grupo começa com 4 para marcar a versão, e o quarto começa com 8, 9, a ou b para marcar a variante. Todo o resto é aleatório. As letras ficam em minúsculas, que é a forma canônica; ainda assim, quem consome os valores deve compará-los sem diferenciar maiúsculas de minúsculas.

Clique em Gerar novamente para obter um lote novo. Cada linha tem seu próprio botão de copiar, e Copiar tudo coloca o lote inteiro na área de transferência, um por linha, pronto para uma planilha, um arquivo de fixtures ou uma lista IN de SQL. Nada é enviado a um servidor, e nenhum identificador fica guardado depois que você sai da página.

O lote é gerado depois que a página carrega, e não durante a renderização no servidor, então os IDs que você vê foram produzidos no seu dispositivo.

Até que ponto são únicos?

Com 122 bits aleatórios, existem cerca de 5,3 × 10³⁶ valores possíveis. A probabilidade de qualquer colisão entre n identificadores é aproximadamente n² ÷ 2¹²³. Seria preciso gerar em torno de 2,7 × 10¹⁸ UUIDs para que a chance de uma única duplicata chegasse a 50%; a um bilhão por segundo, isso levaria mais de 85 anos. Na prática, uma duplicata indica um bug (uma linha de banco de dados copiada, um valor em cache, uma fonte de aleatoriedade com defeito), e não azar.

Essa garantia depende da qualidade da aleatoriedade, e é por isso que a ferramenta usa o gerador criptográfico. As versões derivadas de um endereço MAC e de um relógio (versão 1) ou do hash de um nome (versões 3 e 5) fazem outras concessões e não estão disponíveis aqui.

UUIDs como chaves de banco de dados

UUIDs aleatórios são chaves primárias práticas: clientes podem criar registros offline, serviços podem mesclar dados sem renumerar nada, e um ID não revela quantas linhas existem. O preço é a localidade do índice. Cada nova chave aleatória cai em uma posição arbitrária de uma B-tree, então as inserções mexem em páginas espalhadas por todo o índice e a eficiência do cache cai em comparação com um inteiro autoincrementado. No PostgreSQL, armazene-os no tipo nativo uuid (16 bytes), e não como uma string de 36 caracteres; no MySQL, considere o formato BINARY(16) pelo mesmo motivo.

Se a ordem de inserção importa em grande escala, a versão 7, mais recente, coloca um timestamp em milissegundos nos bits iniciais, de modo que as chaves ficam quase sempre sequenciais e continuam únicas sem coordenação. Os navegadores ainda não oferecem uma função nativa para ela, então ela é gerada no código da aplicação ou pelo banco de dados.

Não use um UUID como segredo. Os valores da versão 4 são imprevisíveis, mas aparecem em URLs, logs e cabeçalhos Referer, e "ID impossível de adivinhar" não é controle de acesso. Use-os para identificar e trate a autorização separadamente.

Equivalente na linha de comando

A maioria dos sistemas já vem com um gerador:

uuidgen                                  # Linux (util-linux) and macOS
python3 -c 'import uuid; print(uuid.uuid4())'

No Linux, uuidgen -r força explicitamente a versão aleatória, e cat /proc/sys/kernel/random/uuid funciona sem instalar nenhum pacote.

Saiba mais

Escolher entre chaves naturais, chaves substitutas inteiras e UUIDs é uma decisão de modelagem de schema com consequências duradouras; projeto de banco de dados e normalização apresenta os prós e contras, e índices e planos de execução mostra na prática o que chaves aleatórias fazem com um índice. Para valores que precisam ser secretos, e não apenas únicos, use o gerador de senhas.