🌐 Blog

O que é um UUID v4 e quando usá-lo

por Equipe Toolonium · · 7 min de leitura

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 4 do 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 v4ID autoincremental
GeraçãoNo cliente, sem BDA BD atribui o próximo
CoordenaçãoNão precisaPrecisa
Vaza contagemNãoSim (revela volume)
Tamanho128 bits32–64 bits
OrdemNão ordenadoOrdenado

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.

Perguntas frequentes

O que é um UUID?

Um UUID (Universally Unique Identifier) é um identificador de 128 bits projetado para ser único sem coordenação central. Escreve-se como 32 dígitos hexadecimais em 5 grupos separados por hifens, por exemplo 550e8400-e29b-41d4-a716-446655440000.

O que a versão 4 tem de especial?

O UUID v4 é quase todo aleatório: 122 dos seus 128 bits são gerados ao acaso. Não depende da hora nem do endereço MAC como outras versões, o que o torna simples e adequado quando você só precisa de um identificador único imprevisível.

Os UUID v4 podem colidir?

Em teoria sim, mas a probabilidade é tão baixa que na prática se ignora. Com 122 bits aleatórios você teria que gerar bilhões de UUIDs por segundo durante anos para que uma colisão fosse sequer provável.

UUID ou ID autoincremental?

O autoincremental é curto e ordenado, mas revela o volume de registros e exige coordenação no banco. O UUID pode ser gerado no cliente sem consultar a BD e não vaza informação de contagem, ao custo de ocupar mais espaço.

É seguro gerar um UUID no navegador?

Sim. Um bom gerador usa a API criptográfica do navegador (crypto.getRandomValues), que produz aleatoriedade de qualidade. Além disso, se gerado localmente, o identificador nunca sai do seu equipamento.

Artigos relacionados

Voltar ao blog