如何将文件从Azure Blob Storage迁移至Salesforce

一、可行实现方法及对应操作流程 #

方法1：官方工具组合（适合中小规模文件量，无代码需求） #

• 第一步：从Azure Blob Storage批量导出文件到本地/临时存储
  操作：在Azure Portal中进入对应存储账户的容器页面，选中需要迁移的全部文件点击「下载」批量导出，或者用azcopy命令行工具执行批量导出，命令示例：azcopy copy 'https://<存储账户名>.blob.core.windows.net/<容器名>?<SAS令牌>' '<本地文件夹路径>' --recursive=true
• 第二步：整理文件与对应关联数据
  操作：如果文件需要关联Salesforce中的Account、Case等对象，提前整理好CSV映射表，包含文件本地路径、对应Salesforce对象ID、文件名、文件描述等字段
• 第三步：用Salesforce官方导入工具上传
  操作：进入Salesforce设置页面，搜索「数据导入向导」，选择「文件」作为导入对象，上传整理好的CSV映射表，按照向导提示匹配字段，确认后执行导入即可

适用场景：文件总大小不超过100GB，单文件不超过2GB，技术团队开发资源不足的情况。

方法2：自定义API集成（适合定制化需求高、文件量大的场景） #

• 第一步：分别获取两端的访问权限
  Azure侧：生成具有Blob读取权限的SAS令牌，或者注册Azure AD应用分配存储Blob数据读取者角色；Salesforce侧：创建Connected App，开启API访问权限，获取Client ID、Client Secret、访问令牌，确保对接用户具有「创建文件」的权限
• 第二步：开发迁移脚本/服务
  核心逻辑：调用Azure Blob Storage API读取文件流 -> 调用Salesforce Content Version API上传文件流，同时写入关联对象的关联关系，单文件超过37.5MB时按规则拆分分片逐个上传后合并
• 第三步：校验迁移结果
  对比Azure侧的文件MD5值和Salesforce侧返回的文件校验值，确认文件完整，同时统计成功/失败的文件数量，对失败的文件执行重试

适用场景：需要自动化增量迁移、文件关联逻辑复杂、文件量超过100GB的场景。

方法3：第三方ETL工具（适合中等规模、有标准化迁移需求的场景） #

• 第一步：在ETL工具中分别添加Azure Blob Storage和Salesforce两个数据源，输入两端的访问凭证完成连通性校验
• 第二步：配置迁移任务，选择源端Blob容器、目标端Salesforce Files存储位置，配置字段映射、关联对象匹配规则
• 第三步：设置迁移规则，包括重试次数、错误日志存储位置、是否增量同步，测试小批量文件迁移没问题后执行全量迁移

适用场景：不想投入定制开发成本，同时需要迁移日志、错误追溯能力的场景。

方法4：Salesforce Connect直连（无需物理迁移，适合仅需查看访问的场景） #

如果不需要把文件实际存储到Salesforce，只是需要在Salesforce界面上访问Azure Blob里的文件，可以用这个方案：

• 第一步：在Azure侧为Blob容器配置CORS规则，允许Salesforce域名跨域访问
• 第二步：在Salesforce设置中创建外部数据源，类型选择「Azure Storage」，输入存储账户凭证、容器信息
• 第三步：创建对应外部对象，配置页面布局，用户就可以直接在Salesforce界面查看、下载Azure Blob里的文件，无需迁移

适用场景：存储成本敏感，不需要Salesforce对文件做二次处理（比如流程触发、病毒扫描）的场景。

二、通用注意事项 #

• 存储配额限制：提前确认Salesforce组织的文件存储配额，避免迁移到一半因为配额不足中断，超出配额可以提前申请临时扩容或者采购额外存储
• 文件大小限制：Salesforce单文件上传最大限制为2GB，超过这个大小的文件需要提前拆分或者用外部对象直连的方案
• 权限合规：迁移前后要确认文件的访问权限和原有权限一致，涉及敏感数据的文件要提前做脱敏处理，符合企业数据合规要求
• 增量迁移处理：如果迁移期间业务还在产生新的Azure Blob文件，要提前规划增量迁移逻辑，先全量迁移历史文件，再同步迁移期间新增的文件，最后切流
• 重试机制：网络波动可能导致部分文件上传失败，必须配置重试机制，同时迁移完成后要做全量的文件完整性校验，避免出现文件损坏、缺失的情况
• 并发控制：不要一次性发起过高的并发上传请求，避免触发Salesforce的API限流，建议按照Salesforce官方API限流规则控制并发数在20以内

内容的提问来源于stack exchange，提问作者amigana _34