Migrações são a maneira do Django de propagar as mudanças que você faz em seus modelos (adicionando um campo, criando um modelo) no esquema de banco de dados — elas são arquivos de mudança de banco de dados versionados e gerados automaticamente. Você altera modelos em Python; as migrações mantêm o banco de dados sincronizado.
python manage.py makemigrations
python manage.py migrate
makemigrations detecta mudanças no modelo e gera um arquivo de migração; migrate aplica migrações pendentes ao banco de dados real. Você escreve Python (mudanças no modelo), e Django gera e executa o SQL.
# migrations/0002_article_views.py (auto-generated)
class Migration(migrations.Migration):
dependencies = [("blog", "0001_initial")] # ordering — depends on the previous one
operations = [
migrations.AddField( # the change
model_name="article",
name="views",
field=models.IntegerField(default=0),
),
]
As migrações são confirmadas no controle de versão, portanto o histórico do esquema de banco de dados é rastreado junto com o código. Cada desenvolvedor e ambiente aplica as mesmas migrações para chegar ao mesmo esquema — reprodutível e consistente.
✓ Schema changes are version-controlled (tracked with the code, reviewable in PRs)
✓ Reproducible — every dev/staging/production DB gets the same schema by running migrate
✓ No manual, error-prone SQL — Django generates the correct ALTER statements
✓ Reversible — many migrations can be rolled back (migrate <app> <previous>)
✓ Team-friendly — schema changes flow through the normal code-review process
python manage.py showmigrations # see which migrations are applied/pending
python manage.py sqlmigrate blog 0002 # preview the SQL a migration will run
python manage.py makemigrations --empty # a blank migration for custom/data changes
python manage.py migrate blog 0001 # roll BACK to a previous migration
Migrations can also transform DATA (e.g. populate a new field, backfill values)
via RunPython operations — useful when a schema change needs accompanying data changes.
As migrações são essenciais para trabalhar com a camada de banco de dados do Django — elas resolvem o problema crítico de manter o esquema de banco de dados sincronizado com seus modelos Python de forma segura, reprodutível e amigável para equipes.
Compreendê-las é conhecimento fundamental do dia a dia: o fluxo de trabalho makemigrations → migrate é como toda mudança de esquema acontece (você altera modelos, Django gera e aplica o SQL), portanto você não pode desenvolver um aplicativo Django orientado a dados sem isso.
O valor-chave é que as migrações tornam as mudanças de esquema versionadas (rastreadas junto com o código, revisáveis em solicitações de pull), reprodutíveis (cada ambiente — máquina de cada desenvolvedor, staging, produção — chega ao esquema idêntico executando as mesmas migrações) e seguras (Django gera SQL correto, frequentemente reversível, em vez de declarações ALTER TABLE manuais e propensas a erros).
Isso elimina uma categoria inteira de problemas em torno de desvio de esquema, ambientes inconsistentes e mudanças manuais de banco de dados arriscadas.
Saber o fluxo de trabalho, que as migrações são confirmadas no controle de código-fonte, como inspecionar e revertê-las, e que elas também podem lidar com transformações de dados (preenchimento/migração de dados, não apenas esquema) é necessário para qualquer projeto Django real.
As migrações são como as equipes Django evoluem seu esquema de banco de dados colaborativamente e de forma confiável durante a vida útil de um projeto, tornando esse material essencial e imprescindível.