data360-query

data360-query：Data Cloud 検索フェーズ

Data Cloud のクエリ、検索、メタデータのインスペクションが必要な場合は、このスキルを使用します。対象となる操作は、同期 SQL、ページネーション付き SQL、非同期クエリのワークフロー、テーブルの説明、ベクトル検索、ハイブリッド検索、検索インデックスの操作です。

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

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

• sf data360 query *
• sf data360 search-index *
• sf data360 metadata *
• sf data360 profile * または sf data360 insight * のインスペクション
• Data Cloud の SQL 結果やクエリの形式の把握

次の場合は、ほかのスキルに委任します。

• 標準的な CRM SOQL のみを記述する場合 → platform-soql-query
• セグメントや計算済みインサイトのアセットを設計する場合 → data360-segment
• STDM／セッションのトレース／parquet のテレメトリを分析する場合 → agentforce-observe

---

最初に収集する必須コンテキスト

次の情報を確認するか、推測してください。

• 対象の組織エイリアス
• ユーザーが必要としているのが、簡易な件数、中規模の結果セット、大規模なエクスポート、スキーマのインスペクション、セマンティック検索のいずれか
• 判明している場合はテーブル名／インデックス名
• タスクが読み取り専用 SQL か、検索インデックスのライフサイクル管理か

---

基本的な運用ルール

• Data Cloud SQL は SOQL ではなく、独自のクエリ言語として扱います。
• クエリ／検索機能を利用する前に、共通の準備状況分類を実行します：node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase retrieve --json。
• カラムを推測する前に describe を使用します。
• 大きな結果セットには、sqlv2 または非同期クエリのフローを優先します。
• 検索インデックスのライフサイクルが正常な場合に限り、ベクトル検索またはハイブリッド検索を使用します。
• STDM／parquet／セッションのトレースに関するワークフローは、このスキルファミリーの対象外です。

---

推奨ワークフロー

1. 検索作業に向けて準備状況を分類する

node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase retrieve --json
# optional query-plane probe, only with a real table name
node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json

2. 要件を満たす最小限のクエリ形式を選ぶ

sf data360 query sql -o <org> --sql 'SELECT COUNT(*) FROM "ssot__Individual__dlm"' 2>/dev/null
sf data360 query sqlv2 -o <org> --sql 'SELECT * FROM "ssot__Individual__dlm"' 2>/dev/null
sf data360 query async-create -o <org> --sql 'SELECT * FROM "ssot__Individual__dlm"' 2>/dev/null

3. フィールドを推測する前に describe を使用する

sf data360 query describe -o <org> --table ssot__Individual__dlm 2>/dev/null

4. インデックスが存在する場合に限り、ベクトル検索またはハイブリッド検索を使用する

sf data360 search-index list -o <org> 2>/dev/null
sf data360 query vector -o <org> --index Knowledge_Index --query "reset password" --limit 5 2>/dev/null
sf data360 query hybrid -o <org> --index Knowledge_Index --query "reset password" --limit 5 2>/dev/null
sf data360 query hybrid -o <org> --index Insurance_Index --query "weather damage coverage" --prefilter "Type_of_Insurance__c='Home'" --limit 10 2>/dev/null

5. インデックスを作成する際は、精選された検索インデックスの例を再利用する

JSON を一から考案するのではなく、このフェーズ用の例を使用します。

• examples/search-indexes/vector-knowledge.json
• examples/search-indexes/hybrid-structured.json

---

特に注意すべき点

• Data Cloud SQL は SOQL ではありません。
• SQL ではテーブル名を二重引用符で囲む必要があります。
• 中規模の結果セットには、場当たり的な OFFSET ページネーションより sqlv2 が適しています。
• 大規模な結果には、非同期クエリが適しています。
• 検索インデックスの操作とベクトル／ハイブリッドクエリは、インデックスのライフサイクルが正常であることを前提とします。
• ハイブリッド検索では --prefilter を使用できますが、検索インデックスの作成時に事前フィルター対応として設定されたフィールドに限られます。
• HNSW インデックスのパラメーターは、通常、作成時には読み取り専用です。プラットフォームで明示的に別の方法が記載されていない限り、userValues: [] のままにしてください。
• query describe は、すべてのテナントで使える調査方法ではありません。より広範な準備状況を確認した後、既知の DMO または DLO テーブルに対してのみ実行してください。

---

出力形式

Retrieve task: <sql / sqlv2 / async / describe / vector / search-index>
Target org: <alias>
Target object: <table or index>
Commands: <key commands run>
Verification: <query rows / schema / status>
Next step: <segment / harmonize / follow-up>

---

参考資料

• examples/search-indexes/vector-knowledge.json
• examples/search-indexes/hybrid-structured.json
• ../data360-orchestrate/assets/definitions/search-index.template.json
• ../data360-orchestrate/references/plugin-setup.md
• ../data360-orchestrate/references/feature-readiness.md