Gerador de UUID — v4 random e v7 sortable (RFC 9562)

O que é UUID e quando usar

UUID (Universally Unique Identifier) é uma string de 128 bits formatada em 5 grupos hexadecimais separados por hífen (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). É amplamente usado como identificador único em sistemas distribuídos — bancos de dados, mensageria, APIs — quando você precisa gerar IDs sem coordenação central, sem risco prático de colisão.

UUID v4 vs v7 — qual escolher

UUID v4 (random)

Puramente aleatório. 122 bits de entropia (4 bits são fixos para version + variant). Use quando: o ID precisa ser imprevisível — tokens de acesso, identificadores que não devem permitir enumeração de recursos. Não use como chave primária em índice B-tree grande — a aleatoriedade fragmenta o índice e degrada inserções.

UUID v7 (sortable)

Padronizado em maio de 2024 pela RFC 9562. Os primeiros 48 bits são timestamp Unix em milissegundos, seguidos por bits aleatórios. Resultado: IDs monotonicamente crescentes, que mantêm B-tree indexes bem distribuídos. Use como chave primária em PostgreSQL, MySQL, MongoDB — ganho real de performance em inserts em larga escala. Suportado nativamente em Postgres 17+.

Comparação prática

• Token de sessão / API key → v4 (imprevisibilidade importa)
• Chave primária de tabela com milhões de inserts → v7 (performance de índice)
• ID de evento em log/timeline → v7 (já vem ordenável por tempo)
• ID público em URL → v4 (não vaza o momento de criação)

Como a aleatoriedade é gerada

Usamos a Web Crypto API nativa do navegador (crypto.randomUUID() para v4 e crypto.getRandomValues() para v7). É o mesmo padrão criptograficamente seguro usado em bibliotecas profissionais. Não depende de geradores pseudo-aleatórios fracos como Math.random().

Privacidade

Os UUIDs são gerados localmente no seu navegador. Nada é enviado a servidores, nada é registrado. Pode gerar centenas e usar com tranquilidade — eles existem apenas no seu clipboard até você decidir o destino.