Gerador de UUID
Gere valores UUID v4 aleatórios para utilização em bases de dados, APIs ou testes.
Como utilizar este gerador de UUID
- Defina o número de UUIDs
Introduza 1–10 no campo Número de UUIDs para especificar quantos identificadores pretende gerar.
- Gerar
A calculadora produz valores UUID v4 aleatórios utilizando a fonte aleatória criptográfica do navegador.
- Copiar o resultado
Copie os UUID(s) gerados para utilizar em bases de dados, payloads de API ou fixtures de teste.
Como funciona este gerador de UUID
Esta ferramenta gera UUIDs de versão 4 utilizando a aleatoriedade do navegador. Os identificadores UUID v4 são valores de 128 bits com bits específicos definidos para indicar a versão (4) e a variante padrão utilizada pelas especificações modernas de UUID. Quando o Web Crypto está disponível, a aleatoriedade é criptograficamente forte; caso contrário, a ferramenta recorre a um gerador mais fraco apenas para conveniência.
UUID v4 = xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx (onde y ∈ {8,9,a,b}) Exemplo de saída: 550e8400-e29b-41d4-a716-446655440000
Gerar 1 UUID produz um valor único como a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d. O 4 no terceiro grupo indica a versão 4.
Gerar 3 UUIDs devolve três valores distintos, cada um com 122 bits aleatórios. Utilize-os como chaves primárias para registos de teste ou recursos de API.
- ✓ Utiliza a API de números aleatórios criptográficos do navegador quando disponível.
- ✓ Recorre a Math.random() em ambientes sem Web Crypto, o que é adequado para conveniência, mas não para utilização de alta segurança.
- O UUID v4 não é sequencial e não é adequado para utilização como chave primária ordenável em bases de dados que beneficiam de inserções ordenadas.
Compreender as versões e a estrutura do UUID
Um UUID (Universally Unique Identifier) é um valor de 128 bits representado por 32 dígitos hexadecimais em cinco grupos (8-4-4-4-12). Os UUIDs de versão 4 utilizam dados aleatórios ou pseudoaleatórios para 122 desses bits; os bits restantes codificam a versão (4) e a variante. A probabilidade de uma colisão é astronomicamente baixa — cerca de 1 em 2^122 — pelo que os UUIDs são efetivamente únicos sem necessidade de coordenação. Existem outras versões: a v1 utiliza o carimbo de data/hora e o endereço MAC, a v3 e a v5 são hashes baseados em nomes e a v7 é ordenada por tempo. O UUID v4 é a escolha mais comum para sistemas distribuídos porque não requer uma autoridade central nem um estado partilhado para ser gerado.
Casos de utilização de UUIDs para programadores
Os programadores utilizam UUIDs como chaves primárias em bases de dados, IDs de correlação em rastreio distribuído e identificadores únicos em payloads de API. Ao contrário dos números inteiros de incremento automático, os UUIDs podem ser gerados no lado do cliente ou por qualquer serviço sem contactar uma base de dados central, o que simplifica o escalonamento horizontal e as arquiteturas offline-first. São ideais para cenários de fusão onde múltiplos sistemas criam registos que são posteriormente combinados. Os UUIDs também aparecem em parâmetros de estado OAuth, assinaturas de webhooks e na nomenclatura de ficheiros para evitar colisões. Ao testar, a geração de UUIDs a pedido evita o hardcoding e torna as fixtures reproduzíveis. A principal desvantagem é o tamanho (36 caracteres) e a falta de ordenação em comparação com IDs sequenciais.
Perguntas frequentes
Estes UUIDs são únicos?
Para todos os efeitos práticos, sim. A probabilidade de gerar um duplicado é astronomicamente pequena (1 em 2^122).
Posso utilizá-los em produção?
Sim, quando o ambiente fornece aleatoriedade Web Crypto. Se a página estiver a ser executada sem essa API e recorrer a Math.random(), trate o resultado como identificadores de conveniência e não como aleatoriedade de nível de segurança.