UUID v4 ou v7 para identificadores
Uma decisão prática sobre identificadores que separa unicidade de sigilo e evita surpresas de compatibilidade ou desempenho no banco de dados.
UUID v4 e v7 oferecem espaços globais de grande unicidade, mas expõem informações diferentes e se comportam de modo distinto nos índices. Nenhum deles é segredo nem substitui a verificação de permissões.
Escolha pelo padrão de acesso
v4 é aleatório e possui compatibilidade muito ampla. v7 incorpora o horário de criação e costuma melhorar a localidade das inserções, mas valores criados juntos não formam automaticamente uma sequência global estrita.
Verifique o armazenamento e a compatibilidade
Prefira colunas UUID nativas ou armazenamento binário compacto, mantenha uma única representação textual canônica nas interfaces e verifique analisadores, drivers, migrações e esquemas de API antes de adotar v7.
Revise a privacidade e a segurança
v7 revela aproximadamente o horário de criação; v4 não. Ambos ainda exigem autorização de cada recurso e nenhum deve substituir senhas, tokens de sessão ou chaves de API.
Checklist para escolher uma versão de UUID
- Confirme o suporte da linguagem e do banco de dados
- Escolha v4 ou v7 por um motivo explícito
- Use um formato de armazenamento canônico
- Teste os índices e as migrações
- Mantenha a autorização independente dos identificadores
Guias relacionados
Entenda o workflow por trás desta ferramenta e o que revisar depois.
JSON Schema para contratos de API confiáveis
Um processo de criação de esquemas que transforma dados válidos e inválidos em documentação executável em vez de depender de um único exemplo ideal.
Como depurar uma resposta JSON de API passo a passo
Um processo repetível para separar erros de transporte, problemas de sintaxe JSON e falhas do contrato de dados nas respostas de uma API.