Go to Qiita Advent Calendar 2024 Top
LoginSignup
7
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

@kyo_naga

オンプレのHANAからSAP Analytics CloudにCloudConnectorを使用してデータをインポートしてみたら色々あった話

Last updated at Posted at 2019-12-19

#はじめに
この記事は SAP Advent Calendar 2019 の12月20日分の記事として執筆しています。

株式会社KYOSOで開発マネージャをしております長嶋と申します。
よろしくお願いいたします。

今回は、SAP Analytics Cloudへ既存のオンプレミスHANAからデータをインポートするという作業を行った中で、遭遇した事実や事象についてご紹介したいと思います。

#概要
まず、今回の実施内容についての概要を簡単に図で表すと以下のようになります。
1.JPG
はい、要するにOnPremiseのHANAのデータをSACでの分析に使用するという要件ですね。
SACにインポートするデータ（今回はViewをターゲットにしています）はOnPremiseのHANAにあり、中間サーバーとしてAWS上でEC2を利用してCloudConnectorを設定し、SACへのデータインポートを行います。
図には記載していませんが、EC2上にはCloudConnectorと併せてSACAgentもインストールしています。
あと、ネットワーク構成の細かい話は今回割愛しております。

#作業手順
主な作業手順としては以下の流れで行いました。
(1) OnPremiseのHANAにて、インポート対象のViewをoDataサービスに設定する。
(2) AWSのEC2上にCloudConnectorとSACAgentをインストールし、設定する。
(3) SACにてCloudConnectorとの接続を設定する。
(4) CloundConnectorとOnPremiseのHANAの接続を設定する。
(5) SACにてインポートを実行する。

#本編
ここから具体的に内容を記載していきます。
長いです。

##(1)OnPremiseのHANAにて、インポート対象のViewをoDataサービスに設定します
まず、作業環境としてSYSTEMユーザーにてHANA StudioでOnPremiseのHANAに接続できていることが前提です。

###・oData設定用のユーザーを追加する
最初にSYSTEMユーザーをCOPYし、oData設定を行うためのユーザーとしてDEMO_USERを作成します。
2.jpg
GrantedRoleに以下を設定しておきます。

  • CONTENT_ADMIN
  • MODELING
  • PUBLIC
    3.jpg
    設定が出来たら、DEMO_USERでの接続を作成します。
    image.png
    image.png
    image.png

###・XS Projectを作成する
はい、次に対象のView(Table)をoDataサービスに設定しますので以下の要領でXS Projectを作成します。

・メニュー→[Window]→[Perspective]→[Open Perspective]→[SAP HANA Development]を選択します。
image.png
・メニュー→[File]→[New]→[XS Project]を選択します。
image.png
・プロジェクト名を入力します。
image.png
・Workspaceを選択します。
　[Add Workspace...]から、現在のDEMO_USERの接続を選択して[Finish]を押下します。
image.png
image.png
image.png
・以下を参考に次へ進め、XS Projectの作成を完了します。
image.png
image.png
###・XS OData Fileを追加し、oDataサービスを設定する。
次に、作成したXS ProjectにXS OData Fileを追加します。

・作成したプロジェクトを右クリックし、以下の様に選択します。
　[New]→[XS OData File]
image.png
・ファイル名を入力します。
image.png
・[Finish]を選択すると作成が完了します。
image.png

次に、作成したXS OData Fileを開き、対象のViewをサービスに登録する記述を反映します。
書式としては以下のようになります。

service {
    "スキーマ名"."View(Table)名" as "サービス名称";
}

image.png
・XS OData Fileの編集を保存したら、Activateを行います。
　プロジェクト名を右クリックし、以下の様に選択します。
　[Team]→[Activate All...]
image.png
・作成したXS OData Fileを選択し、[OK]を選択します。
image.png
・Activateが完了します。
image.png

###・遭遇した事象二つ
はい、実はここで対応が必要な内容に２つ遭遇しました。

####まず一つ目
各種データベースの運用歴をある程度お持ちの方は、Tableのカラム名に「PG言語の予約語にありそうな名称」や「数字で始まる名称」は避けるよう設計していると思います。データベースあるあるの一種ですが、こういう名称を持たせると不都合に遭遇することがしばしばあります。
で、まさに今回数字で始まるカラム名が対象のViewに存在したことで、oDataをActivateできないという事象が発生しました。
先の手順の最後の方で、XS OData FileのActivateを実行した際に以下のエラーが発生しました。
Unsupported property name
image.png
対策としては単純で以下となります。
・Viewであれば、View定義で対象のカラムにエイリアス名を設定する
・TABLEの場合は、Viewを定義してそこでエイリアス名を設定する
XS OData Fileの記載の中でエイリアス名的な対処ができれば、元のView(Table)での変更は不要なので対応しやすいのですが、残念ながらそれが可能かどうかについて現時点ではわかりませんでした。

