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

目次

• 概要
• 使用時機
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

バージョン管理、ロールバック機能、データ変換戦略を備えた堅牢なデータベースマイグレーションシステムを実装します。マイグレーションフレームワークと本番環境デプロイメントパターンを含みます。

使用時機

• スキーマバージョニングと進化
• データ変換とクリーンアップ
• テーブルとカラムの追加・削除
• インデックス作成と最適化
• マイグレーションテストと検証
• ロールバック計画と実行
• マルチ環境デプロイメント

クイックスタート

最小限の動作例:

-- Create migrations tracking table
CREATE TABLE schema_migrations (
  version BIGINT PRIMARY KEY,
  name VARCHAR(255) NOT NULL,
  executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  duration_ms INTEGER,
  checksum VARCHAR(64)
);

-- Create migration log table
CREATE TABLE migration_logs (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  version BIGINT NOT NULL,
  status VARCHAR(20) NOT NULL,
  error_message TEXT,
  rolled_back_at TIMESTAMP,
  executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Function to record migration
CREATE OR REPLACE FUNCTION record_migration(
  p_version BIGINT,
  p_name VARCHAR,
  p_duration_ms INTEGER
) RETURNS void AS $$
// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリの詳細な実装:

ベストプラクティス

✅ 実施すること

• 確立されたパターンと慣例に従う
• クリーンで保守性の高いコードを書く
• 適切なドキュメンテーションを追加する
• デプロイ前に十分にテストする

❌ 実施しないこと

• テストと検証をスキップする
• エラーハンドリングを無視する
• 設定値をハードコードする