Entenda os UUID e como gerá-los
O que este gerador faz
Um UUID (identificador único universal) é um valor de 128 bits escrito com 32 dígitos hexadecimais no conhecido padrão 8-4-4-4-12, como 550e8400-e29b-41d4-a716-446655440000. Este gerador produz identificadores em conformidade com a norma RFC 4122 sob demanda: escolha a versão 4 ou a versão 1 e crie até 100 de uma só vez.
Você pode ativar ou remover os hifens e optar por minúsculas ou maiúsculas, de forma que o resultado combine com o que a coluna do seu banco de dados, o contrato da sua API ou o seu código já esperam.
Quando usar um UUID
Os UUID são úteis sempre que um identificador precisa ser criado de forma independente, sem uma autoridade central distribuindo números sequenciais. Casos típicos incluem chaves primárias em bancos de dados distribuídos, identificadores de correlação para rastrear uma requisição entre serviços, chaves de idempotência em chamadas de API, nomes de arquivo que nunca podem coincidir e referências de objetos ou de sessão criadas no cliente.
Como duas máquinas podem gerar identificadores no mesmo instante sem se coordenar, os UUID se encaixam especialmente bem em microsserviços, aplicações offline-first e pipelines de eventos.
Versão 4 contra versão 1
A versão 4 preenche quase todos os seus bits com valores aleatórios criptograficamente robustos vindos do crypto.randomUUID do navegador e da Web Crypto API. Por isso os identificadores são imprevisíveis e não revelam quando nem onde foram criados. É a escolha recomendada para a maioria dos casos.
Já a versão 1 monta o valor a partir do carimbo de data/hora atual mais um identificador de nó e uma sequência de relógio, o que permite ordenar um lote de forma aproximada pela data de criação, mas expõe esse momento. Escolha a v4 quando a imprevisibilidade importa e a v1 quando uma ordenação cronológica aproximada for mais útil.
Formato e probabilidade de colisão
Ambas as versões mantêm o layout padrão 8-4-4-4-12, e o dígito de versão fica no início do terceiro grupo: um 4 ou um 1. A força da v4 vem dos seus 122 bits aleatórios: o conjunto abrange mais de 5×10^36 valores possíveis, de modo que, mesmo depois de gerar bilhões de identificadores, a chance de dois coincidirem continua praticamente nula.
Remover os hifens deixa uma cadeia compacta de 32 caracteres, prática em URLs ou chaves, enquanto a saída em maiúsculas combina com sistemas que armazenam os identificadores dessa forma.