用途:处理 Salesforce 数据相关工作,包括记录 CRUD、批量导入/导出、测试数据生成、清理脚本,以及用于验证 Apex、Flow 或集成行为的 data factory 模式。适用场景:使用 sf data CLI 命令、记录创建/更新/删除/upsert/导出、tree 导入导出、生成贴近真实的测试数据、批量数据操作与清理、用于数据播种或回滚的 Apex 匿名脚本。分工:仅编写 SOQL 交给 sf-soql,运行或修复 Apex 测试交给 sf-testing,先部署元数据交给 sf-deploy,探查 schema 与字段交给 sf-metadata。
模式:需先确认是脚本生成(只产出可复用的 .apex、CSV 或 JSON 资产,不触碰 org)还是远程执行(立即在真实 org 中增改记录);用户可能只想生成脚本时,不要假设要远程执行。
使用前需收集:目标对象、org alias(远程执行时)、操作类型(query/create/update/delete/upsert/import/export/cleanup)、预期数据量、数据性质(测试数据、迁移数据或一次性排查数据)、必须先存在的父子关系。
规则:除明确要求本地生成脚本外,sf-data 作用于远程 org 数据;对象与字段须已存在;关注批量行为时测试建议使用 251 条以上记录;创建大量数据前先考虑清理;不要使用真实 PII;简单 CRUD 优先 CLI,确需服务端编排时才用匿名 Apex;元数据缺失则先交由 sf-metadata 或 sf-deploy。
推荐流程:验证前置条件(对象字段、org 认证、父记录);schema 不确定时先做 describe 预检,例如 sf sobject describe --sobject ObjectName --target-org <alias> --json;选择最小正确机制(少量一次性 CRUD 用单记录命令,大量导入导出用 sf data ... bulk,父子播种用 tree 导入导出,可复用测试集用工厂或匿名 Apex);执行或生成资产;校验数量、关系与记录 ID;失败时有限重试(先按主命令形态一次,再修正参数一次,然后重跑 describe 或换机制,不要无限重复同一失败命令);创建数据后给出清理指引,如按 ID、按模式或按创建时间窗口删除,或使用回滚/保存点模式。
常见失败与方向:INVALID_FIELD 多为字段 API 名或 FLS 问题;REQUIRED_FIELD_MISSING 缺少必填字段;INVALID_CROSS_REFERENCE_KEY 父 ID 有误;FIELD_CUSTOM_VALIDATION_EXCEPTION 被校验规则拦截;invalid picklist value 因凭猜测而非 describe 取值;non-writeable field 需从载荷移除;bulk limits/timeouts 说明工具与数据量不匹配。
输出格式:按操作、对象与数量、目标 org 或本地路径、记录 ID/输出文件、校验结果、清理说明的顺序报告。评分为 117+ 为强生产安全流程,104–116 良好,91–103 可接受但建议复核,78–90 存在部分风险模式,低于 78 需修正。具体价格、平台限制与评分细则资料未完整提供。