# 先决条件

在登陆或复制数据之前，请确保达成以下先决条件：

* 在 数据移动网关 服务器上安装所需的 driver

  信息注释

  只有当您选择使用 数据移动网关 时，才需要这样。有关 数据移动网关 的优势和何时需要它的信息，请参阅 [Qlik Data Gateway - Data Movement](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。

* 授予数据源所需的权限

* 配置数据源连接器

## 驱动程序设置

您可以使用驱动程序安装实用程序（推荐）安装 driver 或手动安装。只有在您遇到驱动程序安装实用程序发生问题的少见情况下，才应尝试手动安装。

### 使用驱动程序安装实用程序安装驱动程序

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

### 准备安装

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

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

  python3 --version

* 从 [SAP 软件下载中心](https://support.sap.com/en/my-support/software-downloads.html) 下载适用于 Linux 的 SAP HANA ODBC 64 位驱动程序 2.0.19 至 2.12，并将文件 IMDB\_CLIENT\_<version number>.SAR 和 SAPCAR\_<version number>.EXE 复制到：

  /opt/qlik/gateway/movement/drivers/saphana

### 安装 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 saphana

   将会安装 driver。

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

   sudo systemctl start repagent

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

   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 saphana

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

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

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 卸载 driver

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

卸载 driver：

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

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

   opt/qlik/gateway/movement/drivers/bin

3. 然后运行以下命令：

   语法：

   ./uninstall saphana

   将卸载 driver。

### 手动安装驱动程序

只有在自动驱动程序安装未成功完成的情况下，才应尝试手动安装 driver。

从 [SAP 软件下载中心](https://support.sap.com/en/my-support/software-downloads.html)下载 SAP HANA ODBC 64 位驱动程序 2.0.19-2.12。您必须拥有 SAP 帐户才能下载软件。

信息注释

SAP HANA ODBC 驱动程序 2.13 及更新版本不受支持。

示例驱动程序名称：HDBODBC

然后，在 数据移动网关 机器上，打开 shell 提示符并执行以下操作：

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

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 数据移动网关 计算机上安装驱动程序。

4. 将以下部分添加到 `odbcinst.ini` 文件，该文件位于目录`/etc`：

   `[HDBODBC]` `
   Description=64-bit HANA ODBC Driver` `
   Driver=/opt/sap/hdbclient/libodbcHDB.so` `
   fileUsage=1`

5. 启动 数据移动网关 服务：

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 使用 SSL 连接

要使用 SSL 连接到 SAP HANA，必须将客户端配置为验证 SSL 服务器证书。

* 对于服务器身份验证，请按照[服务器证书身份验证](https://help.sap.com/docs/SAP_HANA_CLIENT/f1b440ded6144a54ada97ff95dac7adf/a95754380f4c4c05b728524f9cd652e3.html)中的说明进行操作。

* 对于相互身份验证，请按照[实施相互身份验证](https://help.sap.com/docs/SAP_HANA_CLIENT/f1b440ded6144a54ada97ff95dac7adf/02f21560bbc1495483373d266f7e1fc7.html)中的说明进行操作。当使用 OpenSSL 作为加密提供程序时，您必须通过在加密提供程序下执行 OpenSSL 的额外步骤来完成配置。

## 端口

在 数据移动网关 计算机上，打开 SAP HANA 服务器的入站端口号 `3xx15`，其中 `xx` 是包含源表的 SAP HANA 数据库的实例号。

例如，实例 `90` 的端口将为 `39015`。

## 捕获数据更改

使用 SAP Hana（数据库）连接器登陆数据时，将在源数据库中自动创建以下人工痕迹：

* 为登陆的每个源表创建三个触发器：触发器捕获对源表（INSERT、UPDATE 和 DELETE）的更改，并将其写入 attrep\_cdc\_changes\_cts 表（如下所述）。为每个 DML 操作创建单独的触发器。触发器在源表模式中创建。
* attrep\_cdc\_changes\_cts：此表包含触发器捕获的更改。该表将以 SAP HANA（数据库）连接器的在模式中创建 CDC 表字段中指定的模式中创建。

信息注释虽然从用户的角度来看不需要设置，但触发器是捕获更改的先决条件，这就是本主题中描述它们的原因。

另请参阅： [权限](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-HANA/security_req_saphana.htm)