# カタログに基づくディープマージを実装

保存済みJSON設定にカタログに基づくディープマージを実装し、スキーマ変更時のキー欠落によるクラッシュを防いだ。

2025

**状況.** 通知設定などのJSON設定を、既定値の上に利用者の保存値を重ねる形で保持していた。元のマージは1階層だけだった。既定値に新しいキーを加えると、それ以前の保存行にはキーがなく、クライアントがundefinedを読んで落ちる。長く使っている利用者ほど影響を受ける問題だった。

**課題.** 以前からの利用者に設定の追加で支障が出ないよう、安全にスキーマを拡張する必要があった。

**行動.** 単層のマージを、既定値をカタログにしたディープマージへ置き換えた。存在すべき全キーの正本として既定値を扱い、その上へ利用者の保存値を再帰的に重ねる。保存された塊にあってもなくても、カタログ内のキーは必ず結果に含まれる。既定値に追加すれば、入れ子も含め既存行すべての実効設定へ自動で現れる。再保存を待たず既存データも直ちに恩恵を受けるよう、マイグレーションで導入した。

**結果.** 安心して設定を増やせるようになった。新しい設定の追加が未定義項目によるクラッシュを招かず、フロントエンドで読み取り箇所ごとに防御的な検査を散らす必要もなくなった。1つの修正にとどまらず、保存済みJSON全般を拡張するための、頼れる方式を他の部分にも提供した。

---

- 役割: データベースエンジニア
- カテゴリー: [バックエンド開発](https://data.engineer.company/ja/categories/backend/), [データベース](https://data.engineer.company/ja/categories/databases/), [PostgreSQL](https://data.engineer.company/ja/categories/postgresql/), [データガバナンス](https://data.engineer.company/ja/categories/data-governance/), [移行・モダナイゼーション](https://data.engineer.company/ja/categories/migration/)
- サービス: [バックエンド・API開発](https://data.engineer.company/ja/services/backend-development/), [データベース設計・モデリング](https://data.engineer.company/ja/services/database-design/), [データガバナンス・品質管理](https://data.engineer.company/ja/services/data-governance/)

<https://engineer.company/ja/portfolio/implemented-a-catalogue-driven-deep-merge/>
