Agent Skills
返回列表
💻

Salesforce Bulk API 同步代理

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/salesforce-bulk-api-sync-agent

技能介绍

解决什么问题

Salesforce批量数据处理常面临原生API的速率限制和复杂认证流程。当需要同步数万条记录时，直接调用REST API会导致频繁的429错误，且手动处理分页、重试逻辑繁琐。传统ETL工具难以灵活适配自定义字段映射和增量同步策略。

核心工作机制

认证层：通过jsforce实现OAuth 2.0 JWT Bearer流程，自动获取并刷新access token。无需手动管理会话ID，特别适合长期运行的同步代理。

批处理引擎：

  • 将CSV数据按Bulk API 2.0要求分块（建议每批5万条）
  • 自动生成Bulk API的Job对象，支持Upsert、Delete、Query三种操作类型
  • 内置异步轮询机制，实时跟踪Job Status直至完成

数据转换层：

  • 自动处理external ID字段映射，避免重复记录插入
  • 支持自定义字段名转换（如Account_Number__c → AccountNumber）
  • 内置CSV转JSON工具链，兼容不同数据源格式

适用边界与注意事项

  • 性能瓶颈：单次批量操作最大支持10万条记录，超大数据量需分片处理
  • 字段兼容性：自定义字段必须提前在Salesforce中创建，否则会触发字段不存在错误
  • 限流策略：共享API限制为15000次/24小时，需监控API Limits Used头部
  • 异步特性：Bulk API 2.0的Job处理时间为分钟级，不适合实时性要求高的场景

使用场景

  • 把 CRM 的历史工单按外部 ID 批量 upsert 到 Salesforce，避免重复插入
  • 将本地数据库的用户表导出为 CSV，通过 Bulk API 增量同步到 Salesforce
  • 清理已注销账号时，用 CSV 调用 Bulk API 批量删除 Salesforce 记录
  • 定期导出 Salesforce 中指定查询条件的 CSV 报表用于归档和离线分析

适合人员

  • 后端工程师：需要给 Salesforce 写批量同步服务，但不熟悉 OAuth JWT 流程
  • 数据工程师：要把外部数据仓库的定期快照灌进 Salesforce，现有脚本限流严重
  • 集成开发工程师：维护多个业务系统与 Salesforce 的同步，需要统一的批量操作方案
  • 运维工程师：通过命令行 REPL 手动验证 Bulk API 的 Job 状态和数据落库情况