sf-datacloud-retrieve: Data Cloud Retrieve フェーズ

ユーザーが Data Cloud の クエリ、検索、メタデータイントロスペクション を必要とする場合にこのスキルを使用してください: 同期 SQL、ページネーション付き SQL、非同期クエリワークフロー、テーブル describe、ベクトル検索、ハイブリッド検索、または検索インデックス操作。

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

以下の作業が含まれる場合は sf-datacloud-retrieve を使用します:

• sf data360 query *
• sf data360 search-index *
• sf data360 metadata *
• sf data360 profile * または sf data360 insight * 検査
• Data Cloud SQL の結果またはクエリ形状の理解

ユーザーが以下を行っている場合は他にデリゲートします:

• 標準 CRM SOQL のみを作成 → sf-soql
• セグメントまたは計算インサイト資産を設計 → sf-datacloud-segment
• STDM/セッショントレーシング/parquet テレメトリを分析 → sf-ai-agentforce-observability

---

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

以下を確認または推測してください:

• ターゲット組織のエイリアス
• ユーザーが高速カウント、中程度のデータセット、大規模エクスポート、スキーマ検査、またはセマンティック検索を必要としているかどうか
• テーブル/インデックス名 (既知の場合)
• タスクが読み取り専用 SQL か検索インデックスライフサイクル管理か

---

コア運用ルール

• Data Cloud SQL を SOQL ではなく独立したクエリ言語として扱う。
• クエリ/検索サーフェスに依存する前に、共有の準備状況分類器を実行してください: node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json。
• カラムを推測する前に describe を使用してください。
• より大きな結果セットには sqlv2 または非同期クエリフローを優先してください。
• ベクトル検索またはハイブリッド検索は、検索インデックスライフサイクルが健全な場合のみ使用してください。
• STDM/parquet/セッショントレーシングワークフローをこのスキルファミリーから除外してください。

---

推奨ワークフロー

1. Retrieve 作業の準備状況を分類

node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json
# オプション: クエリプレーンプローブ、実際のテーブル名がある場合のみ
node ~/.claude/skills/sf-datacloud/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 ではテーブル名をダブルクォートで囲んでください。
• sqlv2 は中程度の結果セットに対してアドホック OFFSET ページネーションより優れています。
• 大規模な結果には非同期クエリが推奨されます。
• 検索インデックス操作とベクトル/ハイブリッドクエリは、インデックスライフサイクルが健全であることに依存します。
• ハイブリッド検索は --prefilter を使用できますが、検索インデックスが作成されたときにプリフィルター対応として構成されたフィールドでのみ使用できます。
• HNSW インデックスパラメータは通常、作成時は読み取り専用です。プラットフォームが明示的に文書化していない限り、userValues: [] のままにしてください。
• query describe は汎用テナントプローブではありません。より広い準備状況が確認された後、既知の DMO または DLO テーブルでのみ実行してください。

---

出力フォーマット

Retrieve タスク: <sql / sqlv2 / async / describe / vector / search-index>
ターゲット組織: <alias>
ターゲットオブジェクト: <table or index>
コマンド: <実行した主要コマンド>
検証: <クエリ行数 / スキーマ / ステータス>
次のステップ: <segment / harmonize / follow-up>

---

参照

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