O que é um UUID v5?
Um UUID v5 aplica SHA-1 ao UUID do espaço de nomes junto com o nome e depois fixa os bits de versão e variante. O mesmo par sempre produz o mesmo UUID.
É a forma usual de criar identificadores estáveis a partir daquilo que já identifica o recurso: um domínio, um endereço de e-mail ou um caminho canônico. O v5 também é a peça básica da indexação determinística em sistemas de busca.
Como usar
- Selecione o espaço de nomes que corresponde ao seu caso.
- Digite o nome exato que será convertido em identificador.
- Clique em Gerar e guarde ou copie o UUID resultante.
Casos de uso
- Chaves estáveis para registros que já têm uma chave natural.
- Sincronização entre sistemas sem uma sequência compartilhada.
- Indexação reproduzível de documentos e catálogos.
As versões de UUID em resumo
| Versão | Ordenável | Baseada em | Use para |
|---|---|---|---|
| v1 | Não | Carimbo de tempo + endereço MAC | Sistemas antigos que ainda esperam v1 |
| v3 | Não | Hash MD5 de um nome | Identificadores determinísticos quando MD5 é exigido |
| v4 | Não | 122 bits aleatórios | Praticamente qualquer identificador de uso geral |
| v5 | Não | Hash SHA-1 de um nome | Quando o mesmo nome precisa dar sempre o mesmo ID |
| v6 | Sim | Carimbo de tempo reordenado | Identificadores ordenáveis sem abrir mão do aleatório |
| v7 | Sim | Tempo Unix em milissegundos | Chaves primárias de banco e IDs de eventos |
| v8 | Não | Seu próprio layout de bits | Formatos de fabricante ou experimentais |
As sete versões têm 128 bits e são escritas no mesmo formato 8-4-4-4-12. Só o significado dos bits muda.
Perguntas frequentes
Consigo recuperar o nome a partir do UUID?
Não. O SHA-1 é uma função de mão única: só é possível verificar se um nome específico produz aquele UUID, não desfazer a conta.
Quais espaços de nomes existem?
A RFC 9562 define quatro padrões: DNS, URL, OID e X.500. Qualquer UUID válido também pode servir como espaço de nomes próprio.
O v5 substitui o v4?
Não: eles resolvem problemas diferentes. O v4 garante unicidade aleatória; o v5 garante reprodutibilidade. Use o v4 quando não existir uma chave natural.