####そして、二つ目
対象のView(Table)にキーが無い場合、前述の[XS OData File]の記載だけではoDataをActivateしようとするとエラーが発生するのです。
oDataの設定では当たり前の話なんだと思いますが、実は私今回この設定初めてなのでここで知りました。
で、実は今回のViewってキーとして指定できる（一意になる）カラムの組み合わせが無いんですよね。
書式としては、

service {
    "スキーマ名"."View(Table)名" as "サービス名称"
    with (
      "対象とするカラム名",
　　　　・・・
      "対象とするカラム名"
    )
    key (
      "キーに指定するカラム名",
　　　　・・・
      "キーに指定するカラム名"
    );
}

なのですが、key項目の指定が今回記載できません。
対処としては、自動でkey列を別で生成する設定を記載します。

service {
    "スキーマ名"."View(Table)名" as "サービス名称"
    with (
      "対象とするカラム名",
　　　　・・・
      "対象とするカラム名"
    )
　　key generate local "ID";
}

ただ、これはこれで別の問題がありそうなのですが今回は割愛します。

##(2)AWSのEC2上にCloudConnectorとSACAgentをインストールし、設定する
ここは淡々と手順を以下に記載します。

###・CloudConnectorとJVMをインストールする
・SAP Development ToolsよりCloudConnectorとJVMをダウンロードします。
image.png
image.png

・ダウンロードしたsapjvm-x.x.xxx-windows-x64.zipを解凍し、任意の場所に設置。
　例としてここでは D:\ 直下とします。
・Winsowsのシステムの詳細設定にてシステム環境変数に以下内容を追加します。
　変数：JAVA_HOME
　値：上記解凍パス + [\bin]
image.png
image.png
・Visual C++ Redistributable Packages for Visual Studio 2013より、Visual Studio 2013 Visual C++ 再頒布可能パッケージをダウンロードし、インストールします。
image.png
image.png
・次に、CloudConnectorをインストールする前に、SACにて「SAP Cloud Platform アカウント」を確認します。
　SACにログインし、[システム]→[管理]を選択します。
　データソース設定タブにて、SAP Cloud Platform アカウントに使用するアカウントユーザーを登録するとアカウント情報が表示されるようになります。
image.png
・ダウンロードしてあったCloudConnectorをインストールします。
image.png
image.png
image.png
image.png
image.png
image.png
・Windowsのサービス一覧に「SAP Cloud Connector」が追加されていることを確認します。
image.png
・CloundConnectorの管理画面にアクセスしてログインします。
　管理画面のURLは
　https://localhost:8443
　です。
　また、初期状態での管理アカウントは以下の設定になっています。
　ID : Administrator
　Pass：manage
　※適宜パスワードを変更して運用しましょう。
image.png
SACで確認した「SAP Cloud Platform アカウント」情報を登録し、以下の画面が表示されたら初期設定は完了です。
image.png
###・TomcatとSACAgentをインストールする
続いて、SACAgentに必要なTomcatをインストールします。
・Apache TomcatよりTomcatのインストーラをダウンロードし、インストールします。
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png
・インストールしたTomcatフォルダより、「Tomcat8w.exe」を起動してメモリ設定を調整します。
image.png
image.png
・次にSAP Softwear DownloadよりSACAgent（「C4AAgent」）をダウンロードします。
image.png
image.png
・ダウンロードした「C4AAgent」のwarファイルを、「Tomcatx.x＞webapps」の直下に移動します。
・「Tomcatx.x＞conf」フォルダ直下の「tomcat-users.xml」をエディタで開き、C4AAgentの設定を追記して保存します。
image.png
image.png
・Windowsのシステム環境変数に以下を追加します。
　変数：JRE_HOME
　値：jreのインストールパス
image.png
・Tomcatを起動します。

> cd C:\Program Files\Apache Software Foundation\Tomcat 8.5\bin
> startup.bat

