O que é um UUID v7?
Um UUID v7 começa com um carimbo de tempo Unix de 48 bits em milissegundos. Valores próximos no tempo ficam próximos no índice, e linhas novas são acrescentadas no fim em vez de se espalhar pela árvore B.
Os 74 bits restantes são aleatórios. O v7 junta a ordem de um contador sequencial com a resistência a colisões de um identificador aleatório — é a chave primária mais óbvia em sistemas distribuídos.
Como usar
- Escolha a quantidade de UUIDs (de 1 a 1000).
- Clique em Gerar: os valores já saem em ordem crescente.
- Copie um valor ou exporte o lote em .txt ou .csv.
Casos de uso
- Chaves primárias em PostgreSQL, MySQL, SQL Server e SQLite.
- IDs de eventos e logs consultados por data.
- Filas e registros de captura de alterações (CDC).
Como o UUID v7 se compara
| Opção | Quando usar |
|---|---|
v4 | Aleatório puro, sem referência temporal — o clássico |
v6 | Também ordenável, mas com o carimbo de 60 bits do v1 |
ULID | Ordenável, porém com 26 caracteres em Crockford base32 |
As versões de UUID em resumo
| Versão | Ordenável | Baseada em | Use para |
|---|---|---|---|
| v1 | Não | Carimbo de tempo + endereço MAC | Sistemas antigos que ainda esperam v1 |
| v3 | Não | Hash MD5 de um nome | Identificadores determinísticos quando MD5 é exigido |
| v4 | Não | 122 bits aleatórios | Praticamente qualquer identificador de uso geral |
| v5 | Não | Hash SHA-1 de um nome | Quando o mesmo nome precisa dar sempre o mesmo ID |
| v6 | Sim | Carimbo de tempo reordenado | Identificadores ordenáveis sem abrir mão do aleatório |
| v7 | Sim | Tempo Unix em milissegundos | Chaves primárias de banco e IDs de eventos |
| v8 | Não | Seu próprio layout de bits | Formatos de fabricante ou experimentais |
As sete versões têm 128 bits e são escritas no mesmo formato 8-4-4-4-12. Só o significado dos bits muda.
Perguntas frequentes
O v7 revela quando o identificador foi criado?
Sim, o carimbo de tempo fica visível na frente. Isso é intencional: é daí que vem a ordenação. Se a data de criação precisar ficar em segredo, use o v4.
Posso usar o v7 como chave primária?
Sim, e é melhor que o v4 assim que a coluna é indexada. Os valores continuam únicos e as inserções seguem sequenciais, o que reduz a carga de escrita e o tamanho do índice.
Os valores v7 continuam únicos dentro do mesmo milissegundo?
Sim. Um incremento monotônico na parte aleatória garante que vários identificadores do mesmo milissegundo continuem crescentes e distintos.