マイグレーション

概要

マイグレーション（migration）とは、データベースの構造を安全に変更するための仕組み。テーブルを追加したり、カラムを増やしたり、データを移し替えるといった変更を、手順として記録しておくことができる。

「migrate（移住する）」という英単語が語源で、データやデータベースの構造を新しい形に引っ越しさせるイメージ。

なぜ必要なのか

アプリを作っているとき、最初に決めたデータベースの設計を後から変えたくなることがよくある。

たとえば：

• 「ユーザーテーブルにプロフィール画像のカラムを追加したい」
• 「古いカラム名を分かりやすい名前に変えたい」
• 「複数人の開発者が同じDB構造で作業したい」

このとき、直接データベースをいじると何をいつ変えたか記録が残らない。チームメンバーや本番サーバーに同じ変更を漏れなく適用するのも難しくなる。

マイグレーションを使うと、変更手順をコードとして残せるので、誰でも同じ状態を再現できる。

基本的な構造

マイグレーションファイルは通常、変更の「適用（up）」と「元に戻す（down）」の2つをセットで定義する。

-- マイグレーション: usersテーブルにavatarカラムを追加する
ALTER TABLE users ADD COLUMN avatar TEXT DEFAULT ';

ファイル名に日時や連番を付けて管理するのが一般的。

migrations/
  0001_create_users.sql
  0002_add_avatar_to_users.sql
  0003_create_posts.sql

数字の順番に実行することで、データベースが段階的に正しい状態になっていく。

このサイトでの使われ方

このサイトは Cloudflare D1（SQLiteベースのデータベース）を使っており、migrations/ ディレクトリに .sql ファイルとしてマイグレーションを管理している。

新しいテーブルが必要になったときは、新しい番号のSQLファイルを追加して wrangler d1 migrations apply コマンドで適用する。

まとめ

データベースの変更履歴をコードと一緒に管理できるのが最大のメリット。