以下のように表示されます。
image.png
###・CloudConnectorでSACAgentとの連携を設定する
次に、CloudConnectorの管理コンソールにて、「Clound to On-premise」を選択し、「＋」をクリックして新規追加を行います。
image.png
image.png
image.png
Internal Host：Tomcat稼働環境のホスト名
Internal Port：Tomcatインストール時に設定したhttpポート番号
image.png
Virtual Host：新規のホスト名
Vitual Port：新規のポート番号　※他の設定と被らないよう注意が必要
image.png
image.png
image.png
image.png
image.png
・続けて、Resources Of sacagentの新規追加を行います。
　URL Pathは固定値で、「/C4A_AGENT/」を入力します。
image.png
##(3) SACにてCloudConnectorとの接続を設定する。
続いてここも淡々と手順を以下に記載します。

・SACにログインし、[システム]→[管理]を選択します。
　データソース設定タブにて、「オンプレミスデータソース」の設定でエージェント追加を行います。
image.png
ホスト、ポート：CloudConnectorで設定した、Virtual Host情報
ユーザ名、パスワード：tomcat-users.xmlに追記したID/PW情報
image.png
image.png
これで、SACとSACAgent、CloudConnectorは接続できました。
##(4)CloundConnectorとOnPremiseのHANAの接続を設定する
続いて続いてここも淡々と手順を以下に記載します。

・CloudConnectorの管理コンソールで、「Cloud To On-Premise」にて Mapping Virtual To Internal Systemのエントリを追加します。
　「＋」をクリックします。
image.png
image.png
image.png
Internal Host：OnPremise HANAのIPアドレス
Internal Port：8000
image.png
Virtual Host：Internal Hostと同じ
Vitual Port：Internal Portと同じ
image.png
image.png
image.png
image.png
image.png
image.png
・次に、登録したエントリのResoucesを登録します。
　今追加したMapping Virtual To Internal Systemのエントリを選択し、下段のResouces Of *** にある「＋」をクリックします・
image.png

URL Pathは固定値「/」を入力します。
image.png
image.png
これで、CloudConnectorとOnPremiseのHANAが接続できました。
##(5) SACにてインポートを実行する。
ここまでに作成した接続を使用して、OnPremiseのHANAからSACにデータインポートを行います。

・まず、SACにログインし、メニューから[接続]を選択します。
・次にデータソースの選択で[Odataサービス]を選択します。
image.png
（画像に「あ」って入っちゃってました・・・）
・oDataサービス接続情報を入力します。
　データサービスURLは以下内容です。
　http://"オンプレHANAのIP":8000/"XS Project名"/"XS OData Fileのファイル名"
image.png
image.png
image.png
・次にメニューから[作成]→[データセット]を選択します。
image.png
image.png
「＋」をクリックします。
データソースからのデータを選択します。
image.png
Odataサービスを選択します。
image.png
先ほど作成した接続が選択できるので、指定します。
image.png
image.png
image.png
image.png
「OK」をクリックするとインポートがスタートします。
image.png
完了すると以下のようになります。
image.png
image.png

これで要件の通り、OnPremiseのHANAのデータをCloudConnectorを介してSACへのデータインポートを行う事が実現できました。
あー長かった。

データインポートでの注意点

で、実はこのデータインポートには注意点が二点あります。
SACでデータを取り扱うには Live Connectionを使用するか、今回の様にデータインポートを行うかのどちらかになりますが、
データインポートの場合、一回あたりのデータ転送のレコード数上限が 80万件 なのです。
また、インポートのクエリを作成するときに指定できるカラムは 100個 が上限になります。
貯めに貯めたERPのデータなどで数千万件などデータがある場合や、100個以上のカラムがあるテーブルをインポートする場合は、事前に対象のスコーピングとクレンジングが必須となりますので良く検討しましょう。
（技術的には対象のView(Table)を複数のODataサービスに分割し、多重並列インポート等を行う等色々工夫が可能です。）

#終わりに
文才が無いので無駄に長い記事になってしまいましたが、SAP Advent Calendar 2019 の12月20日分の記事となります。
万一内容に間違い・齟齬がありました場合は適宜修正させていただきます。

なお最後になりますが、
(2) AWSのEC2上にCloudConnectorとSACAgentをインストールし、設定する。
(3) SACにてCloudConnectorとの接続を設定する。
の内容においては、@iwa_ginoに資料提供の協力をいただきました。
この場でお礼を申し上げたいと思います。ありがとうございました！

7
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
7
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?