Bagaimanakah migrasi berfungsi?

Question

Accepted Answer

**Migrasi** ialah cara Django menyebarkan perubahan yang anda buat pada model anda (menambah medan, mencipta model) ke dalam **skema pangkalan data** — ia ialah fail perubahan pangkalan data yang dikawal versi dan dijana secara automatik. Anda mengubah model dalam Python; migrasi memastikan pangkalan data kekal selari. ## Aliran kerja dua langkah ```bash # 1. you change a model in models.py (e.g. add a field)... # 2. generate a migration file describing the change python manage.py makemigrations # → creates migrations/0002_article_views.py (the change, as Python) # 3. apply the migration to the database python manage.py migrate # → runs the SQL to alter the database schema (ADD COLUMN, etc.) ``` `makemigrations` mengesan perubahan model dan menjana fail migrasi; `migrate` menggunakan migrasi tertunggak pada pangkalan data sebenar. Anda menulis Python (perubahan model), dan Django menjana serta menjalankan SQL. ## Fail migrasi ialah kod yang dikawal versi ```python # 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), ), ] ``` Migrasi **diserahkan ke kawalan versi**, jadi sejarah skema pangkalan data dijejaki bersama-sama kod. Setiap pembangun dan persekitaran menggunakan migrasi yang sama untuk mencapai skema yang sama — boleh dihasilkan semula dan konsisten. ## Mengapa migrasi penting (berbanding SQL manual) ```text ✓ 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 ) ✓ Team-friendly — schema changes flow through the normal code-review process ``` ## Arahan dan konsep berguna ```bash 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 ``` ## Migrasi data (bukan sekadar skema) ```text 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. ``` ## Mengapa ia penting Migrasi adalah penting untuk bekerja dengan lapisan pangkalan data Django — ia menyelesaikan masalah kritikal memastikan skema pangkalan data kekal selari dengan model Python anda dengan cara yang selamat, boleh dihasilkan semula, dan mesra pasukan. Memahaminya adalah pengetahuan harian yang asas: aliran kerja `makemigrations` → `migrate` ialah cara setiap perubahan skema berlaku (anda mengubah model, Django menjana dan menggunakan SQL), jadi anda tidak boleh membangunkan aplikasi Django yang dipacu data tanpanya. Nilai utamanya ialah migrasi menjadikan perubahan skema **dikawal versi** (dijejaki bersama kod, boleh disemak dalam pull request), **boleh dihasilkan semula** (setiap persekitaran — mesin setiap pembangun, staging, pengeluaran — mencapai skema yang serupa dengan menjalankan migrasi yang sama), dan **selamat** (Django menjana SQL yang betul dan selalunya boleh diterbalikkan dan bukannya kenyataan `ALTER TABLE` manual yang terdedah kepada ralat). Ini menghapuskan seluruh kategori masalah berkaitan hanyutan skema, persekitaran yang tidak konsisten, dan perubahan pangkalan data manual yang berisiko. Mengetahui aliran kerja, bahawa migrasi diserahkan ke kawalan sumber, cara memeriksa dan menterbalikkannya, dan bahawa ia juga boleh mengendalikan **transformasi data** (mengisi/migrasi data, bukan sekadar skema) adalah perlu untuk mana-mana projek Django sebenar. Migrasi ialah cara pasukan Django mengembangkan skema pangkalan data mereka secara kolaboratif dan boleh dipercayai sepanjang hayat projek, menjadikan ini bahan teras yang mesti diketahui.