VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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
InteirosAUTO_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.
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.
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. OUUID() 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:
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ãovsql_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.
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:
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?
UseUUID_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 comoUUID(), 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
- UUIDs no MySQL — mergulho profundo nas versões de UUID e no armazenamento no MySQL
- Como o InnoDB Armazena Dados — por que a escolha da chave primária afeta o layout físico do armazenamento
- Como os Índices do MySQL Funcionam — a chave primária é sempre um índice B-tree clusterizado
- Paginação no MySQL: Keyset vs OFFSET — as chaves também servem como cursores de paginação