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 →
Inteiros com auto-incremento são simples até deixarem de ser: eles vazam a contagem de linhas, falham em sistemas distribuídos e quebram quando você mescla bancos de dados ou faz sharding. Os UUIDs resolvem tudo isso, mas o tratamento padrão do MySQL os torna lentos para inserir em escala. Veja por que isso acontece e como corrigir.

O Padrão do MySQL: UUID() como CHAR(36)

A função interna UUID() do MySQL retorna um UUID v1 como uma string de 36 caracteres, como 550e8400-e29b-41d4-a716-446655440000. Armazená-la em uma coluna CHAR(36) funciona, mas é ineficiente:
  • 36 bytes em vez de 16 para os mesmos dados
  • A comparação de strings é mais lenta do que a comparação binária
  • UUIDs aleatórios causam divisões de páginas na B-tree a cada inserção (mais sobre isso abaixo)

A Solução Alternativa Padrão: BINARY(16)

O MySQL fornece UUID_TO_BIN() e BIN_TO_UUID() para converter entre a forma de string e a forma binária compacta. Usar BINARY(16) reduz o armazenamento pela metade e acelera as comparações:
A UUID_TO_BIN() aceita um segundo argumento opcional (1) que reordena os bits do timestamp para que os UUIDs v1 sejam ordenados cronologicamente — uma correção parcial para o problema de desempenho de inserção.

O Problema Restante: Inserções Aleatórias Fragmentam os Índices

O InnoDB do MySQL usa um índice clusterizado, o que significa que as linhas são armazenadas fisicamente na ordem da chave primária. Quando você insere uma linha com um UUID aleatório, o InnoDB precisa encontrar o lugar dela no meio do índice e, possivelmente, dividir uma página para abrir espaço. Sob carga contínua, isso causa amplificação de escrita e fragmentação do índice. O UUID v7 corrige isso ao embutir um timestamp Unix nos bits mais altos do identificador. Os novos UUIDs são sempre maiores do que os existentes, portanto as inserções sempre são anexadas à folha mais à direita do índice — sem divisões.

Com o VillageSQL: Tipo UUID Nativo e Todas as Versões

A extensão vsql_uuid do VillageSQL adiciona um tipo de coluna UUID nativo, com armazenamento binário de 16 bytes e sem conversão manual, além de funções de geração para UUID da v1 à v7.

Escolhendo uma versão de UUID

A UUID_VERSION(uuid) retorna o número da versão de um UUID armazenado — útil para rotear IDs por versão. Ela aceita um valor UUID ou um literal de string, que é convertido implicitamente — mas uma string inválida gera ERROR 1525 em vez de retornar 0 ou NULL, portanto ela não é a ferramenta para filtrar texto não confiável; use a UUID_IS_VALID(), abaixo, para isso. A UUID_COMPARE(uuid1, uuid2) retorna -1, 0 ou 1 para lógica de ordenação explícita. Para uma visão mais ampla sobre quando usar UUIDs em vez de outras abordagens de chave primária, consulte Escolhendo uma Estratégia de Chave Primária.

UUIDs baseados em nome e os namespaces da RFC

A UUID_V3() e a UUID_V5() derivam um UUID de um namespace mais um nome, portanto o mesmo par sempre produz o mesmo UUID. UUID_NS_DNS(), UUID_NS_URL(), UUID_NS_OID() e UUID_NS_X500() retornam os quatro namespaces que a RFC 9562 define. Elas retornam texto, que é o que o parâmetro de namespace aceita, portanto elas se compõem diretamente:
A UUID_NIL() e a UUID_MAX() retornam os UUIDs de todos os bits em zero e de todos os bits em um que a mesma RFC reserva, para uso como valores sentinela.

Validando UUIDs vindos de fora do banco de dados

A UUID_IS_VALID(string) retorna 1 quando uma string seria aceita por uma coluna UUID e 0 quando não seria. Ela nunca gera erro, seja o que for que receba, portanto pode filtrar valores antes que eles cheguem a uma coluna tipada:

Usando funções de UUID em colunas geradas e restrições

As funções de introspecção, validação e constantes são determinísticas, assim como os geradores baseados em nome UUID_V3() e UUID_V5(). Todas elas podem aparecer em colunas geradas e em restrições CHECK. Os geradores aleatórios e baseados em tempo — UUID_V4(), UUID_V7() e afins — não podem, porque a saída deles muda a cada chamada. Isso permite derivar ou validar valores armazenados a partir de um UUID no nível do esquema:

UUID vs. Auto-Incremento

Para a maioria das aplicações com um único banco de dados, AUTO_INCREMENT é suficiente. Recorra aos UUIDs quando precisar de IDs globalmente únicos entre sistemas, ao mesclar dados de várias fontes ou quando não quiser expor contagens sequenciais de linhas.

Perguntas Frequentes

Posso usar UUID_V7 como DEFAULT?

Atualmente não. Funções não determinísticas não podem ser usadas em expressões DEFAULT no MySQL. Gere o UUID na sua instrução INSERT.

Posso preencher linhas existentes com UUIDs?

Sim. Adicione uma coluna UUID, preencha-a com UUID_V7() em um UPDATE e, em seguida, torne-a a chave primária.

O UUID_V7 é um padrão?

Sim — definido na RFC 9562, que substitui a RFC 4122.

Solução de Problemas

Veja também