Revise e edite scripts gerados

A geração automática é um ótimo primeiro rascunho, não uma resposta final. Sempre revise o script antes de aplicá-lo em qualquer lugar. 🔍

Cada script fica na pasta versions. Abra-o e leia as funções upgrade e downgrade como faria com qualquer outro código.

Dentro das funções, você verá chamadas no objeto op, como op.create_table e op.add_column, cada uma descrevendo uma alteração do esquema.

A geração automática frequentemente não detecta renomeações, tratando-as como uma remoção seguida de uma adição. Isso excluiria silenciosamente os dados da coluna.

Quando uma coluna está realmente sendo renomeada, substitua a remoção e a adição por um único alter_column que preserve os dados.

Confirme que o downgrade realmente reverte o upgrade. Um downgrade com erro deixará você bloqueado se algum dia precisar reverter.

Adicionar uma coluna que não aceita valores nulos a uma tabela com linhas causará uma falha. Adicione-a primeiro aceitando valores nulos, preencha os valores e depois torne-a obrigatória.

Precisa preencher valores existentes? Adicione uma chamada op.execute com SQL bruto entre as etapas do esquema para migrar os dados existentes com segurança.

Antes de tocar na produção, execute a migração em uma cópia dos dados reais. Isso revela as falhas enquanto ainda é barato corrigi-las.

Mantenha cada migração concentrada em uma única alteração lógica. Scripts pequenos são muito mais fáceis de revisar, testar e reverter corretamente.

Depois de editar e testar, faça commit do script. Nunca altere uma migração que já tenha sido enviada para o histórico de produção.

Você aprendeu a revisar scripts gerados, corrigir renomeações com alter_column, lidar com colunas que não aceitam valores nulos e testar antes da entrega. 🎉