用途:处理 Salesforce 数据操作,包括数据迁移、沙箱播种、批量数据加载、数据导出与数据清理。
主要能力:使用 sf data query 查询并导出 CSV/JSON,支持 --bulk 处理大数据集;使用 sf data import tree 按计划导入并保留对象关系;使用 sf data upsert bulk 按外部 ID 执行批量 upsert;使用 sf data delete bulk 批量删除;通过匿名 Apex(sf apex run)完成复杂数据初始化;支持 ContentVersion 文件迁移。
使用方式:先确认目标组织连接,分析对象、关系与数据量,导出或生成源数据,按正确对象顺序创建导入计划,再选择 tree、bulk 或匿名 Apex 执行,最后校验数据完整性。示例命令:sf data query -q "SELECT Id, Name FROM Account" --target-org myOrg --bulk;sf data upsert bulk -s Account -f accounts.csv -i External_Id__c --target-org myOrg。
适用场景:跨组织数据迁移、沙箱测试数据播种、大批量数据加载与导出、临时数据清理。
限制与注意事项:Bulk API 2.0 适用于超过 2000 条记录的数据集,作业超时为 ingest 10 分钟、query 15 分钟,单 CSV 最大 150 MB,24 小时滚动窗口最多 1.5 亿条记录;主从关系父记录必须先于子记录插入;外部 ID 字段不能被 Data Mask 掩码;自引用记录需两遍加载;多态查找导出需 TYPEOF;ContentVersion 必须同时提供 PathOnClient 与 VersionData;Bulk API 2.0 即使单条记录失败也可能返回作业成功,需检查结果;Data Loader 会静默截断超长字段值。执行破坏性操作前应备份数据,测试查询时使用 --dry-run 或 LIMIT。