# 必要條件

在您可以登陸或複寫資料之前，確認完成下列先決條件：

* 在 資料移動閘道 伺服器安裝必要 driver

  資訊備註

  只有在您選擇使用 資料移動閘道 時，才需要此。如需關於 資料移動閘道 福利以及何時需要的資訊，請參閱 [Qlik 資料閘道 - 資料移動](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。

* 在資料來源授予必要權限

* 設定資料來源連接器

## 驅動程式的設定

您可以使用驅動程式安裝公用程式 (建議) 或手動安裝 driver。只能在不太可能發生的事件 (您在使用驅動程式安裝公用程式時遇到問題) 中嘗試手動安裝。

### 使用驅動程式安裝公用程式來安裝驅動程式

此區段描述如何安裝所需的 driver。該流程涉及下載 driver、複製到所需的資料夾 (見下文)，以及執行將會自動安裝並設定該驅動程式的指令碼。您也可以執行指令碼，以根據需求更新並解除安裝 driver。

### 準備安裝

* 確認 Python 3.6 或更高版本安裝於 Data Movement 閘道伺服器。

  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. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 Data Movement 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

4. 執行下列命令：

   語法：

   ./install saphana

   將會安裝 driver。

5. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

   sudo systemctl start repagent

6. 可自行選擇確認服務已開始：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

### 更新 driver

若您想要在安裝提供的 driver 之前解除安裝先前的 driver 版本，請執行更新命令。

若要更新 driver：

1. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 Data Movement 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

4. 執行下列命令：

   語法：

   ./update saphana

   將會解除安裝舊版 driver，並安裝新版 driver。

5. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

   sudo systemctl start repagent

6. 可自行選擇確認服務已開始：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

### 解除安裝 driver

若您想要解除安裝 driver，請執行解除安裝命令。

若要解除安裝 driver：

1. 停止設定為使用此連接器的所有任務。

2. 在 Data Movement 閘道機器上，將工作目錄變更為：

   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

接著在 Data Movement gateway 機器上，開啟 shell prompt 並進行以下項目：

1. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 將驅動程式安裝在 Data Movement gateway 機器。

4. 將以下區段新增至位於目錄 `/etc` 的 `odbcinst.ini`檔案：

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

5. 開始 Data Movement gateway 服務：

   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 作為 crypto 供應商時，您必須透過在 Crypto 供應商底下進行 OpenSSL 的額外步驟完成設定。

## 連接埠

在 Data Movement gateway 機器上，開啟傳入連接埠號碼 `3xx15` 給 SAP HANA 伺服器，其中 `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-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-HANA/security_req_saphana.htm)