Qual versão devo usar como chave primária?

Na maioria dos casos, v7. Ele mantém as propriedades que levam alguém a escolher UUID e devolve a localidade de escrita que o v4 tira, evitando a fragmentação do índice conforme a tabela cresce.

O UUID v7 revela informação?

Revela o instante de criação do registro com precisão de milissegundos. Normalmente isso é irrelevante, mas se o momento da criação for sensível ou a taxa de criação for um dado de negócio a ser protegido, prefira v4.

Dá para migrar de v4 para v7 sem parar o sistema?

Sim. Os dois são UUID de 128 bits e ocupam a mesma coluna. Basta trocar o gerador para as linhas novas; as antigas continuam funcionando sem conversão.

UUID pode ser usado como token secreto?

Um v4 tem 122 bits de entropia, o que é bastante, mas o UUID costuma aparecer em log, URL e resposta de API porque é tratado como identificador. Para segredo, gere um valor dedicado que nunca seja exposto.

Qual a chance de dois UUID v4 colidirem?

Desprezível na escala de qualquer aplicação real. Ainda assim, mantenha a restrição de unicidade no banco: ela custa quase nada e protege contra o cenário muito mais provável de um bug no código gerar o mesmo valor duas vezes.

Codigio Labs

Gerador de UUID

Gere Identificadores Únicos Universais

⭐ Favoritos

Adicione UUIDs aos favoritos para acesso rápido.

Pronto para gerar

Como usar

Crie UUIDs versão 4 (aleatório) ou versão 7 (ordenável por tempo) individualmente ou em massa.

Guia de uso responsável

Gera identificadores UUID v4 e v7 para entidades, eventos, fixtures e testes de ordenação, com geração criptograficamente adequada no navegador.

UUID v4 e v7

O v4 é inteiramente aleatório e funciona bem como identificador de propósito geral. O v7 coloca um timestamp de milissegundos nos 48 bits mais significativos, o que faz valores gerados em sequência ficarem próximos e melhora bastante o comportamento de índices B-tree em banco de dados.

Uso em sistemas

UUIDs reduzem colisões em sistemas distribuídos e permitem que o cliente gere o identificador antes de falar com o servidor. Ainda assim, mantenha a restrição de unicidade no armazenamento quando usá-los como chave primária.

Boas práticas

Prefira v7 quando a ordenação cronológica for útil.
Armazene no tipo nativo do banco, nunca como VARCHAR(36).
Não use UUID como substituto de autorização ou de segredo.

Perguntas frequentes

Qual versão devo usar como chave primária?: Na maioria dos casos, v7. Ele mantém as propriedades que levam alguém a escolher UUID e devolve a localidade de escrita que o v4 tira, evitando a fragmentação do índice conforme a tabela cresce.
O UUID v7 revela informação?: Revela o instante de criação do registro com precisão de milissegundos. Normalmente isso é irrelevante, mas se o momento da criação for sensível ou a taxa de criação for um dado de negócio a ser protegido, prefira v4.
Dá para migrar de v4 para v7 sem parar o sistema?: Sim. Os dois são UUID de 128 bits e ocupam a mesma coluna. Basta trocar o gerador para as linhas novas; as antigas continuam funcionando sem conversão.
UUID pode ser usado como token secreto?: Um v4 tem 122 bits de entropia, o que é bastante, mas o UUID costuma aparecer em log, URL e resposta de API porque é tratado como identificador. Para segredo, gere um valor dedicado que nunca seja exposto.
Qual a chance de dois UUID v4 colidirem?: Desprezível na escala de qualquer aplicação real. Ainda assim, mantenha a restrição de unicidade no banco: ela custa quase nada e protege contra o cenário muito mais provável de um bug no código gerar o mesmo valor duas vezes.