SFDMU：Salesforce 数据迁移的强大工具

2024-09-08 06:36:24作者：平淮齐Percy

项目介绍

SFDX Data Move Utility (SFDMU) 是一款专为 Salesforce 环境设计的高级 SFDX 插件，旨在简化数据在不同 Salesforce 环境（如沙盒、开发、生产等）之间的迁移。该工具不仅支持从其他 Salesforce 组织或 CSV 文件进行数据迁移，还能高效管理各种数据操作，实现多个相关 sObject 在一次运行中迁移。

项目技术分析

SFDMU 的核心技术基于 Salesforce DX (SFDX)，利用 SFDX 的强大功能进行数据操作。它支持多种 CRUD 操作（插入、更新、删除、合并），并能处理复杂的对象关系，包括循环引用。SFDMU 通过一个简单的 export.json 文件进行配置，简化了数据迁移的复杂性。此外，它还提供了高级功能，如自定义字段映射、数据匿名化和复合外部 ID 键支持，进一步增强了其灵活性和实用性。

项目及技术应用场景

SFDMU 适用于多种 Salesforce 数据迁移场景：

开发环境到生产环境的迁移：确保开发环境中的数据与生产环境同步。
沙盒数据刷新：定期将生产数据刷新到沙盒环境中，以便进行测试和开发。
数据备份与恢复：从 Salesforce 组织导出数据到 CSV 文件，或从 CSV 文件导入数据到 Salesforce 组织。
跨组织数据迁移：在不同的 Salesforce 组织之间迁移数据，支持直接的 Org-to-Org 迁移。

项目特点

全面的数据迁移支持：支持直接的 Org-to-Org 数据迁移，无需通过 CSV 文件中转。
多对象和关系管理：能够处理涉及多个对象及其复杂关系的迁移，包括循环引用。
易于使用：通过一个 export.json 文件简化配置过程，降低使用门槛。
安全可靠：所有操作均在本地执行，确保数据安全，无需与云端交互。
高性能：优化数据处理，专注于必要的数据子集，提高迁移效率。
扩展功能：提供自定义字段映射、数据匿名化等高级功能，满足更多定制化需求。

安装与使用

安装步骤

准备环境：按照官方指南安装 Salesforce CLI。

安装插件：

# 卸载旧版本（如果有）
$ sf plugins uninstall sfdmu

# 安装最新版本
$ sf plugins install sfdmu

详细设置（开发者）

对于需要自定义或访问源代码的开发者：

# 克隆仓库
$ git clone https://github.com/forcedotcom/SFDX-Data-Move-Utility
# 进入目录并链接
$ cd SFDX-Data-Move-Utility
$ npm install
$ sf plugins link

迁移配置

通过创建 export.json 文件来设置迁移任务，详细配置指南请参考完整 export.json 格式指南。

以下是一个基本的 export.json 示例，用于合并账户及其相关联系人：

{
    "objects": [
        {
            "operation": "Upsert",
            "externalId": "LastName",
            "query": "SELECT FirstName, LastName, AccountId FROM Contact",
            "master": false
        },
        {
            "operation": "Upsert",
            "externalId": "Name",
            "query": "SELECT Name, Phone FROM Account WHERE Name = 'John Smith'"
        }
    ]
}

迁移执行

在包含 export.json 文件的目录中执行迁移命令：

# 从一个 Salesforce 组织迁移数据到另一个组织
$ sf sfdmu run --sourceusername source.org.username@name.com --targetusername target.org.username@name.com

# 从 Salesforce 组织导出数据到 CSV 文件
$ sf sfdmu run --sourceusername source.org.username@name.com --targetusername csvfile

# 从 CSV 文件导入数据到 Salesforce 组织
$ sf sfdmu run --sourceusername csvfile --targetusername target.org.username@name.com