Migrations adalah cara Django untuk menyebarkan perubahan yang Anda buat pada models (menambah field, membuat model) ke dalam database schema — mereka adalah file perubahan database yang version-controlled dan otomatis dihasilkan. Anda mengubah models dalam Python; migrations membuat database tetap sinkron.
python manage.py makemigrations
python manage.py migrate
makemigrations mendeteksi perubahan model dan membuat file migration; migrate menerapkan migration yang tertunda ke database yang sebenarnya. Anda menulis Python (perubahan model), dan Django menghasilkan dan menjalankan 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),
),
]
Migrations di-commit ke version control, sehingga riwayat database schema dilacak bersama dengan kode. Setiap developer dan environment menerapkan migrations yang sama untuk mencapai schema yang sama — reproducible dan konsisten.
✓ 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.
Migrations sangat penting untuk bekerja dengan database layer Django — mereka menyelesaikan masalah kritis dalam menjaga database schema tetap sinkron dengan Python models Anda dengan cara yang aman, reproducible, dan ramah tim.
Memahaminya adalah pengetahuan fundamental sehari-hari: workflow makemigrations → migrate adalah bagaimana setiap perubahan schema terjadi (Anda mengubah models, Django menghasilkan dan menerapkan SQL), jadi Anda tidak bisa mengembangkan Django app berbasis data tanpa itu.
Nilai utamanya adalah migrations membuat perubahan schema version-controlled (dilacak bersama kode, dapat direview dalam pull requests), reproducible (setiap environment — mesin setiap developer, staging, production — mencapai schema identik dengan menjalankan migrations yang sama), dan safe (Django menghasilkan SQL yang benar, sering kali reversible, bukan pernyataan ALTER TABLE manual yang rawan kesalahan).
Ini menghilangkan seluruh kategori masalah seputar schema drift, environment yang tidak konsisten, dan perubahan database manual yang berisiko.
Mengetahui workflow, bahwa migrations di-commit ke source control, cara menginspeksi dan memutar kembali migrations, dan bahwa mereka juga dapat menangani transformasi data (backfilling/migrasi data, bukan hanya schema) adalah keharusan untuk proyek Django nyata apa pun.
Migrations adalah cara Django teams mengembangkan database schema mereka secara kolaboratif dan reliabel sepanjang masa proyek, membuat materi ini inti, harus diketahui.