# 前提条件

データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。

* Data Movement gateway サーバーに、必要な driver をインストールする

  情報メモ

  これは、Data Movement gateway を使用することを選択した場合のみ必要です。Data Movement gateway の利点と必要なタイミングについては、[Qlik データ ゲートウェイ - データ移動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm) を参照してください。

* データ ソースに必要な権限を付与する

* データ ソースのコネクタを構成する

## ドライバーのセットアップ

driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。

### ドライバー インストール ユーティリティを使用したドライバーのインストール

このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、driver をダウンロードし、必要なフォルダー (以下を参照) にコピーし、自動的にインストールして設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。

### インストールの準備

* データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。

  Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。

  python3 --version

* [SAP ソフトウェアダウンロードセンター](https://support.sap.com/en/my-support/software-downloads.html)から、SAP HANA ODBC 64-bit Driver for Linux 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. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   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. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   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. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   opt/qlik/gateway/movement/drivers/bin

3. 次のコマンドを実行します:

   構文:

   ./uninstall saphana

   driver がアンインストールされます。

### ドライバーの手動インストール

自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。

[SAP Software Download Center](https://support.sap.com/en/my-support/software-downloads.html) から、SAP HANA ODBC 64-bit Driver 2.0.19-2.12 をダウンロードします。ソフトウェアをダウンロードするには、SAP のアカウントが必要です。

情報メモ

SAP HANA ODBC ドライバー 2.13 以降はサポートされていません。

ドライバー名の例: HDBODBC

次に、Data Movement gateway マシンで、シェル プロンプトを開き、次の手順を実行します。

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 を暗号化プロバイダーとして使用する場合は、暗号化プロバイダーで OpenSSL の追加の手順を実行して構成を完了する必要があります。

## ポート

Data Movement gateway で、`xx` がソース テーブルを含む SAP HANA データベースのインスタンス番号である、SAP HANA サーバーへの受信ポート番号 `3xx15` を開きます。

たとえば、インスタンス `90` のポートは `39015` です。

## データ変更のキャプチャ

SAP HANA (Database) コネクタを使用してデータをランディングすると、次のアーティファクトがソース データベースに自動的に作成されます。

* ランディングするソース テーブルごとに 3 つのトリガー: トリガーは、ソース テーブルへの変更 (INSERT、UPDATE、DELETE) をキャプチャし、それらを attrep\_cdc\_changes\_cts テーブル (以下で説明) に書き込みます。DML 操作ごとに個別のトリガーが作成されます。トリガーは、ソース テーブル スキーマに作成されます。
* attrep\_cdc\_changes\_cts: このテーブルには、トリガーによってキャプチャされた変更が含まれています。テーブルは、SAP HANA (Database) コネクタの [Create CDC table in schema] (スキーマに CDC テーブルを作成) フィールドで指定されたスキーマに作成されます。

情報メモユーザー側で必要なセットアップはありませんが、トリガーは変更をキャプチャするための前提条件であるため、このトピックで説明します。

参照先: [権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-HANA/security_req_saphana.htm)