上传工具
上传工具是一个可下载的独立实用程序,可让您将本地数据库和防火墙后面的其他应用程序中的数据上传到 Zoho Analytics。此部分将介绍如何设置上传工具和用于使用此工具的常用配置文件。
重要提示:
我们强烈推荐您使用 Zoho Databridge 从您的本地数据源中导入数据。Zoho Databridge 是一个轻量级的独立实用程序,可帮助您直接从 Zoho Analytics 界面轻松设置导入过程。
下载上传工具
Zoho Analytics 上传工具可从以下 URL 下载。此工具在 Windows、Linux 和 Mac 操作系统中受支持。
下载上传工具 | ||
![]() | ![]() | ![]() |
Mac 用户需注意:
Mac 用户需要在上传工具的 /bin 文件夹的 setEnv.sh 文件中定义以下设置。您下载的上传工具与 Linux 版本的工具相同,但在使用该工具之前,您需要进行以下指定更改。
- 解压缩上传工具文件后,打开终端/命令行并将目录更改为 /bin。
- 在命令提示符中输入以下命令。
- 复制您的系统返回的 java 位置。
- 打开 setEnv.sh 文件,将第 2 行替换为以下代码段。
- 保存 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 - 指定用于访问代理服务器的代理密码。
以下屏幕截图显示了典型的代理配置。
需要在 common_parms .conf 文件中为其他上传方法配置的其他导入设置将在相应的部分中进行讨论。