MDM 参照データ

参照データは DFS MDM のコードと値のガバナンス層です。重要度、状態、単位、故障カテゴリ、設備クラス、地域など、小規模で安定し、バージョン管理すべき値に使用します。

値が実物を表し、複数のソース ID、別名、lineage、人のレビューを必要とする場合は、マスターエンティティとして扱います。

前提

• 表示には dfs:read が必要です。
• 作成または編集には dfs:write が必要です。
• 削除はガバナンス責任を持つユーザーに限定します。
• そのリストの owner または steward を決めます。
• 既存のデータセット、メソッド、レポート、AI ワークフローが現在の値に依存しているか確認します。

画面を開く

Data Integration > DFS Pro > Reference Data

左側に reference sets、右側に選択中の set の values が表示されます。

ライフサイクル

参照データは共有契約として扱います。小さな値の変更に見えても、検証ルール、ソースマッピング、レポート、AI Agent の証跡、steward レビュー画面に影響する場合があります。

reference set を作成する

1. New set を選択します。
2. 安定した key を入力します。
3. 分かりやすい display name を入力します。
4. 保存します。
5. set を選択して values を追加します。

推奨される key の例：

• equipment_status
• fault_severity
• inspection_result
• energy_unit

key は業務ドメインを表し、環境をまたいで安定する名前にします。

value set の例

故障重要度は次のように定義できます。

Code	Label	用途
critical	Critical	即時の運用影響または安全上の懸念。
major	Major	計画的な対応が必要な大きな劣化。
minor	Minor	監視または通常対応で扱う低影響の状態。
info	Information	文脈のみを提供する情報イベント。

運用チームが urgent、critical、high の違いを一貫して説明できない場合、それらを同時に残さないでください。

value を追加する

フィールド	用途
Code	統合や保存で使う安定値。
Label	ユーザー向け表示名。
Valid from	値が有効になる開始日。
Valid to	値の有効終了日。現在値は open にできます。
Order	一覧やレビュー画面での表示順。
Attributes	任意の構造化属性。

属性で正規化ルールを管理する

一部の reference set では、属性に小さな正規化辞書を持たせます。たとえば航空拠点の reference set では、PEK や HGH のような安定コードを標準拠点として使い、ソースシステム側の表記揺れを attrs.aliases に保存できます。

ガバナンス対象のルールを編集可能にしたい一方で、まだ master entity として扱う必要がない場合に、このパターンを使います。

Reference value field	航空拠点の例
Code	PEK のような安定した拠点コード。
Label	北京 のようなユーザー向け拠点名。
Attributes	["北京", "北京航基地"] のような alias リスト。

DFS fusion や governance 画面が同じ reference set を参照する場合、alias の追加や削除は、ソース値が標準コードへ折りたたまれる方法に影響します。他の reference data 変更と同じように、下流の fusion、レポート、AI 証跡を確認してから本番運用の口径として扱います。

API で value attributes を編集し、既存の label、有効期間、表示順を保持したい場合は、それらのフィールドも更新リクエストに含めてください。value 更新エンドポイントは、リクエストされた編集可能フィールドを適用します。

version を上げるタイミング

解釈、検証、下流結果に影響する場合は version を上げます。

• 新しい業務状態を追加する。
• 値を廃止または置き換える。
• label の変更がレビュー理解に影響する。
• 有効期間を変更する。
• 下流データセット、メソッド、レポートに明確な変更境界が必要。

変更影響レビュー

本番で使われている reference set を変更する前に確認します。

影響範囲	レビュー質問
ソースマッピング	現在どの取り込み値がこの code にマッピングされているか。
DFS Pro methods	fusion tasks や validation rules がこの code で絞り込んでいるか。
Steward 画面	レビュアーに表示される label や選択肢が変わるか。
レポート	履歴件数がカテゴリ間で移動するか。
AI Agent 証跡	Agent がこの code で検索、グループ化、説明しているか。
外部統合	連携先が古い code または label を期待しているか。

code を廃止する場合、過去レコードの検証が必要なら削除ではなく履歴の有効期間を残します。

確認項目

• Code は安定しており、それぞれの意味が明確です。
• Label は運用担当者、steward、レポート利用者に分かりやすいです。
• 有効期間により active な値を明確に判定できます。
• 削除または廃止された値が active なマッピングで使われていません。
• owner が依存する下流ワークフローを把握しています。

よくある問題

症状	原因	対処
下流フォームに値が出ない	set が未更新、または環境が違う。	tenant、set key、version を確認します。
レポート分類がおかしい	2 つの code が同じ意味で使われている。	口径を整理し、下流マッピングをレビューします。
過去レコードが無効になる	有効期間変更時に履歴を確認していない。	履歴期間を戻すか、置換値を追加します。
自由入力の揺れが増える	ワークフローが reference set を使っていない。	マッピング、フォーム、メソッド設定を更新します。

次に読む

実物を表すデータで別名、lineage、レビューが必要な場合は Master Entities を参照してください。