Quando você precisa de um identificador único e não quer pedir o próximo número ao banco de dados a cada vez, o UUID resolve o problema. Este guia explica o que é um UUID v4, como é feito, quando convém usá-lo e em que se diferencia de um ID autoincremental.
1. O problema que resolve
Imagine dois servidores criando registros ao mesmo tempo, sem se falarem. Como garantir que os seus identificadores não colidam? O UUID permite gerar um identificador único sem coordenação central: cada parte o cria por conta própria e, na prática, nunca coincidem.
2. O que é um UUID v4
Um UUID (Universally Unique Identifier) é um identificador de 128 bits. Representa-se como 32 dígitos hexadecimais em cinco grupos:
550e8400-e29b-41d4-a716-446655440000
A versão 4 é a mais usada: é quase completamente aleatória. Dos seus 128 bits, 122 são gerados ao acaso; os outros 6 fixam a versão e a variante.
3. Anatomia
- 128 bits no total.
- 4 bits indicam a versão (o dígito
4do terceiro grupo). - 2 bits indicam a variante.
- 122 bits restantes: aleatórios.
Isso significa que não há nada da sua máquina nem da hora codificado dentro: um UUID v4 não revela quando nem onde foi criado.
4. Quando usá-lo
- Chaves primárias em bancos de dados distribuídos.
- IDs de request para rastrear uma requisição nos logs.
- Nomes de arquivo únicos sem consultar nada.
- Tokens de referência não secretos.
5. Por que quase nunca colidem
Com 122 bits aleatórios, o espaço de possibilidades é tão enorme que a probabilidade de gerar dois iguais é desprezível. Você teria que produzir bilhões por segundo durante anos para que uma colisão fosse sequer provável.
6. UUID vs ID autoincremental
| UUID v4 | ID autoincremental | |
|---|---|---|
| Geração | No cliente, sem BD | A BD atribui o próximo |
| Coordenação | Não precisa | Precisa |
| Vaza contagem | Não | Sim (revela volume) |
| Tamanho | 128 bits | 32–64 bits |
| Ordem | Não ordenado | Ordenado |
Gere um UUID v4 na hora — criado com o gerador criptográfico do seu navegador, 100% local, nada é enviado → abrir o gerador de UUID
7. Privacidade: gerado no seu navegador
Um bom gerador usa a API criptográfica do navegador (crypto.getRandomValues), que produz aleatoriedade de qualidade. Como é gerado localmente, o identificador nunca sai do seu equipamento.
Se você trabalha com integridade de dados além de identificadores, talvez lhe interesse o que é SHA-256.
8. Resumo
Um UUID v4 é um identificador de 128 bits, quase todo aleatório, que você pode gerar sem coordenação central e que na prática nunca colide. É ideal para chaves distribuídas, IDs de request e nomes de arquivo, ao custo de ocupar mais que um autoincremental e não ser ordenado. Para obter um na hora e localmente, use o gerador.