OracleとSAP Data Warehouse Cloudのデータ連携

[KABATA_Kimikazu]

本ブログでは、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:\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