Como gerar um UUID (v4, v7 e qual escolher)
Gere UUID e GUID online: v4 aleatório, v7 ordenado por tempo e mais. O que significam os 36 caracteres, quão improvável é uma colisão e qual formato escolher.
Atualizado em 4 de novembro de 20269 min de leitura
Para gerar um UUID, abra o gerador de UUID, deixe a versão em v4 aleatória, escolha quantos quer e toque no botão de gerar. Você recebe valores como 550e8400-e29b-41d4-a716-446655440000, prontos para copiar. Um UUID, chamado de GUID no Windows e no SQL Server, é um rótulo de 128 bits que você pode criar em qualquer dispositivo sem consultar um servidor central e que tem tão pouca chance de se repetir que pode ser tratado como único. Este guia explica o que significam os 36 caracteres, qual versão escolher, quão confiável é de fato a unicidade e como obter o formato que seu banco de dados ou seu código espera.
O que é um UUID e por que as pessoas o usam
UUID significa identificador único universal. Ele serve para dar nome a um registro, um arquivo, um pedido ou um usuário sem precisar de um contador. Um contador exige um único lugar que entregue o próximo número, e esse lugar vira um gargalo ou um ponto de falha. Com UUIDs, cada celular, servidor e script pode inventar seus próprios identificadores ao mesmo tempo, sem que ninguém precise se coordenar.
GUID quer dizer a mesma coisa. A Microsoft usou a palavra primeiro e ela continua sendo o nome no .NET, no SQL Server e no registro do Windows. Na prática, GUID e UUID são os mesmos 128 bits, e a única diferença visível às vezes é estar em maiúsculas ou entre chaves.
A anatomia dos 36 caracteres
Pegue 550e8400-e29b-41d4-a716-446655440000. São 32 dígitos hexadecimais (de 0 a 9 e de a a f) mais quatro hífens, o que dá 36 caracteres. Os hífens servem só para facilitar a leitura. O valor real são os 32 dígitos, ou seja, 128 bits ou 16 bytes. Os grupos sempre têm 8, 4, 4, 4 e 12 dígitos.
| Grupo | Tamanho | O que contém |
|---|---|---|
| 550e8400 | 8 dígitos | Na v7, a primeira parte do carimbo de tempo; na v4, bits aleatórios |
| e29b | 4 dígitos | Mais carimbo de tempo (v7) ou bits aleatórios (v4) |
| 41d4 | 4 dígitos | Começa com o dígito da versão: o 4 aqui indica a versão 4 |
| a716 | 4 dígitos | Começa com os bits da variante; 8, 9, a ou b indica o formato padrão |
| 446655440000 | 12 dígitos | Em sua maioria aleatórios na v4 e na v7 |
Dois detalhes valem a pena. O primeiro dígito do terceiro grupo é a versão, então dá para distinguir uma v4 de uma v7 a olho nu. O primeiro dígito do quarto grupo é sempre 8, 9, a ou b num identificador padrão. Se aparecer outra coisa, o valor não é um UUID padrão da RFC, mesmo parecendo; os GUIDs COM da Microsoft são o exemplo mais comum. O modo Verificar da ferramenta aponta isso como fora do padrão, e não como inválido.
Como gerar UUIDs, passo a passo
Abra o gerador e escolha uma versão
No gerador de UUID, o Modo é Gerar por padrão. Em Versão, escolha v4 aleatória para um identificador simples, ou v7 ordenada se o valor for virar chave de banco de dados.
Defina quantos
Digite um número em Quantos ou use uma predefinição. O plano grátis dá até 100 por toque, o suficiente para dados de teste e algumas chaves.
Escolha a aparência
Mude Maiúsculas e minúsculas para MAIÚSCULAS, desative Manter os hífenes para a forma compacta de 32 caracteres, ou ponha o Invólucro em {chavetas} ou urn:uuid:. Isso só muda a exibição, então nada é gerado de novo.
Gere e copie
Toque no botão de gerar e depois em Copiar ao lado de um valor ou em Copiar tudo para o lote inteiro. Tudo é criado no seu dispositivo, não nos nossos servidores.
Exporte se precisar de um arquivo
Em Formato de exportação escolha Um por linha, Separado por vírgulas, Array JSON, CSV ou Base64 e baixe a lista.
Crie v4, v7 e mais seis tipos, em qualquer formato. Grátis: 100 UUIDs por toque, com todas as versões, formatos e tipos de exportação incluídos. Pro: até um milhão de uma vez. Tudo roda no seu dispositivo, não nos nossos servidores.
Gerar UUIDsQual versão escolher?
A ferramenta oferece oito tipos. A maioria das pessoas só precisa dos dois primeiros.
| Tipo | O que contém | Use quando |
|---|---|---|
| v4 aleatória | 122 bits aleatórios | Você só precisa de um id único e não há outra regra |
| v7 ordenada | Um carimbo de tempo em milissegundos e depois bits aleatórios | O id vai ser chave primária de banco de dados ou deve ordenar por criação |
| v1 temporal | Um carimbo de tempo, sequência de relógio e nó | Um sistema antigo já espera v1 |
| v6 ordenável | Os campos da v1 em ordem ordenável | Você precisa manter dados no estilo v1, mas quer ordenar |
| v3 nome (MD5) | Um hash de um espaço de nomes e de um nome | Você precisa sempre do mesmo id para o mesmo nome; mantida por compatibilidade |
| v5 nome (SHA-1) | A mesma ideia com SHA-1 | O mesmo, para trabalho novo |
| Nil e Max | Tudo zeros, tudo f | Um marcador para «sem valor», ou um limite superior |
Para um banco de dados, a v7 costuma ser melhor que a v4. Um valor v7 começa pelo horário, então as linhas novas caem no fim do índice. As chaves v4 aleatórias caem em qualquer lugar, e numa tabela grande isso faz o banco trabalhar mais a cada inserção. Se você só etiqueta coisas e nunca ordena pelo id, a v4 basta e é mais simples. A versão 2 e a versão 8 não são geradas por esta ferramenta.
As versões 3 e 5 funcionam de outro jeito: você cola uma lista de nomes, um por linha, escolhe um espaço de nomes como DNS ou URL, e cada nome sempre gera o mesmo identificador. Isso ajuda a conciliar registros entre sistemas que nunca compartilham um banco. A quantidade vem da sua lista, e o limite grátis de 100 também vale para ela.
Qual a chance de uma colisão?
Um UUID v4 tem 122 bits aleatórios, ou seja, cerca de 5,3 seguido de 36 zeros de valores possíveis. Números assim não parecem reais, então aqui vão duas comparações. Para ter uma chance em um bilhão de que ao menos um valor se repita, seria preciso gerar cerca de 100 trilhões de UUIDs. Para chegar a 50 por cento, seriam necessários uns 2,7 quintilhões, o que, a um bilhão por segundo, dá mais de oito décadas de trabalho sem parar.
Um valor v7 mantém 74 bits aleatórios, porque o resto é ocupado pelo carimbo de tempo e pela versão. É bem menos que 122, mas continua muito além de qualquer risco realista, principalmente porque dois valores v7 criados em milissegundos diferentes nunca podem coincidir. As versões 3 e 5 foram feitas para se repetir com a mesma entrada, então ali uma coincidência é a função, não uma falha.
Na prática, uma colisão quase nunca vem da matemática. Ela vem de uma fonte aleatória fraca, de um valor copiado duas vezes sem querer ou de dois sistemas que normalizam as maiúsculas de formas diferentes. A ferramenta usa o gerador aleatório criptográfico do dispositivo, não uma função pseudoaleatória simples.
Formatos: maiúsculas, sem hífens, chaves
A forma padrão é em minúsculas e com hífens, e o software deve comparar UUIDs sem diferenciar maiúsculas de minúsculas. Ainda assim, cada sistema os escreve de um jeito, e a ferramenta deixa você acertar o destino. Esses ajustes são grátis em todas as versões.
| Ajuste | Resultado de exemplo | Onde costuma aparecer |
|---|---|---|
| Sem invólucro, minúsculas | 550e8400-e29b-41d4-a716-446655440000 | A maioria das APIs, JSON e bancos de dados |
| MAIÚSCULAS | 550E8400-E29B-41D4-A716-446655440000 | Ferramentas do Windows e alguns documentos antigos |
| Manter os hífenes desativado | 550e8400e29b41d4a716446655440000 | Colunas compactas de 32 caracteres e nomes de arquivo |
| {chavetas} | {550e8400-e29b-41d4-a716-446655440000} | SQL Server e a notação de GUID do Windows |
| urn:uuid: | urn:uuid:550e8400-e29b-41d4-a716-446655440000 | Lugares que pedem a forma de URI |
Se dois dos seus sistemas guardam o mesmo id em formas diferentes, uma comparação de texto dirá que são distintos. Escolha uma única forma na fronteira e converta na entrada. Se um id precisa viajar como texto dentro de um endereço ou mensagem, veja o que é a codificação Base64, a outra forma comum de transformar dados em caracteres seguros.
Listas grandes e como verificar ids que você já tem
O plano grátis gera até 100 identificadores por toque, e você pode tocar de novo quantas vezes quiser. O Pro eleva um lote para até um milhão. Só os primeiros 200 valores aparecem na tela, para que um lote grande continue rápido, mas Copiar tudo e o download sempre incluem todos os valores.
Mude o Modo para Verificar para inspecionar valores que você já tem. Cole uma coluna, um trecho de log ou um corpo JSON, ou solte um arquivo .txt, .csv, .json, .log, .tsv ou .ndjson de até 10 MB. Cada valor é informado com sua versão, sua variante e seu formato. Em v1, v6 e v7 o horário de criação também é decodificado, um jeito rápido de saber quando um registro foi criado se ninguém guardou a data. Os duplicados da lista são contados, e você pode baixar o relatório em CSV. Para limpar uma lista de linhas repetidas, use o removedor de duplicados de texto.
O que um UUID não é
Um UUID é um identificador, não uma senha. Ele vai parar em endereços da web, logs e relatórios de erro, e as versões v1, v6 e v7 ainda dizem quando foram criadas. Sempre verifique se quem pede um registro tem permissão para vê-lo. Não conte com o id ser difícil de adivinhar.
As versões 3 e 5 se baseiam em MD5 e SHA-1, que não são seguros como hashes de segurança. Servem para nomear, não para proteger. Se você quer uma impressão digital de um arquivo ou de um texto, use o gerador de hash. Um UUID também ocupa mais espaço que um inteiro pequeno: 16 bytes numa coluna nativa, 36 como texto. Guarde-o numa coluna UUID nativa ou binária se o seu banco tiver uma.
Perguntas frequentes
Como gerar um UUID online?
Abra o gerador de UUID, deixe a versão em v4 aleatória, defina Quantos e toque no botão de gerar. Copie um valor ou o lote inteiro. O plano grátis cobre até 100 por toque e tudo roda no seu dispositivo.
Qual a diferença entre UUID e GUID?
Nenhuma que importe. GUID é o nome que a Microsoft dá ao mesmo identificador de 128 bits. A diferença visível costuma ser que GUIDs aparecem em maiúsculas ou entre chaves, e a ferramenta gera as duas formas.
Devo usar UUID v4 ou v7?
Use v4 quando só precisa de um rótulo único. Use v7 para chaves primárias de banco de dados, porque os valores começam pelo horário e se ordenam por criação, o que mantém as inserções no fim do índice.
Dois UUIDs podem ser iguais?
Em teoria sim, na prática quase nunca. Com a v4 seriam necessários cerca de 100 trilhões de valores para ter uma chance em um bilhão de repetição. Os problemas reais vêm de fontes aleatórias fracas ou de um valor copiado duas vezes.
Como fazer um UUID sem hífens ou em maiúsculas?
Desative Manter os hífenes para a forma compacta de 32 caracteres e mude Maiúsculas e minúsculas para MAIÚSCULAS. Também dá para envolver os valores em {chavetas} ou urn:uuid:. Isso só muda como o valor é exibido.
Posso usar um UUID como senha ou token secreto?
Não. Um UUID é um identificador. Ele aparece em links e logs, e algumas versões trazem o horário de criação. Verifique as permissões a cada requisição em vez de confiar num id difícil de adivinhar.