本ブログでは、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 の関連ライブラリについて

 ojdbc8.jar      : C:apporacleproduct19.0.0dbhome_1jdbclib
 xdb6.jar        : C:apporacleproduct19.0.0dbhome_1rdbmsjlib
 xmlparserv2.jar : C:apporacleproduct19.0.0dbhome_1lib

※ 「C:apporacleproduct19.0.0dbhome_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:Windowssystem32>cd C:usrsapdataprovagent01bin
C:usrsapdataprovagent01bin>agentcli.bat -configAgent
Configuring the Agent at the following location:
C:usrsapdataprovagent01

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:usrsapdataprovagent01binDPAgentServiceDaemon.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:usrsapdataprovagent01binDPAgentServiceDaemon.exe

・DP Agent の設定 : DWC との接続  ※ コマンドプロンプトは管理者で実行(起動)します

C:WINDOWSsystem32>set DPA_INSTANCE=C:usrsapdataprovagent01
C:Windowssystem32>cd C:usrsapdataprovagent01bin
C:usrsapdataprovagent01bin>agentcli.bat -configAgent
Configuring the Agent at the following location:
C:usrsapdataprovagent01

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:usrsapdataprovagent01binDPAgentServiceDaemon.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