Entenda os UUIDs e por que eles importam
Um Identificador Universalmente Único (UUID) é um código de 128 bits criado para que a chance de duas pessoas gerarem o mesmo valor seja infinitamente pequena.
O que exatamente é um UUID?
Os UUIDs seguem a especificação RFC 4122 e são escritos como cinco grupos hexadecimais separados por hífens.
Esta ferramenta suporta múltiplas versões: v1 (temporal), v4 (aleatório), v5 (baseado em nome com SHA-1), e v7 (época Unix do RFC 9562).
Versões de UUID explicadas
A versão 1 usa o timestamp atual e endereço MAC, útil quando você precisa de identificadores ordenáveis por tempo.
A versão 4 é completamente aleatória com 122 bits de entropia. É a versão mais usada.
A versão 5 gera UUIDs determinísticos a partir de um namespace e nome usando SHA-1.
A versão 7 é um padrão mais novo (RFC 9562) que combina timestamp Unix com bits aleatórios.
Por que desenvolvedores confiam em UUIDs
Como podem ser gerados sem uma autoridade central, os UUIDs simplificam o design de APIs e código no cliente.
Eles também são opacos: um UUID não revela nada sobre o dado que identifica.
Qual versão escolher?
- Use v4 para a maioria dos casos - é simples, aleatório e amplamente suportado
- Use v1 ou v7 quando precisar de identificadores ordenáveis por tempo
- Use v5 quando precisar de IDs determinísticos de entradas conhecidas
- Use v7 para projetos novos que precisem de IDs ordenados por tempo com melhor aleatoriedade
Boas práticas após gerar
- Normalize o valor para minúsculas antes de armazenar
- Salve UUIDs em formato binário quando o banco permitir
- Evite expor sequências previsíveis
- Registre o contexto junto com o UUID para auditoria