Salesforce 数据加载器技术文档

1. 安装指南

系统要求

• Java 运行环境 (JRE)：安装和运行数据加载器需要 JRE。请查阅最新版本的安装说明以获取所需的 JRE 版本。

支持的操作系统

• 数据加载器官方支持 Windows 和 macOS。其他所有操作系统均不受支持。具体支持的 macOS 和 Windows 版本以及 CPU 架构请参见对应版本的发行说明。

安装步骤

• Windows 和 macOS： 请按照以下链接中的说明进行安装：

  • macOS 安装指南
  • Windows 安装指南

• Linux：

  1. 解压数据加载器 zip 文件
  2. 将 install.command 重命名为 install.sh
  3. 在终端中运行以下命令：./install.sh

2. 项目使用说明

运行 GUI 模式

• Windows 和 macOS： 请按照文档中的说明运行数据加载器。
• Linux： 在命令行中输入以下命令：

  ./dataloader.sh
  

  或者

  java -jar dataloader-x.y.z.jar
  

运行批处理模式

• Windows： 请参考Windows 批处理模式中的说明。
• Linux： 执行以下命令：

  ./dataloader_console <配置文件夹包含 process-conf.xml 和 config.properties 文件> <进程名称> run.mode=batch
  

  或者

  java -jar dataloader-x.y.z.jar <配置文件夹包含 process-conf.xml 和 config.properties 文件> <进程名称> run.mode=batch
  

3. 项目 API 使用文档

本项目提供的命令行工具用于创建加密密钥文件、加密密码或解密密码。

创建加密密钥文件

执行以下命令以在 macOS 或 Linux 上生成加密密钥文件：

./dataloader_console -k [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -k [<加密密钥文件>] run.mode=encrypt

加密密码

执行以下命令以在 macOS 或 Linux 上加密密码：

./dataloader_console -e <明文密码> [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -e <明文密码> [<加密密钥文件>] run.mode=encrypt

解密密码

执行以下命令以在 macOS 或 Linux 上解密密码：

./dataloader_console -d <加密密码> [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -d <加密密码> [<加密密钥文件>] run.mode=encrypt

4. 项目安装方式

通过以下方式之一安装数据加载器：

• 通过 Git：

  git clone [e-mail]:forcedotcom/dataloader.git
  cd dataloader
  git submodule init
  git submodule update
  mvn clean package -DskipTests
  

  或者

  ./dlbuilder.sh
  

完成后，会在本地 Git 克隆的根目录下生成 dataloader_v<x.y.z>.zip 文件。

• 通过 IDE 远程调试： 在 Git 克隆的根目录下运行以下命令：

  ./rundl.sh -d
  

  或者

  java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005 -cp target/dataloader-x.y.z.jar com.salesforce.dataloader.process.DataLoaderRunner salesforce.config.dir=./configs