前提条件
データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。
-
Data Movement ゲートウェイ サーバーに、必要なdriverをインストールする
-
データ ソースに必要な権限を付与する
-
データ ソースのコネクタを構成する
ドライバーのセットアップ
driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。
ドライバー インストール ユーティリティを使用したドライバーのインストール
このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、必要な driver を自動的にダウンロード、インストール、設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。
インストールの準備
-
データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。
Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。
python3 --version
driver のインストール
driver をダウンロードしてインストールするには:
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./install oracle
アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、install oracle コマンドを再度実行します。
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
-
「v」を入力して [Enter] を押すと、EULA が再表示されます。
driver がインストールされます。
driver の更新
提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。
driver をダウンロードして更新するには:
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./update oracle
アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、update oracle コマンドを再度実行します。
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押して、EULA 全体をスピーディにスクロールします。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
- 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。
古い driver がアンインストールされ、新しい driver がインストールされます。
driver のアンインストール
driver をアンインストールする場合は、アンインストール コマンドを実行します。
driver をアンインストールするには:
-
このコネクタを使用するように構成されているすべてのタスクを停止します。
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./uninstall oracle
driver がアンインストールされます。
ドライバーの手動インストール
自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。
データ移動ゲートウェイ がインストールされたら、oracle-instantclient-basiclite-<version>.x86_64.rpm ドライバーをダウンロードします。サポートされているバージョンへの直接ダウンロード リンクは、/opt/qlik/gateway/movement/drivers/manifests/oracle.yaml の binary-artifacts にあります。ダウンロードが完了したら、RPM を データ移動ゲートウェイ マシンにコピーします。
次に、Data Movement gateway サーバーで、シェル プロンプトを開き、次の手順を実行します。
-
Data Movement gateway サービスを停止します。
sudo systemctl stop repagent
-
オプションで、サービスが停止されたことを確認します。
sudo systemctl status repagent
- ドライバー (RPM) をインストールします。
-
さらに、システムにまだ含まれていない場合は、$Oracle_Home\lib ディレクトリにシンボリック リンクを作成します。リンクに libclntsh.soという名前を付け、このファイルの特定のバージョンを指定します。
例:
lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1
-
作業ディレクトリを <Data Movement gateway-Install-Dir>/bin に変更し、ドライバーの場所を site_arep_login.sh ファイルにコピーして、LD_LIBRARY_PATH 環境変数を Oracle Instant Client ディレクトリおよび Data Movement gatewaylib ディレクトリに追加します。
echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh
-
必要に応じて、ドライバーの場所がコピーされていることを確認します。
cat site_arep_login.sh -
Data Movement gateway サービスを起動します。
sudo systemctl start repagent
-
オプションで、サービスが開始されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: active (running) since <timestamp> ago
ステータスは次のようになっているはずです。
Active: inactive (dead) since <timestamp> ago
Oracle アカウントへのアクセスの提供
Oracle アカウントへのアクセスを Data Movement gateway のユーザーに提供する必要があります。このユーザーには、Oracle データベースに対する読み取り/書き込みの権限が必要です。Oracle アカウントへのアクセス設定の詳細については、「必要な権限」を参照してください。
ARCHIVELOG モードがオンになっていることの確認
Oracle は、ARCHIVELOG モードと NOARCHIVELOG モードの 2 つの異なるモードで実行できます。Data Movement gateway で Oracle ログを使用するには、データベースを ARCHIVELOG モードで実行します。ログが ARCHIVELOG モードに設定されていない場合は、次のクエリを実行します。
ALTER database ARCHIVELOG
Oracle データベース インスタンスが Amazon RDS 上にある場合は、別のコマンドを実行する必要があります。詳しくは「自動バックアップの有効化」と「アーカイブの設定」を参照してください
サプリメンタル ロギングの設定
データベース レベルとテーブル レベルの両方で、Oracle データベースのサプリメンタル ロギングを有効にする必要があります。
Oracle スタンバイ環境から ランディング する場合は、スタンバイ インスタンスではなく、プライマリ Oracle インスタンス (以下で説明) でサプリメンタル ロギングを設定する必要があります。
データベース レベルでのサプリメンタル ロギングの確認と有効化
-
次のクエリを実行します。
SELECT name, value, description FROM v$parameter WHERE name = 'compatible';
返される結果は GE to n.n.n からのものである必要があります。ここでは、n.n.n は Oracle データベースのバージョン (例: 10.0.0) です。
警告メモパラメーター値がデータベースの実際のバージョンと一致する必要があります。
-
次のクエリを実行します。
SELECT supplemental_log_data_min FROM v$database;
返される結果は YES または IMPLICIT になります。
次のクエリを実行して、サプリメンタル ロギングを有効にします。
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
情報メモOracle データベース インスタンスが Amazon RDS 上にある場合は、別のコマンドを実行する必要があります。詳細については、「Amazon RDS for Oracle の使用」を参照してください。
テーブル レベルでのサプリメンタル ロギングの確認と有効化
-
サプリメンタル ロギングがテーブル レベルで有効になっているかどうかを確認するには、次のクエリを実行します。
構文:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';
例:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';
-
サプリメンタル ロギングをテーブル レベルで有効にするには、次のクエリを実行します。
構文:
ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
例:
ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
参照先: 必要な権限