# 先决条件

以下部分描述了在 Qlik Talend Cloud Data Integration 中将 Teradata 用作源的先决条件。

## 适用于 Windows 的 Replicate Server

安装适用于 Windows 的 Teradata Database ODBC 驱动程序 17.20 或 20.00。

从 [Teradata 下载中心](https://downloads.teradata.com/download/connectivity/odbc-driver/windows) 下载驱动程序。

## 适用于 Linux 的 Replicate Server

以下步骤介绍了如何在 Linux 数据移动网关上将 Teradata 作为源使用。Teradata Database Client 需要随客户端提供的 DataDirect ODBC 驱动程序管理器。

信息注释

本说明假定 Teradata Database Client 20.00 已安装在 /opt/teradata/client/20.00 中。如果您安装其他版本或使用不同的位置，请相应更改路径。

1. 停止 Data Movement gateway 服务并确认其已停止。

2. 安装适用于 Linux 的 Teradata Database Client 20.00 或更早版本。

   从 https://downloads.teradata.com/download/connectivity/odbc-driver/linux 下载驱动程序。

3. 将下载的客户端软件包复制到 /opt/qlik/gateway/movement/drivers/teradata 并运行 install teradata。

4. 设置以下环境变量：

   `TD_CLIENT=/opt/teradata/client/20.00/odbc_64/lib:/opt/teradata/client/17.20/lib64; export TD_CLIENT`

   `ODBCINI=/opt/teradata/client/20.00/odbc_64/odbc.ini; export ODBCINI`

   `ODBCINST=/opt/teradata/client/20.00/odbc_64/odbcinst.ini; export ODBCINST`

5. 设置库路径：

   `LD_LIBRARY_PATH=$TD_CLIENT:/opt/qlik/gateway/lib:/lib64:/usr/lib64; export LD_LIBRARY_PATH`

6. 运行 `echo $LD_LIBRARY_PATH` 以验证路径已更新。

7. 将导出命令添加到网关服务登录脚本中，以便在服务重启后可用。

8. 启动 Data Movement gateway 服务并确认其已启动。

信息注释

任务不能使用需要不同 ODBC 驱动程序管理器的端点。Teradata 源使用 DataDirect ODBC 驱动程序管理器，而大多数 Linux 目标使用 unixODBC。当任务将 DataDirect 源与需要 unixODBC 的目标结合使用时，请使用 Qlik Replication 文件通道。

在配置 Teradata 源之前，请将 Teradata Database 主机和数据库映射添加到网关计算机上的 hosts 文件中。有关操作步骤，请参阅 [编辑 hosts 文件](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/Teradata/teradata-hosts-file.htm)。

本部分介绍如何安装所需的 driver。这个过程包括下载 driver，将其复制到所需的文件夹（见下文），并运行一个脚本来自动安装和配置它。您还可以根据需要运行脚本来更新和卸载 driver。

### 准备安装

* 请确保在 数据移动 网关服务器上安装了 Python 3.6 或更高版本。

  Python 预装在大多数 Linux 发行版上。您可以通过运行以下命令来检查系统上安装了哪个 Python 版本。

  python3 --version

### 安装 driver

安装 driver ：

1. 停止 数据移动网关 服务：

   sudo systemctl stop repagent

2. 可选择确认服务已停止：

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

4. 然后运行以下命令：

   语法：

   ./install teradata

   否则，将显示 driver 的 EULA。

5. 执行以下选项之一：

   * 重复按 [Enter] 可在 EULA 中缓慢滚动。
   * 重复按空格键可快速滚动 EULA。
   * 按 q 退出许可证文本并显示 EULA 接受选项。

6. 执行以下选项之一：

   * 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。

   * 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。

   * 键入“v”并按 [Enter] 以再次查看 EULA。

   将会安装 driver。

7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

   sudo systemctl start repagent

8. 可选择确认服务已启动：

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 更新 driver

如果要在安装提供的 driver 之前卸载以前版本的 driver，请运行 update 命令。

更新 driver：

1. 停止 数据移动网关 服务：

   sudo systemctl stop repagent

2. 可选择确认服务已停止：

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

4. 然后运行以下命令：

   语法：

   ./update teradata

   否则，将显示 driver 的 EULA。

5. 执行以下选项之一：

   * 重复按 [Enter] 可在 EULA 中缓慢滚动。
   * 重复按空格键可快速滚动 EULA。
   * 按 q 退出许可证文本并显示 EULA 接受选项。

6. 执行以下选项之一：

   * 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
   * 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
   * 键入“v”并按 [Enter] 可从头开始查看 EULA。

   将卸载旧的 driver，并安装新的 driver。

7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

   sudo systemctl start repagent

8. 可选择确认服务已启动：

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 卸载 driver

如果要卸载 driver，请运行 uninstall 命令。

卸载 driver：

1. 停止所有配置为使用此连接器的任务。

2. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

3. 然后运行以下命令：

   语法：

   ./uninstall teradata

   将卸载 driver。

## 提供账户访问权限

连接器定义中指定的用户必须是有效的 Teradata Database 用户，并拥有读取源表以及执行任务所使用的变更处理操作所需的权限。

有关 Teradata 安全性和访问要求的更多信息，请参阅 Teradata 源的 Qlik Replicate 用户指南。