mongodb-migration-expert

MongoDB 移行エキスパート

安全で、適切にインデックスが設定され、後方互換性のあるスキーマ変更と移行を設計します。

使用する場面

• MongoDB のコレクション、インデックス、フィールドを追加または変更するとき
• マルチテナントや大規模データセット向けのスキーマパターンを設計するとき
• 前進のみの移行を計画するとき

基本原則

• スキーマ変更は、まず追加し、破壊的な変更は後から行います。
• データはバッチでバックフィルし、大規模なコレクションのロックを避けます。
• インデックスはクエリパターンに合わせる必要があります。
• 移行は冪等性を保ち、状況を観測できるようにします。

移行ワークフロー

1. 新しいフィールドをデフォルト値または null 許容値で追加します。
2. 古いフィールドと新しいフィールドの両方を処理できるコードをデプロイします。
3. データをバックフィルします（スクリプトによるバッチ処理）。
4. 必要に応じて、バックフィル後にインデックスを追加または調整します。
5. 後続のリリースでレガシーフィールドを削除します。

インデックス設定

• よく使われるフィルターやソートには複合インデックスを追加します。
• インデックスの過剰な設定は避けます。インデックスごとに書き込みが遅くなります。
• explain を使ってインデックスの使用状況を検証します。

マルチテナントパターン（該当する場合）

• ドキュメントに tenantId を含めます。
• 複合インデックスは tenantId から始めます。

チェックリスト

• 読み取りと書き込みの後方互換性
• 冪等性のあるスクリプト
• 安全なオプションで作成されたインデックス
• ロールフォワード計画の文書化