VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
Como o ALTER TABLE Funciona
OALTER 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áusulasALGORITHM e LOCK controlam como o MySQL executa a mudança:
O Que É Rápido e O Que É Lento
As operações que usamALGORITHM=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
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 menosLOCK=SHARED, então as leituras continuam e as gravações ficam bloqueadas;LOCK=NONEé rejeitado com ERROR 1846)
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 exigemALGORITHM=COPY em tabelas grandes demais para serem bloqueadas, use uma ferramenta externa:
pt-online-schema-change (Percona Toolkit)
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)
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, usaALGORITHM=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?
AdicioneALGORITHM=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:
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
- Estratégias de Backup do MySQL — sempre faça backup antes de uma migração
- Transações no MySQL — quais operações de migração são transacionais no MySQL
- Particionamento de Tabelas no MySQL — mudanças de particionamento também são migrações de esquema
- Usando MySQL com ORMs: Django, Rails e Prisma — aplicando com segurança o DDL gerado por ORMs