マイグレーションはどのように機能しますか？

Question

Accepted Answer

**マイグレーション**は、モデルに加えた変更（フィールドの追加、モデルの作成）をデータベーススキーマに反映させるDjangoの方法です。これらはバージョン管理されており、自動生成されるデータベース変更ファイルです。Pythonでモデルを変更すると、マイグレーションがデータベースを同期状態に保ちます。 ## 2段階のワークフロー ```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`はモデル変更を検出してマイグレーションファイルを生成し、`migrate`は保留中のマイグレーションを実際のデータベースに適用します。Pythonを書き（モデルの変更）、Djangoがそれに対応するSQLを生成して実行します。 ## マイグレーションファイルはバージョン管理されたコード ```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), ), ] ``` マイグレーションはバージョン管理にコミットされるため、データベーススキーマの履歴はコードと並行して追跡されます。すべての開発者と環境が同じマイグレーションを適用して、同じスキーマに達します。これにより、再現性と一貫性が確保されます。 ## なぜ重要なのか（手動SQLとの比較） ```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 ``` ## 便利なコマンドと概念 ```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 ``` ## データマイグレーション（スキーマだけでなく） ```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. ``` ## なぜそれが重要なのかマイグレーションはDjangoのデータベースレイヤーを扱う際に不可欠です。マイグレーションは、データベーススキーマとPythonモデルを安全で再現可能でチーム向けの方法で同期状態に保つという重要な問題を解決します。これらを理解することは基本的な日常知識です。`makemigrations`→`migrate`ワークフローは、スキーマ変更がどのように行われるか（モデルを変更すると、Djangoがそれに対応するSQLを生成して適用する）を示しており、データドリブンなDjangoアプリを開発することはできません。主な価値は、マイグレーションがスキーマ変更をバージョン管理できる（コードと並行して追跡され、プルリクエストでレビュー可能）、再現可能（すべての環境—各開発者のマシン、ステージング、本番環境—同じマイグレーションを実行して同じスキーマに到達する）、安全（Djangoは正しく、多くの場合可逆的なSQLを生成するため、エラーが起きやすい手動の`ALTER TABLE`文が不要）にすることです。これは、スキーマドリフト、環境の不一致、危険な手動データベース変更に関連する問題の全カテゴリーを排除します。ワークフロー、マイグレーションがソースコントロールにコミットされること、マイグレーションを検査してロールバックする方法、マイグレーションがデータ変換（データの埋め込みまたは移行、単なるスキーマではなく）も処理できることを知ることは、実際のDjangoプロジェクトには必要です。マイグレーションは、Djangoチームがプロジェクトの存続期間にわたって協力的かつ確実にデータベーススキーマを進化させる方法であり、このコアな、必須の知識を作成します。