本ブログでは、Oracle データベースとSAP Data Warehouse Cloud (以下、「DWC」) とのデータ連携の設定について解説します。
Oracle とDWCの連携のシステム構成図は下記の通りです。
本Blogでは下記の動画にて設定方法をガイドします。
※ 画面サイズを調整する場合は、再生時に画面右下に表示されるYouTubeロゴをクリックして別画面でご確認ください。
また、動画中に出てくる関連情報/補足情報を下記にまとめていますので併せてご確認ください。
SAP Data Warehouse Cloud - データプロビジョニングエージェント接続の準備
SAP HANA Smart Data Integration - Oracle との連携
SAP Support Portal - DP Agent のソフトェアダウンロード
SAP Development Tools - DP Agent のソフトウェアダウンロード
SAP HANA Smart Data Integration - Product Availability Matrix (PAM)
・DP Agent 用サーバーの最小必要スペックについて
16GBメモリー、30GBのディスク容量、4 CPU Core
※ 最新の情報、サイジング情報などは 前出のPAM(Product Availability Matrix)をご確認ください。
・DP Agent が稼働するOSについて
Oracle Database と連携する場合は、Oracle Database が稼働するOSとDP Agent が稼働するサーバーのOSを一致させる必要があります。
OracleがWindowsで稼働している場合はDP Agent が動作するOSもWindows、Oracle がUNIX/Linuxで稼働している場合は、DP Agentが動作するOSはLinuxになります。
詳しくは前出のPAM(Product Availability Matrix)をご確認ください。
・Oracle の関連ライブラリについて
・Oracle ユーザー作成と権限設定について
・DP Agent の再起動 ※ コマンドプロンプトは管理者で実行(起動)します
・DP Agent 再起動時に発生するエラーについて
初回にDP Agent をStopしたり、Start すると下記のメッセージが表示されることがありますが、DP Agent 自体が起動していれば無視して結構です(SAP Note:2945498)。
・DP Agent の設定 : DWC との接続 ※ コマンドプロンプトは管理者で実行(起動)します
Oracle とDWCの連携のシステム構成図は下記の通りです。
機能概要と設定手順解説
本Blogでは下記の動画にて設定方法をガイドします。
※ 画面サイズを調整する場合は、再生時に画面右下に表示されるYouTubeロゴをクリックして別画面でご確認ください。
また、動画中に出てくる関連情報/補足情報を下記にまとめていますので併せてご確認ください。
関連情報
SAP Data Warehouse Cloud - データプロビジョニングエージェント接続の準備
SAP HANA Smart Data Integration - Oracle との連携
SAP Support Portal - DP Agent のソフトェアダウンロード
SAP Development Tools - DP Agent のソフトウェアダウンロード
SAP HANA Smart Data Integration - Product Availability Matrix (PAM)
注意事項
・DP Agent 用サーバーの最小必要スペックについて
16GBメモリー、30GBのディスク容量、4 CPU Core
※ 最新の情報、サイジング情報などは 前出のPAM(Product Availability Matrix)をご確認ください。
・DP Agent が稼働するOSについて
Oracle Database と連携する場合は、Oracle Database が稼働するOSとDP Agent が稼働するサーバーのOSを一致させる必要があります。
OracleがWindowsで稼働している場合はDP Agent が動作するOSもWindows、Oracle がUNIX/Linuxで稼働している場合は、DP Agentが動作するOSはLinuxになります。
詳しくは前出のPAM(Product Availability Matrix)をご確認ください。
設定例
・Oracle の関連ライブラリについて
ojdbc8.jar : C:\app\oracle\product\19.0.0\dbhome_1\jdbc\lib
xdb6.jar : C:\app\oracle\product\19.0.0\dbhome_1\rdbms\jlib
xmlparserv2.jar : C:\app\oracle\product\19.0.0\dbhome_1\lib
※ 「C:\app\oracle\product\19.0.0\dbhome_1」はOracleをインストールしたフォルダ
・Oracle ユーザー作成と権限設定について
-- SYSTEM ユーザーで Oracleにログイン (PDBにログイン)
connect system/<password>@ORCLPDB
-- Replication 用の Oracleユーザーを作成
CREATE USER ORDER_ENTRY_REP IDENTIFIED BY <password>
DEFAULT TABLESPACE "USERS"
TEMPORARY TABLESPACE "TEMP"
;
-- 権限設定 ※システム権限
GRANT UNLIMITED TABLESPACE TO ORDER_ENTRY_REP;
GRANT CREATE SESSION TO ORDER_ENTRY_REP;
GRANT CREATE SEQUENCE TO ORDER_ENTRY_REP;
GRANT CREATE PROCEDURE TO ORDER_ENTRY_REP;
GRANT CREATE ANY TRIGGER TO ORDER_ENTRY_REP;
GRANT ADMINISTER DATABASE TRIGGER TO ORDER_ENTRY_REP;
GRANT CREATE TABLE TO ORDER_ENTRY_REP;
-- 権限設定 ※オブジェクト権限 : レプリケーション対象テーブルに対しての参照権限
GRANT SELECT ON ORDER_ENTRY.CUSTOMERS TO ORDER_ENTRY_REP;
GRANT SELECT ON ORDER_ENTRY.PRODUCTS TO ORDER_ENTRY_REP;
GRANT SELECT ON ORDER_ENTRY.ORDERS TO ORDER_ENTRY_REP;
実行ログのサンプル
・DP Agent の再起動 ※ コマンドプロンプトは管理者で実行(起動)します
C:\Windows\system32>cd C:\usr\sap\dataprovagent01\bin
C:\usr\sap\dataprovagent01\bin>agentcli.bat -configAgent
Configuring the Agent at the following location:
C:\usr\sap\dataprovagent01
Initializing DPAgent Configuration Tool
************************************************************
DPAgent Configuration Tool
************************************************************
1. Agent Status
2. Start or Stop Agent
:
************************************************************
Enter Option:2
************************************************************
Start or Stop Agent
************************************************************
1. Start Agent Using Service
2. Stop Agent Using Service
:
************************************************************
Enter Option:2
Stopping agent service. Command: sc stop SAP_HANA_SDI_Agent_Service_Daemon_SAPJPN101
Stop Service return code: 0
Agent was shutdown gracefully
Press Enter to continue...
<少し時間をおく。停止するまで時間が掛かります。>
************************************************************
Start or Stop Agent
************************************************************
1. Start Agent Using Service
2. Stop Agent Using Service
:
************************************************************
Enter Option:1
Agent service daemon location: C:\usr\sap\dataprovagent01\bin\DPAgentServiceDaemon.exe
Starting agent service. Command: sc start SAP_HANA_SDI_Agent_Service_Daemon_SAPJPN101
Start Service return code: 0
Press Enter to continue...
************************************************************
Start or Stop Agent
************************************************************
:
3. Ping Agent
:
************************************************************
Enter Option:3
Ping successful
Press Enter to continue...
************************************************************
Start or Stop Agent
************************************************************
:
q. Quit
b. Back
************************************************************
Enter Option:q
0
・DP Agent 再起動時に発生するエラーについて
初回にDP Agent をStopしたり、Start すると下記のメッセージが表示されることがありますが、DP Agent 自体が起動していれば無視して結構です(SAP Note:2945498)。
2022-08-25 23:27:19,607 [ERROR] DPFramework | Message.write []
- Exception while writing to output stream: Connection reset by peer:
socket write error (local port 53916 to address 127.0.0.1, remote port 5051 to address 127.0.0.1)
Agent service daemon location: C:\usr\sap\dataprovagent01\bin\DPAgentServiceDaemon.exe
・DP Agent の設定 : DWC との接続 ※ コマンドプロンプトは管理者で実行(起動)します
C:\WINDOWS\system32>set DPA_INSTANCE=C:\usr\sap\dataprovagent01
C:\Windows\system32>cd C:\usr\sap\dataprovagent01\bin
C:\usr\sap\dataprovagent01\bin>agentcli.bat -configAgent
Configuring the Agent at the following location:
C:\usr\sap\dataprovagent01
Initializing DPAgent Configuration Tool
************************************************************
DPAgent Configuration Tool
************************************************************
:
7. SAP HANA Connection
:
************************************************************
Enter Option:7
************************************************************
SAP HANA Connection
************************************************************
1. Connect to SAP HANA Cloud via JDBC
2. Connect to SAP Data Warehouse Cloud via JDBC
:
************************************************************
Enter Option:2
************************************************************
Connect to SAP Data Warehouse Cloud via JDBC
************************************************************
Press "Enter" button to keep default or skip an optional setting.
If a setting cannot be skipped, that means it is required.
************************************************************
Enter Agent Name:
SAPJPN101
Enter Use encrypted JDBC connection[true]: Valid options: true|false
true
Enter Host Name:
23b3fd16-b480-xyz.xyz.xyz.hanacloud.ondemand.com
Enter Port Number:
443
Enter Use Proxy Server[false]: Valid options: true|false
false
Enter HANA User Name for Agent Messaging:
DWC_DP_MSG_SAPJPN101
Enter HANA User Password for Agent Messaging:
<コピーしたパスワードをペーストします。画面上は表示されません>
Enter HANA User Password for Agent Messaging: (confirm)
<コピーしたパスワードをペーストします。画面上は表示されません>
Do you want to save these connection settings? Any existing settings will be overwritten.
Enter [false] if you do not want to save or [true] to save.
true
Agent connection settings for SAP Data Warehouse Cloud have been saved.
Restart the agent for the changes to take effect.
Press Enter to continue...
************************************************************
SAP HANA Connection
************************************************************
:
b. Back
************************************************************
Enter Option:b
Initializing DPAgent Configuration Tool
************************************************************
DPAgent Configuration Tool
************************************************************
:
2. Start or Stop Agent
:
************************************************************
Enter Option:2
************************************************************
Start or Stop Agent
************************************************************
1. Start Agent Using Service
2. Stop Agent Using Service
:
************************************************************
Enter Option:2
Stopping agent service. Command: sc stop SAP_HANA_SDI_Agent_Service_Daemon_SAPJPN101
Stop Service return code: 0
Agent was shutdown gracefully
Press Enter to continue...
************************************************************
Start or Stop Agent
************************************************************
1. Start Agent Using Service
2. Stop Agent Using Service
:
************************************************************
Enter Option:1
Agent service daemon location: C:\usr\sap\dataprovagent01\bin\DPAgentServiceDaemon.exe
Starting agent service. Command: sc start SAP_HANA_SDI_Agent_Service_Daemon_SAPJPN101
Start Service return code: 0
Press Enter to continue...
************************************************************
Start or Stop Agent
************************************************************
:
3. Ping Agent
:
************************************************************
Enter Option:3
Ping successful
Press Enter to continue...
************************************************************
Start or Stop Agent
************************************************************
:
q. Quit
b. Back
************************************************************
Enter Option:q
0
- SAP Managed Tags:
