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 →
As mudanças de esquema em um banco de dados MySQL em produção vão de triviais (adicionar uma coluna anulável a uma tabela pequena) a perigosas (modificar uma coluna em uma tabela de 500 GB que processa 50 mil gravações por segundo). A diferença está em se o MySQL bloqueia a tabela e por quanto tempo.

Como o ALTER TABLE Funciona

O ALTER TABLE do MySQL tem dois modos, dependendo da operação e da versão: DDL com reconstrução (o comportamento antigo): o MySQL cria uma nova tabela com o novo esquema, copia todas as linhas, troca as tabelas e descarta a original. A tabela fica bloqueada para gravações durante toda a operação — de minutos a horas em tabelas grandes. DDL online: muitas operações podem ser executadas sem bloquear leituras ou gravações. O MySQL faz a mudança no lugar ou reconstrói a tabela em segundo plano enquanto permite DML concorrente. Para descobrir o que uma operação específica vai fazer, adicione as cláusulas ALGORITHM e LOCK explicitamente — o MySQL rejeita a instrução se não conseguir atender às restrições solicitadas:

Modos de Bloqueio do DDL Online

As cláusulas ALGORITHM e LOCK controlam como o MySQL executa a mudança:

O Que É Rápido e O Que É Lento

As operações que usam ALGORITHM=INSTANT (MySQL 8.0) são quase instantâneas, independentemente do tamanho da tabela:
  • Adicionar uma coluna, em qualquer posição (MySQL 8.0.29+)
  • Adicionar/remover uma coluna gerada virtual
  • Alterar o valor padrão de uma coluna
As operações que exigem ALGORITHM=COPY bloqueiam gravações durante toda a execução:
  • Alterar o tipo de dados de uma coluna
  • Converter conjuntos de caracteres
  • (Adicionar um índice full-text não é uma delas — ele é executado como INPLACE, mas sempre precisa de pelo menos LOCK=SHARED, então as leituras continuam e as gravações ficam bloqueadas; LOCK=NONE é rejeitado com ERROR 1846)
A maioria das adições de índice usa ALGORITHM=INPLACE, LOCK=NONE — a reconstrução da tabela acontece em segundo plano e o DML continua. Adicionar um índice em uma tabela de 100 GB leva tempo, mas não bloqueia sua aplicação.

Migrações de Tabelas Grandes em Produção

Para operações que exigem ALGORITHM=COPY em tabelas grandes demais para serem bloqueadas, use uma ferramenta externa:

pt-online-schema-change (Percona Toolkit)

O pt-osc cria uma tabela sombra, copia as linhas em lotes, usa triggers para replicar as gravações em andamento e então troca as tabelas. Sem tempo de inatividade da aplicação.

gh-ost (GitHub)

O gh-ost usa o log binário em vez de triggers, o que é mais confiável sob alta carga de gravação. É a ferramenta preferida para tabelas de alto tráfego. Ambas as ferramentas exigem que a tabela tenha uma chave primária.

Ferramentas de Migração e Controle de Versão

Acompanhe as mudanças de esquema em arquivos de migração sob controle de versão. Ferramentas comuns: Cada ferramenta mantém uma tabela de migrações no banco de dados para registrar quais migrações já foram executadas, então reexecuções são seguras.

Perguntas Frequentes

Posso adicionar uma coluna sem bloquear a tabela?

Adicionar uma coluna anulável, em qualquer posição, usa ALGORITHM=INSTANT e termina em milissegundos, independentemente do tamanho da tabela (MySQL 8.0.29+). Se a operação não usar ALGORITHM=INSTANT, use ALGORITHM=INPLACE, LOCK=NONE, ou pt-osc ou gh-ost.

Como verifico se um ALTER TABLE vai bloquear minha tabela?

Adicione ALGORITHM=INPLACE, LOCK=NONE à instrução. O MySQL a executa sem bloqueio se puder, ou retorna um erro se não puder — de qualquer forma, você obtém uma resposta definitiva sem adivinhar:
Teste primeiro em uma cópia da tabela quando estiver em dúvida sobre tabelas grandes em produção.

Devo executar migrações dentro de uma transação?

As instruções DDL (ALTER TABLE, CREATE INDEX, DROP TABLE) causam um commit implícito no MySQL — elas não podem ser revertidas. Executá-las dentro de um bloco BEGIN/COMMIT não protege você. Planeje sua estratégia de rollback no nível da aplicação (dual-write, feature flags) em vez de depender do rollback de transação.

Solução de Problemas

Veja também