Djangoマイグレーションの履歴管理｜showmigrationsの使い方を初心者向けに完全解説
生徒
「Djangoでデータベースを触っていたら、マイグレーションって言葉が出てきて混乱しました。履歴って何ですか？」
先生
「マイグレーションは、データベースの設計変更の記録です。Djangoではその履歴を一覧で確認できます。」
生徒
「その履歴はどうやって確認するんですか？」
先生
「showmigrationsというコマンドを使うと、どこまで反映されたか一目で分かります。」
1. Djangoマイグレーションとは何か
Djangoマイグレーションとは、データベースの設計図を変更した履歴を管理する仕組みです。データベースとは、たくさんの情報を表形式で整理して保存する箱のような存在です。Djangoでは、モデルというPythonのクラスを使って、この箱の形を決めます。
設計図を変更するたびに、その変更内容をファイルとして保存するのがマイグレーションです。これにより、いつ、どんな変更をしたのかが分かるようになります。
2. マイグレーション履歴管理の重要性
履歴管理とは、変更の記録を残すことです。ノートに日付と内容を書いていくイメージです。Djangoでは、マイグレーション履歴を管理することで、データベースが正しい状態かどうかを確認できます。
もし履歴が分からないと、どこまで作業が進んでいるのか分からず、トラブルの原因になります。
3. showmigrationsコマンドの基本
showmigrationsは、マイグレーションの履歴一覧を表示するコマンドです。黒い画面で文字を入力するだけで使えます。
python manage.py showmigrations
このコマンドを実行すると、アプリごとにマイグレーションファイルが表示され、実行済みかどうかが分かります。
4. 実行結果の見方をやさしく解説
表示結果には、チェックマークのような記号が付きます。これは「すでにデータベースに反映されている」という意味です。
admin
[X] 0001_initial
[X] 0002_logentry_remove_auto_add
このように表示された場合、adminアプリのマイグレーションはすべて適用済みだと分かります。
5. アプリを指定して確認する方法
特定のアプリだけを確認したい場合もあります。そのときは、アプリ名を指定します。
python manage.py showmigrations blog
これにより、blogアプリだけの履歴が表示され、確認作業がとても楽になります。
6. 未適用マイグレーションの見つけ方
チェックが付いていない行は、まだデータベースに反映されていない変更です。これは、設計図は作ったけれど、まだ箱に反映していない状態です。
blog
[ ] 0003_add_title_field
この状態を見つけたら、migrateコマンドで反映する必要があります。
7. なぜ初心者にshowmigrationsが大切なのか
初心者は、今どこで何をしているのか分からなくなりがちです。showmigrationsを使えば、データベースの状態を目で確認できます。
これは、地図を見ながら道を歩くようなものです。迷わず安心して作業ができます。
8. マイグレーション履歴とDB設計の関係
DB設計とは、データの形を考えることです。Djangoでは、その設計変更がすべてマイグレーション履歴として残ります。
showmigrationsを確認することで、設計の変化を振り返ることができ、安心して開発を進められます。
Djangoエンタープライズ開発の真髄｜大規模システムを支える堅牢なMVTアーキテクチャとセキュリティ設計セミナー
ハローワーク職業訓練講師の実績を持つプロが監修。商用Python開発の「現場の作法」を完全伝授。
Djangoで極める。堅牢な商用アプリケーション設計とMVTモデルの真髄。
本講座では、大規模開発の標準であるDjangoを用いたエンタープライズ開発を学びます。認証、管理画面、ORMなど、Djangoが提供する強力な機能を「なぜ、どう使うのか」という設計的観点から理解し、フルスタック・バックエンドエンジニアとしての地位を確立する60分です。
具体的なワークショップ内容と環境
【つくるもの】
ユーザー認証とデータベース連携を完備した「商用基準の会員制ダッシュボード」を構築。大規模アクセスに耐えうるデータモデリングの基礎を実践します。
【開発環境】
PostgreSQL & Django Debug Toolbarを活用。本番環境を見据えたDB設計と、クエリの最適化（N+1問題の解決）など、テックリード視点の開発を伝授します。
この60分で得られる3つの革新スキル
SQLを意識した効率的なデータ取得。複雑なリレーションをスマートに操る技術をマスターします。
CSRF/XSS対策。プログラミングで最も重要な「ユーザー情報を守る」ための設計思想を習得します。
疎結合で保守性の高いアーキテクチャ。チーム開発で混乱を招かない、綺麗なコードの構造化を学びます。
20名規模を率いる現役PL（プロジェクトリーダー）かつ、ハローワーク等の職業訓練で指導経験を持つ講師陣が、実務で通用するPythonアーキテクチャ設計を体系的に解説。初心者から実務レベルへの「最短到達」を支援します。
