DevGuideTK
← Trilha Backend

Migrações de esquema

Como alterar tabelas em produção sem parar o sistema e sem perder dados.

Migração de esquema é uma mudança versionada na estrutura do banco: criar uma tabela, acrescentar uma coluna, criar um índice. Ela roda junto com o deploy, com o sistema no ar.

Uma migração descuidada trava a tabela, enfileira todos os pedidos atrás dela e derruba o sistema, ou quebra a versão do código que ainda está rodando.

  • Cada migração é um arquivo versionado, aplicado em ordem e uma vez só.
  • Algumas mudanças são instantâneas; outras reescrevem a tabela inteira.
  • Um limite de espera pela trava evita a fila que derruba o sistema.
  • Índices em tabelas grandes são criados sem bloquear escritas.
  • Renomear ou remover exige etapas: expandir, migrar e só depois contrair.