上传工具

上传工具是一个可下载的独立实用程序，可让您将本地数据库和防火墙后面的其他应用程序中的数据上传到 Zoho Analytics。此部分将介绍如何设置上传工具和用于使用此工具的常用配置文件。

重要提示：

我们强烈推荐您使用 Zoho Databridge 从您的本地数据源中导入数据。Zoho Databridge 是一个轻量级的独立实用程序，可帮助您直接从 Zoho Analytics 界面轻松设置导入过程。

下载上传工具

Zoho Analytics 上传工具可从以下 URL 下载。此工具在 Windows、Linux 和 Mac 操作系统中受支持。

下载上传工具
Windows 下载	Linux 下载	Mac 下载（请参阅以下注意事项）

Mac 用户需注意：

Mac 用户需要在上传工具的 /bin 文件夹的 setEnv.sh 文件中定义以下设置。您下载的上传工具与 Linux 版本的工具相同，但在使用该工具之前，您需要进行以下指定更改。

解压缩上传工具文件后，打开终端/命令行并将目录更改为 /bin。
在命令提示符中输入以下命令。

whereis java

复制您的系统返回的 java 位置。
打开 setEnv.sh 文件，将第 2 行替换为以下代码段。

export JAVABIN=<paste_your_mac_os_java_location>

示例

export JAVABIN=/usr/bin/java

保存 setEnv.sh 文件。

完成上述更改后，您可以按照本文档的进一步说明开始使用上传工具。

安装

下载后，将 zip 文件解压缩到您选择的目录。打开解压缩文件的文件夹。您将看到它包含以下子文件夹。

bin

bin 文件夹包含从 CSV 文件（GUI/控制台模式）和内部数据库上传数据所需的批处理文件和 shell 脚本。这还可用于设置环境变量。以下是 /bin 目录中文件的简要描述：

CSVUploadGUI.bat / CSVUploadGUI.sh - 该文件包含在 GUI 模式中调用上传工具所需的脚本。
CSVUploadConsole.bat / CSVUploadConsole.sh - 该文件包含在控制台模式中调用上传工具所需的脚本。
UploadFromDB.bat / UploadFromDB.sh - 该文件包含从内部数据库上传数据所需的脚本。
setEnv.bat/ setEnv.sh - 该文件用于设置所需的环境变量。

注：

.bat 文件用于 Windows 机器，.sh 文件用于 Linux 和 Mac 机器。

conf

conf 目录包含此工具的所有配置文件。在执行此工具前，您需要指定相应的配置设置。/conf 目录包含三个文件。它们分别是：

common_params.conf：此配置文件包含为从 CSV 文件或内部数据库推送数据而必须指定的参数。如果您要通过代理服务器连接到互联网，则此文件包含用于配置代理服务器详细信息的连接参数。它还包含从 CSV 文件上传数据时必须配置的导入参数。
database_connection_params.conf：如果要使用该工具连接到您的本地数据库以获取数据并将其上传到 Zoho Analytics，则必须设置此配置文件。此文件还包含本地数据库连接参数，如数据库类型、名称、本地主机名/计算机名、端口、用户名、密码等。
database_sql_queries.xml：如果要使用该工具连接到您的本地数据库以获取数据并将其上传到 Zoho Analytics，还必须设置此配置文件。您需要指定要在本地数据库中执行的 SQL SELECT 查询，以获取要上传到 Zoho Analytics 的所需数据。在此文件中，您还将配置所上传数据在在 Zoho Analytics 中的存储位置，即 Zoho Analytics 数据库名称和表名称。

lib

lib 文件夹包含运行此工具所需的可执行 JAR 文件。

设置：通用设置和代理配置

上传工具在您的本地环境（计算机）中运行，并与云中的 Zoho Analytics 服务联系，以从 CSV 文件或数据库中推送数据。这两种方法有一些共同配置设置。您可以在 /conf/ 目录下的 common_params.conf 文件中配置这些设置，如下所述。

通用设置

在配置文件 common_params.conf 中，有两个名为 REPORT_SERVER_URL 和 IAM_SERVER_URL 的参数。在通过 IAM_SERVER_URL（这是 Zoho 验证服务器的 UR）的验证后，此工具将连接 REPORT_SERVER_URL（这是 Zoho Analytics 服务 URL）。

会为这两个参数提供默认值，如下所示。请勿更改所提供的默认值：

IAM_SERVER_URL= https://accounts.zoho.com.cn
REPORT_SERVER_URL= https://analyticsapi.zoho.com.cn

如果要使用共享用户的用户凭证而不是 Zoho Analytics 管理员或工作区管理员的用户凭证来执行上传工具，则需要提供以下参数。此参数应提供此共享用户所关联的工作区管理员或 Zoho Analytics 管理员的 Zoho Analytics 用户名作为值。

DBOWNERNAME = database_owner_username

代理服务器设置

如果上传工具将通过代理服务器（通常在组织网络中使用）连接到互联网，则需要在 common_params.conf 文件中指定代理服务器的详细信息。

注：

如果您正在使用直接互联网连接，则可以忽略此设置。

要通过代理服务器与互联网连接，您需要在 /conf/common_params.conf 文件中提供以下连接参数。您可以使用 Vi、Vim 或 Notepad 等文本编辑器编辑文件。

USEPROXY - 如果您通过代理服务器进行连接，将此设置为 true。如果您直接连接至互联网，将此设置为 false。默认情况下，此值设置为 false。
PROXYHOST - 指定代理服务器在您的网络中运行的计算机名称或 IP 地址。
PROXYPORT - 指定代理服务器运行所用的端口。
PROXYUSERNAME - 指定用于访问代理服务器的代理服务器用户名。
PROXYUSERNAME - 指定用于访问代理服务器的代理密码。

以下屏幕截图显示了典型的代理配置。