先生と生徒の会話形式で理解しよう

生徒

「Djangoでデータベースを触っていたら、マイグレーションって言葉が出てきて混乱しました。履歴って何ですか？」

先生

「マイグレーションは、データベースの設計変更の記録です。Djangoではその履歴を一覧で確認できます。」

生徒

「その履歴はどうやって確認するんですか？」

先生

「showmigrationsというコマンドを使うと、どこまで反映されたか一目で分かります。」

1. Djangoマイグレーションとは何か

Djangoマイグレーションとは、データベースの設計図を変更した履歴を管理する仕組みです。データベースとは、たくさんの情報を表形式で整理して保存する箱のような存在です。Djangoでは、モデルというPythonのクラスを使って、この箱の形を決めます。

設計図を変更するたびに、その変更内容をファイルとして保存するのがマイグレーションです。これにより、いつ、どんな変更をしたのかが分かるようになります。

2. マイグレーション履歴管理の重要性

履歴管理とは、変更の記録を残すことです。ノートに日付と内容を書いていくイメージです。Djangoでは、マイグレーション履歴を管理することで、データベースが正しい状態かどうかを確認できます。

もし履歴が分からないと、どこまで作業が進んでいるのか分からず、トラブルの原因になります。

showmigrationsは、マイグレーションの履歴一覧を表示するコマンドです。黒い画面で文字を入力するだけで使えます。


python manage.py showmigrations

このコマンドを実行すると、アプリごとにマイグレーションファイルが表示され、実行済みかどうかが分かります。

表示結果には、チェックマークのような記号が付きます。これは「すでにデータベースに反映されている」という意味です。


admin
 [X] 0001_initial
 [X] 0002_logentry_remove_auto_add

このように表示された場合、adminアプリのマイグレーションはすべて適用済みだと分かります。

特定のアプリだけを確認したい場合もあります。そのときは、アプリ名を指定します。


python manage.py showmigrations blog

これにより、blogアプリだけの履歴が表示され、確認作業がとても楽になります。

チェックが付いていない行は、まだデータベースに反映されていない変更です。これは、設計図は作ったけれど、まだ箱に反映していない状態です。


blog
 [ ] 0003_add_title_field

この状態を見つけたら、migrateコマンドで反映する必要があります。

初心者は、今どこで何をしているのか分からなくなりがちです。showmigrationsを使えば、データベースの状態を目で確認できます。

これは、地図を見ながら道を歩くようなものです。迷わず安心して作業ができます。

DB設計とは、データの形を考えることです。Djangoでは、その設計変更がすべてマイグレーション履歴として残ります。

showmigrationsを確認することで、設計の変化を振り返ることができ、安心して開発を進められます。