Sobre o gerador de UUID
Este gerador de UUID gratuito cria UUIDs de versão 4 aleatórios (também chamados de GUIDs) — identificadores universalmente únicos usados em bancos de dados, APIs, arquivos de log e sistemas distribuídos. Gere um ou um lote inteiro e copie-os com um clique.
Eles são gerados no seu navegador usando crypto.getRandomValues, a mesma fonte aleatória criptograficamente segura usada para chaves de criptografia. Nada é solicitado a um servidor, portanto cada UUID que você vê aqui nunca existiu em nenhum outro lugar.
O que é um UUID
Um UUID é um número de 128 bits, escrito como 32 dígitos hexadecimais em cinco grupos separados por hifens:
f47ac10b-58cc-4372-a567-0e02b2c3d479
O agrupamento é 8-4-4-4-12, e o comprimento total é sempre de 36 caracteres, incluindo os hifens.
A razão de ser dele é gerar um identificador único sem precisar perguntar a ninguém. Um banco de dados pode distribuir 1, 2, 3… porque é a única autoridade sobre o que vem a seguir. Mas quando dois telefones criam registros off-line, ou doze servidores inserem linhas ao mesmo tempo, ou você precisa de um identificador *antes* de a linha existir, não há autoridade a quem perguntar. Um UUID resolve isso sendo tão grande e tão aleatório que uma colisão não merece sequer ser pensada.
A versão 4 e os dois dígitos que a denunciam
Existem várias versões de UUID. A versão 4 é a aleatória, e é o que quase todo mundo quer dizer com "um UUID".
Você pode ler a versão diretamente na string. Em f47ac10b-58cc-4372-a567-0e02b2c3d479:
- O primeiro dígito do terceiro grupo é a versão — aqui, um 4
- O primeiro dígito do quarto grupo é a variante — sempre 8, 9, a ou b
Essas duas posições são fixas, o que deixa 122 bits de aleatoriedade real em vez de 128.
As outras versões que você pode encontrar: a v1 codifica o carimbo de data/hora e o endereço MAC da máquina, o que a torna ordenável mas revela onde e quando foi criada. A v7, padronizada em 2024, é a resposta moderna — um carimbo de data/hora na frente e a aleatoriedade depois, de modo que os identificadores se ordenam por data de criação sem revelar detalhes de hardware. Se você está escolhendo hoje e a ordenação no banco de dados importa, vale a pena conhecer a v7.
Eles são mesmo únicos?
Não é garantido, mas os números são absurdos o bastante para que isso não importe.
122 bits aleatórios dão cerca de 5,3 × 10³⁶ valores possíveis. Para chegar a uma chance de 50% de uma única colisão, seria preciso gerar aproximadamente 2,7 × 10¹⁸ UUIDs — 2,7 quintilhões.
Em termos concretos: gerando um bilhão de UUIDs por segundo, levaria cerca de 85 anos para alcançar 50% de chance de uma única duplicata no conjunto inteiro. Para qualquer aplicação real, o risco é menor do que o de o seu armazenamento corromper o valor silenciosamente.
A única ressalva verdadeira é a qualidade da aleatoriedade. Um UUID vindo de uma fonte aleatória fraca não é único da forma que a matemática promete — já houve falhas reais em que um gerador previsível produziu repetições. Esta ferramenta usa o gerador criptográfico do navegador, não Math.random().
Um UUID não é um segredo
Vale dizer isso com clareza, porque o erro acontece nas duas direções.
Um UUID v4 é imprevisível, então é razoável usá-lo como URL impossível de adivinhar — um link de compartilhamento ou um token de redefinição de senha. Mas ele não foi projetado como primitiva de segurança, não carrega prazo de validade, e frequentemente acaba em logs, caches, ferramentas de análise e colado em conversas. Trate-o como um identificador que por acaso é difícil de adivinhar, não como uma credencial.
E o inverso: não presuma que um UUID esconde alguma coisa. Um UUID v1 contém um carimbo de data/hora e um endereço MAC à vista de todos. Se você herdou identificadores de algum lugar e eles começam com a versão 1, eles estão contando a quem os ler quando e onde foram criados.
Onde você vai usá-los
- Chaves primárias de banco de dados — especialmente quando as linhas são criadas em várias máquinas ao mesmo tempo
- Aplicativos offline-first — um telefone pode criar registros sem conexão e sincronizar depois sem renumerar
- IDs de requisições de API — rastrear uma única requisição por muitos serviços nos logs
- Nomes de arquivos e de uploads — evitar colisões sem confiar no nome de arquivo do usuário
- Deduplicação de mensagens — uma chave de idempotência para que uma requisição repetida não seja processada duas vezes
- Links de compartilhamento — uma URL impossível de adivinhar para um documento ou um convite
- Dados de teste — valores únicos que nunca vão colidir com dados reais
Como usar
- Escolha quantos você precisa
- Gere — surgem UUIDs novos
- Copie — copie um único UUID ou a lista inteira
Bom saber
- Maiúsculas e minúsculas não importam, mas o padrão é minúsculo, e é o que esta ferramenta produz. Alguns sistemas comparam UUIDs como simples strings, onde A e a são diferentes — portanto, seja consistente.
- Os hifens são formatação. Muitos sistemas armazenam os 32 dígitos sem hifens, ou como 16 bytes brutos. Mesmo valor, apresentação diferente.
- Como chave de banco de dados eles têm um custo. Um UUID ocupa 16 bytes contra 4 ou 8 de um inteiro, e valores aleatórios espalham as gravações por um índice em árvore B em vez de acrescentá-las ao final. Em uma tabela grande com muita escrita isso é mensurável — que é exatamente o problema que a v7 foi criada para resolver.
- Não os use como senhas. Eles são imprevisíveis, mas são identificadores, e acabam em logs e no histórico do navegador.
- "GUID" é o nome que a Microsoft dá à mesma coisa. No .NET e no SQL Server você verá GUID; é o mesmo valor de 128 bits.
- O UUID nil é só zeros — 00000000-0000-0000-0000-000000000000. Normalmente significa "nenhum" ou "não definido", então vale a pena reconhecê-lo.
Perguntas frequentes
O que é um UUID e para que serve?
Um UUID é um identificador de 128 bits escrito com 36 caracteres, como f47ac10b-58cc-4372-a567-0e02b2c3d479. Seu propósito é permitir que qualquer coisa gere um identificador único por conta própria, sem consultar um contador central. Isso importa quando registros são criados em vários servidores ao mesmo tempo, em um telefone off-line, ou antes mesmo de a linha existir no banco de dados.
Os UUIDs têm unicidade garantida?
Não, mas a probabilidade de um choque é desprezível. Um UUID de versão 4 tem 122 bits aleatórios, o que dá cerca de 5,3 × 10³⁶ possibilidades. Seria preciso gerar cerca de 2,7 quintilhões deles antes de chegar a 50% de chance de uma única duplicata. A um bilhão por segundo, isso equivale a aproximadamente 85 anos.
Qual é a diferença entre UUID e GUID?
Nenhuma na prática. GUID é o nome que a Microsoft dá ao mesmo identificador de 128 bits e você o verá por todo o .NET e o SQL Server. O único detalhe é que algumas ferramentas da Microsoft exibem um GUID entre chaves, como {f47ac10b-...}, e que algumas APIs antigas ordenam certos bytes de outra forma ao converter para binário bruto.
Qual versão de UUID devo usar?
A versão 4 para uso geral — ela é totalmente aleatória e não revela nada sobre onde ou quando foi criada. Considere a versão 7 se esses identificadores forem ser chaves primárias de banco de dados, já que ela coloca um carimbo de data/hora na frente, de modo que os valores se ordenam por data de criação e são indexados de forma muito mais eficiente. Evite a versão 1 para qualquer coisa pública, porque ela embute um endereço MAC e um carimbo de data/hora.
Posso usar um UUID como token de segurança?
Para um link impossível de adivinhar é aceitável, já que um UUID v4 não pode realisticamente ser previsto. Mas ele é um identificador, não uma credencial: nunca expira, não pode ser revogado sozinho e tende a acabar em logs de servidor, ferramentas de análise e no histórico do navegador. Para autenticação de verdade, use um token feito para isso, com prazo de validade.
Estes UUIDs são gerados no servidor de vocês?
Não. Eles são criados no seu navegador pelo crypto.getRandomValues, o gerador criptograficamente seguro embutido em todo navegador moderno. Nenhuma requisição é feita e nada é registrado, então você pode gerá-los com a conexão desligada.
Ferramentas relacionadas
- Gerador de senhas — a mesma fonte aleatória segura, para segredos em vez de identificadores
- Gerador de hash — MD5, SHA-1 e SHA-256 para gerar impressões digitais de dados
- Gerador de números aleatórios — números aleatórios no intervalo que você escolher
- Conversor de timestamp — ler o carimbo de data/hora dentro de um UUID v1 ou v7
