后端与接口
在 Salesforce Data Cloud 中执行查询…
当需要对 Data Cloud 对象做 SQL 查询、异步查询、向量/混合搜索或表结构探查时,用这套流程替代 SOQL 思路。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在 Salesforce Data Cl特定
解决思路
- 先收集上下文:目标 org alias、需求类型(快速计数/中等结果集/大批量导出/schema 探查/语义搜索)、已知的表或索引名、以及任务是只读 SQL 还是搜索索引生命周期管理。
- 把 Data Cloud SQL 当作独立查询语言处理,不要用 SOQL 的思维。
- 在依赖查询/搜索能力前先运行就绪分类器:node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json;如有真实表名可加 --describe-table MyDMO__dlm 做查询面探测。
- 选择最小可用的查询形态:快速计数用 sf data360 query sql -o <org> --sql 'SELECT COUNT(*) FROM "ssot__Individual__dlm"';中等结果集用 sqlv2;大批量用 async-create。
- 在猜测字段前先用 describe:sf data360 query describe -o <org> --table ssot__Individual__dlm。
- 仅在索引存在且生命周期健康时使用向量或混合搜索:先用 sf data360 search-index list -o <org> 确认,再执行 sf data360 query vector / query hybrid(可带 --prefilter,但仅限创建索引时配置为支持 prefilter 的字段)。
- 创建索引时复用现成示例而非从零编写 JSON:examples/search-indexes/vector-knowledge.json 与 examples/search-indexes/hybrid-structured.json。
- SQL 中表名用双引号包裹;中等结果集优先用 sqlv2 而非临时 OFFSET 分页;大结果集优先用 async query。
- HNSW 索引参数在创建时通常只读,除非平台明确说明,否则保持 userValues: []。
- query describe 不是通用租户探测手段,只有在更广泛就绪性确认后、且已知 DMO 或 DLO 表时才运行。
- 按固定输出格式汇报:Retrieve task、Target org、Target object、Commands、Verification、Next step。
适用边界 · 注意事项
- 只写标准 CRM SOQL 时(应使用 sf-soql)。
- 设计 segment 或 calculated insight 资产时(应使用 sf-datacloud-segment)。
- 分析 STDM/session tracing/parquet 遥测时(应使用 sf-ai-agentforce-observability)。