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 を作成する
- New set を選択します。
- 安定した key を入力します。
- 分かりやすい display name を入力します。
- 保存します。
- set を選択して values を追加します。
推奨される key の例:
equipment_statusfault_severityinspection_resultenergy_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 | 任意の構造化属性。 |
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 を参照してください。