Database Migrations

affaan-m/ECC/docs/ja-JP/skills/database-migrations

by affaan-mef648e01899ba3e8dc6371642deaaf64b4477775No license275K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 4 days ago

PostgreSQL、MySQL、一般的なORM（Prisma、Drizzle、Kysely、Django、TypeORM、golang-migrate）全体のスキーマ変更、データマイグレーション、ロールバック、ゼロダウンタイムデプロイメントのためのデータベースマイグレーションベストプラクティス。

Instructions onlySoftware Development DevOps & Cloud

AI-generated overview

Guidance on safe, reversible database schema and data migrations for PostgreSQL, MySQL and common ORMs.

What it does: This skill provides best-practice instructions for planning and applying database migrations, covering schema changes, data backfills, rollbacks and zero-downtime deployment. It includes core principles, a pre-apply safety checklist, and PostgreSQL patterns such as safely adding columns. It produces guidance and checklists rather than executable migration files.
When to use it: Use it when creating or altering tables, adding or removing columns or indexes, running data migrations, planning zero-downtime schema changes, or setting up migration tooling for a new project.
Requirements: No tools, packages or credentials are required; it is instructions only and ships no scripts.

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

本番環境システム用の安全で可逆的なデータベーススキーマ変更。

アクティベーション時期

データベーステーブルの作成または変更
列またはインデックスの追加/削除
データマイグレーション（バックフィル、変換）の実行
ゼロダウンタイムスキーマ変更を計画
新しいプロジェクト用のマイグレーションツール設定

コア原則

すべての変更はマイグレーション — 本番環境データベースを手動で変更しない
マイグレーションは本番環境で前方のみ — ロールバックは新しい前向きマイグレーション使用
スキーマとデータマイグレーションは分離 — 1つのマイグレーションでDDLとDMLを混ぜない
本番環境サイズのデータに対してマイグレーションをテスト — 100行で機能するマイグレーション10M上でロックされる場合がある
マイグレーションは展開後は不変 — 本番環境で実行されたマイグレーションを編集しない

マイグレーション安全チェックリスト

マイグレーションを適用する前に：

マイグレーションはUPとDOWNの両方を持つ（または明示的に不可逆としてマーク）
大型テーブルの完全テーブルロックなし（並行操作使用）
新しい列はデフォルトまたはnullable（デフォルトなしでNOT NULLを追加しない）
インデックスは並行して作成（既存テーブルのCREATE TABLEでインライン化しない）
データバックフィルはスキーマ変更から分離したマイグレーション
本番環境データのコピーに対してテスト
ロールバック計画を文書化

PostgreSQL パターン

列を安全に追加

sql

-- GOOD: Nullable列、ロックなしALTER TABLE users ADD COLUMN avatar_url TEXT;
-- GOOD: デフォルト付きの列（Postgres 11+は即座、書き直しなし）ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;
-- BAD: 既存テーブルのデフォルトなしで NOT NULL（完全書き直し必須）ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL;

-- GOOD: Nullable列、ロックなしALTER TABLE users ADD COLUMN avatar_url TEXT;
-- GOOD: デフォルト付きの列（Postgres 11+は即座、書き直しなし）ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;
-- BAD: 既存テーブルのデフォルトなしで NOT NULL（完全書き直し必須）ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL;

詳細についてはドキュメントを参照してください。

Source and attribution

Source:affaan-m/ECCindocs/ja-JP/skills/database-migrationsat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Database Migrations

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

アクティベーション時期

コア原則

マイグレーション安全チェックリスト

PostgreSQL パターン

列を安全に追加

Source and attribution

More from affaan-m/ECC

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices