Gerador de UUID (v4 aleatório, v7 ordenado por tempo)

Quando usar v4 vs v7

UUID v4 é puramente aleatório — 122 bits aleatórios com dois bits de versão/variante, dando cerca de 5,3 × 10³⁶ valores possíveis. Dois praticamente nunca vão colidir. Use v4 em qualquer lugar que não precise de ordenação, como IDs de requisição de API ou identificadores de usuários anônimos.

UUID v7 (RFC 9562, publicado em 2024) começa com um timestamp Unix de 48 bits em milissegundos seguido de 74 bits aleatórios. Ordenam lexicograficamente na ordem de criação, o que é enorme para o desempenho de banco de dados — chaves primárias que ordenam por tempo significam que as inserções sempre vão para o final da B-tree, sem divisões aleatórias de página. Use v7 para novas chaves primárias de banco de dados.

Como este gerador funciona

Tanto v4 quanto v7 usam crypto.getRandomValues — a fonte de aleatório seguro do navegador, o mesmo primitivo usado por HTTPS e gerenciadores de senha. v4 preenche 122 bits aleatoriamente. v7 divide 48 bits de timestamp + 74 bits de aleatório mais marcadores de versão/variante conforme o RFC.

A geração acontece no seu navegador. Os UUIDs não são armazenados ou transmitidos. Se você gerar 100 UUIDs v4, a chance de colisão entre eles é astronomicamente pequena — bem abaixo da chance de raios cósmicos virando bits na sua CPU.

Armadilhas comuns do UUID

UUIDs v4 como chaves primárias de banco de dados prejudicam o desempenho comparado a inteiros auto-incrementais porque valores aleatórios causam divisões de página B-tree durante inserções. O v7 resolve isso — use v7 se quiser os benefícios do UUID sem a dor no índice.

Não exponha UUIDs a usuários onde a adivinhabilidade importa. UUIDs v4 têm 122 bits de entropia e são inadivinhάveis. UUIDs v7 revelam o horário de criação, o que é normal para a maioria dos usos, mas ruim se o horário de criação for sensível.

UUIDs têm 36 chars incluindo hífens (32 hex + 4 hífens). Ocupam 16 bytes binário ou 36 bytes texto. Para colunas de altíssima cardinalidade, considere armazenar como BLOB binário / tipo UUID nativo em vez de VARCHAR(36).