データベースマイグレーション

データベースマイグレーションとは？

データベースマイグレーションは、データベースのスキーマ（テーブル構造・カラム定義等）の変更をバージョン管理されたスクリプトとして管理し、順序立てて環境に適用する仕組みです。コードの変更とDB変更を同期させる重要な開発プロセスです。

なぜマイグレーションが必要か？

チーム開発では複数の開発者がDBを変更します。「誰がどの変更を加えたか」「本番環境にどこまで適用済みか」を管理しないと整合性が崩れます。

マイグレーションの流れ

1. マイグレーションファイルを作成（例: 20260408_add_phone_to_users.sql）
2. ローカルで適用・テスト
3. PR・コードレビュー
4. ステージング環境で適用・確認
5. 本番環境で適用

代表的なマイグレーションツール

ツール	対象言語/FW	特徴
Prisma Migrate	TypeScript/Prisma	スキーマファイルから自動生成
Flyway	Java・多言語	SQLベース・シンプル
Liquibase	多言語	XML/YAML/SQL対応
Alembic	Python/SQLAlchemy	Python標準
Rails Migration	Ruby on Rails	フレームワーク標準

ロールバック

マイグレーション失敗時のロールバック（元に戻す）スクリプトも合わせて用意することが推奨されます（ダウンマイグレーション）。

まとめ

マイグレーションは「本番DBを直接変更する」という危険な運用を防ぐための安全弁です。チーム開発では必ず導入してください。