Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Decisões de chave primária são difíceis de desfazer. A escolha errada no início — uma migração de esquema para sair de INT AUTO_INCREMENT, digamos, depois que você tem chaves estrangeiras espalhadas por doze tabelas — é dolorosa. Este guia cobre as três abordagens principais, quando cada uma é a ferramenta certa e o que o VillageSQL adiciona à mistura.

O Padrão do MySQL: AUTO_INCREMENT

Inteiros AUTO_INCREMENT são o padrão por um motivo. Eles são pequenos (4 ou 8 bytes), inserem rápido, ordenam naturalmente e são imediatamente legíveis por humanos em um depurador ou arquivo de log.
O índice clusterizado do InnoDB armazena as linhas na ordem da chave primária. Com uma chave auto-incrementada, cada linha nova vai para o fim da B-tree. Isso significa nenhuma divisão de página, nenhuma fragmentação de índice e inserções sequenciais rápidas. Para a maioria das aplicações com um único banco de dados, essa é a escolha certa. Os problemas com AUTO_INCREMENT surgem quando você escala ou integra:
  • Exposição da contagem de linhas: SELECT COUNT(*) a partir de uma sequência de IDs diz a um cliente de API quantos pedidos existem. IDs sequenciais em URLs permitem que usuários enumerem registros.
  • Geração distribuída: gerar IDs únicos entre vários gravadores exige coordenação — um servidor de sequência, um gravador designado ou intervalos de ID manuais.
  • Fusão de dados: fundir duas tabelas de bancos de dados diferentes produz colisões de ID. Você vai ter que renumerar.
Se nenhum desses casos se aplica, AUTO_INCREMENT provavelmente é a resposta certa. Mantenha-o.

Quando Você Precisa de IDs Globalmente Únicos

A solução padrão são UUIDs: identificadores aleatórios de 128 bits que podem ser gerados de forma independente em qualquer nó sem coordenação e que, na prática, não colidem. O UUID() embutido do MySQL retorna um UUID v1 como uma string CHAR(36). Você pode armazená-lo diretamente, mas há um custo: CHAR(36) ocupa 36 bytes contra 16 bytes do equivalente binário, e UUIDs aleatórios (v4) causam fragmentação do índice do InnoDB porque as linhas novas não pousam no fim do índice — elas pousam em qualquer lugar, forçando divisões de página. A solução alternativa padrão é BINARY(16) com conversão manual:
A flag 1 em UUID_TO_BIN() reordena os bits do timestamp para que UUIDs v1 ordenem cronologicamente. Isso reduz a fragmentação especificamente para UUIDs v1, mas a codificação e decodificação manuais adicionam atrito a cada consulta.

Com o VillageSQL: Tipo UUID Nativo e Versões Ordenáveis

A extensão vsql_uuid do VillageSQL adiciona um tipo de coluna UUID nativo e funções de geração para UUID v1 até v7. Sem codificação e decodificação manuais, e o UUID v7 resolve o problema de fragmentação nas inserções de forma limpa.
O tipo UUID armazena 16 bytes em disco e é exibido automaticamente no formato padrão de string com 36 caracteres. Sem UUID_TO_BIN ou BIN_TO_UUID nas suas consultas. Para IDs determinísticos — a mesma entrada sempre produz o mesmo UUID — use v3 ou v5:
Para detalhes sobre a mecânica de armazenamento de UUIDs e o problema de fragmentação nas inserções, consulte UUIDs no MySQL.

Referência de versões de UUID

Funções adicionais: UUID_IS_VALID(string) retorna 1 ou 0 conforme uma string não NULL seja um UUID bem formado, e NULL quando o próprio argumento é NULL. Ela recebe texto e nunca gera erro, que é o que você quer para IDs vindos de sistemas externos. UUID_VERSION(uuid) retorna o número da versão, para rotear um ID depois que ele já está armazenado como UUID. UUID_COMPARE(uuid1, uuid2) retorna -1, 0 ou 1 para comparação lexicográfica explícita.

Escolhendo uma Estratégia

Para a maioria das equipes que começam um projeto novo: BIGINT AUTO_INCREMENT para tabelas internas, UUID nativo com UUID_V7() para tabelas com IDs voltados ao público ou dados que podem ser fundidos entre sistemas.

Perguntas Frequentes

Quando devo usar UUID_V7 vs UUID_V4?

Use UUID_V7() para chaves primárias em tabelas com muitas gravações. Ele embute um timestamp nos bits altos, então os UUIDs novos sempre ordenam depois dos existentes — isso impede que o InnoDB divida páginas de índice na inserção. Use UUID_V4() somente quando você precisa de IDs aleatórios sem semântica de ordenação (por exemplo, tokens de uso único).

Posso usar UUID como expressão DEFAULT?

O MySQL em si permite funções não determinísticas como UUID(), RAND() e NOW() em expressões DEFAULT. A restrição real é específica do VillageSQL: funções de extensão registradas como não determinísticas — como UUID_V7() — são bloqueadas em expressões DEFAULT, enquanto as determinísticas, como UUID_V3()/UUID_V5(), são permitidas. Essa permissão, porém, não é útil para uma chave primária aqui: UUID_V3()/UUID_V5() recebem argumentos fixos em uma expressão DEFAULT (um DEFAULT não pode ler outras colunas), então todas as linhas recebem o mesmo UUID — o segundo INSERT colide com o primeiro na chave primária. Em vez disso, gere UUID_V7() em cada instrução INSERT.

Devo usar UUID também para chaves estrangeiras?

Sim, mas fique atento ao custo de armazenamento: uma chave estrangeira UUID ocupa 16 bytes por linha na tabela que faz a referência, contra 4–8 bytes de um inteiro. Em tabelas com milhões de linhas e várias chaves estrangeiras UUID, isso se acumula. Para referências puramente internas, AUTO_INCREMENT + chave estrangeira do tipo inteiro é mais enxuto.

Qual é a diferença entre UUID_V3 e UUID_V5?

Os dois geram UUIDs determinísticos a partir de um namespace e um nome — as mesmas entradas sempre produzem a mesma saída. O v3 usa MD5; o v5 usa SHA-1. Prefira o v5 para código novo, já que o SHA-1 é marginalmente mais forte. Use o v3 somente quando você precisa corresponder a IDs gerados por um sistema que usa v3.

Solução de Problemas

Veja também