Como gerar UUIDs passo a passo
Resposta rápida
Para gerar um UUID: abra o Gerador UUID, selecione a versão 4 (aleatória) e clique em Gerar. A ferramenta produz um UUID como "550e8400-e29b-41d4-a716-446655440000" usando crypto.getRandomValues. Toda a geração acontece localmente — nenhum UUID é enviado para um servidor.
Introdução
Um UUID (Identificador Universalmente Único) é um identificador de 128 bits que é praticamente garantido como único sem coordenação entre as partes. UUIDs são comumente usados como chaves primárias de banco de dados, IDs de solicitação, tokens de sessão e identificadores de sistema distribuído. A versão mais comum é UUID v4, que usa bits aleatórios. Este guia mostra como gerar UUIDs em seu navegador e explica as diferenças entre as versões.
Passo a passo
-
Abra a ferramenta Gerador UUID
Vá para a página da ferramenta Gerador UUID. A ferramenta suporta geração UUID v4 (aleatória) e v1 (baseada em tempo).
-
Selecione a versão UUID
Escolha UUID v4 para a maioria dos casos de uso — ele usa bits aleatórios criptograficamente seguros e não tem preocupações com privacidade. Escolha v1 somente se precisar de IDs ordenados por tempo e aceitar a compensação de privacidade (v1 incorpora um carimbo de data/hora e um endereço MAC).
-
Escolha a quantidade
Defina quantos UUIDs você deseja gerar – de 1 a 1000. Gerar vários UUIDs de uma vez é útil para propagar um banco de dados ou criar IDs de solicitação em lote.
-
Gere os UUIDs
Clique em Gerar. A ferramenta produz UUID(s) usando crypto.getRandomValues para v4, garantindo a aleatoriedade criptográfica. Cada UUID é uma string de 36 caracteres no formato 8-4-4-4-12 dígitos hexadecimais.
-
Copie o(s) UUID(s)
Clique em Copiar para copiar um único UUID ou copie a lista inteira se você gerou vários. Use UUID como ID de banco de dados, ID de correlação de solicitação ou token de sessão.
Exemplos
UUID v4 (aleatório)
Entrada: Versão: 4, Quantidade: 1
Saída: 550e8400-e29b-41d4-a716-446655440000
Vários UUID v4
Entrada: Versão: 4, Quantidade: 3
Saída: f47ac10b-58cc-4372-a567-0e02b2c3d479
7b582ea2-1f4d-4f6a-9c83-3a5f2b8e1d47
3d4a5b6c-7e8f-4a2b-9c1d-0e3f5a7b9c2d
UUID v1 (com base no tempo)
Entrada: Versão: 1, Quantidade: 1
Saída: a3bbf0ee-d6e4-11ed-a5b3-3c9703e8b4a1
Problemas comuns
- Usar Math.random() para gerar UUIDs — não é criptograficamente seguro. Sempre use crypto.getRandomValues() ou crypto.randomUUID().
- Armazenando UUIDs como strings em bancos de dados —UUIDs armazenados como tipo UUID (16 bytes) são mais eficientes que strings (36 bytes).
- Usando v1 em contextos sensíveis à segurança —v1 incorpora um carimbo de data/hora e um endereço MAC, que pode vazar informações. Use v4 para anonimato.
- Supondo que os UUIDs sejam verdadeiramente únicos - eles são praticamente únicos (a probabilidade de colisão é insignificante), mas não são garantidos como únicos.
Dicas
- Use UUID v4 para quase todos os casos de uso — é aleatório, não tem preocupações com privacidade e é compatível com todos os bancos de dados modernos.
- Use crypto.randomUUID() em navegadores modernos para um gerador v4 integrado sem biblioteca.
- Armazene UUIDs como tipo UUID/GUID em bancos de dados (16 bytes) em vez de strings (36 bytes) para melhor armazenamento e desempenho de índice.
- Use UUIDs como IDs de solicitação para rastreamento distribuído — eles correlacionam solicitações entre serviços sem coordenação central.