mcpField
D
data360-harmonize

data360-harmonize

github.com/forcedotcomデータ・データベース1.1k3.8k 回インストール1 日前に更新
リポジトリ

data360-harmonize について

data360-harmonizeは、Salesforce Data CloudでDMO、マッピング、ID解決、データグラフを使い、スキーマ調整とデータ統合を行うスキルです。実行前にスキーマやマッピングを確認し、ID解決ジョブを進められます。

主な機能

  1. 01DMOスキーマとカタログの確認
  2. 02DLOからDMOへのマッピング確認
  3. 03ID解決ルールセットの作成と実行
  4. 04データグラフと統合プロファイルの操作
  5. 05変更前の準備状況確認

活用シーン

  1. 01取り込み済みDLOを対象DMOにマッピング
  2. 02既存のID解決ルールセットを確認
  3. 03マッピング済みデータから統合プロファイルを準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/forcedotcom/sf-skills --skill data360-harmonize

インストール後、Claude Code で/data360-harmonizeを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

data360-harmonize：Data Cloud のハーモナイズフェーズ

ユーザーが スキーマのハーモナイズと統合に関する作業（DMO、項目マッピング、リレーションシップ、ID 解決、統合プロファイル、データグラフ、ユニバーサル ID の検索）を必要としている場合に、このスキルを使用します。

このスキルが担当するタスク

次の作業には data360-harmonize を使用します。

  • sf data360 dmo *
  • sf data360 identity-resolution *
  • sf data360 data-graph *
  • sf data360 profile *
  • sf data360 universal-id lookup

次の作業は、別のスキルに委任します。

  • ストリームの取り込み中、または DLO の構築中 → data360-prepare
  • セグメントロジックまたは計算済みインサイトの作業 → data360-segment
  • SQL、describe、または検索インデックスのワークフローの実行 → data360-query

最初に収集する必要があるコンテキスト

次の情報を確認するか、推測します。

  • ソース DLO とターゲット DMO の名前
  • 作業がスキーマ作成、マッピング、IR、データグラフ関連のいずれか
  • ターゲット組織のエイリアス
  • ルールセットがすでに存在するかどうか
  • ユーザーが希望する統合エンティティモデル

基本的な運用ルール

  • マッピングを作成する前に DMO スキーマを確認します。
  • ハーモナイズのアセットを変更する前に、共通の準備状況分類ツールを実行します。node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
  • カタログを参照するときは dmo list --all を優先します。ただし、準備状況をすばやく確認する場合は、最初のページを表示する dmo list を使用します。
  • サポートされていない describe の手順を独自に作成せず、query describe または dmo get --json を使用します。
  • ID 解決の実行は非同期として扱い、実行後に結果を確認します。
  • 統合プロファイルの作業と、STDM／セッションのトレース作業は分けて扱います。

推奨ワークフロー

1. ハーモナイズ作業の準備状況を分類する
node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
2. カタログを確認する
sf data360 dmo list --all -o <org> 2>/dev/null
sf data360 identity-resolution list -o <org> 2>/dev/null
3. マッピングの前にスキーマを確認する
sf data360 query describe -o <org> --table ssot__Individual__dlm 2>/dev/null
sf data360 dmo get -o <org> --name ssot__Individual__dlm --json 2>/dev/null
4. 意図を持ってマッピングを作成または確認する
sf data360 dmo mapping-list -o <org> --source Contact_Home__dll --target ssot__Individual__dlm 2>/dev/null
sf data360 dmo map-to-canonical -o <org> --dlo Contact_Home__dll --dmo ssot__Individual__dlm --dry-run 2>/dev/null
5. 信頼できるマッピングが揃ってから IR を実行する
sf data360 identity-resolution create -o <org> -f ir-ruleset.json 2>/dev/null
sf data360 identity-resolution run -o <org> --name Main 2>/dev/null

特に注意すべき点

  • 通常、dmo list には --all を指定します。
  • query describe または dmo get --json を使用します。dmo describe コマンドはありません。
  • マッピングや関連コマンドは、API バージョンの違いに影響される場合があります。
  • 統合 DMO の名前は、汎用ではなくルールセットごとに異なります。
  • データグラフの定義は、項目の選択やリレーションシップの形状に影響されます。
  • dmo list が機能しても identity-resolution list の利用が制限される場合は、Data Cloud 全体の障害ではなく、フェーズ固有の問題として扱います。

出力形式

Harmonize task: <dmo / mapping / relationship / ir / data-graph>
Source/target: <dlo → dmo or ruleset/graph names>
Target org: <alias>
Artifacts: <json files / commands>
Verification: <passed / partial / blocked>
Next step: <segment / retrieve / follow-up>

参考資料

コメント

Markdown 対応