Workbench 5.1でSAP HANAデータに接続する

はじめに

Domo SAP HANAプラグインを使うと、Workbench 5.1にジョブを作成して、DomoのSAP HANAデータベースからデータを取得できます。SAP HANAプラグインは、SAP HANA ODBCドライバーを使用してデータベースに接続します。そのため、このプラグインを使用するには、SAP HANA ODBCドライバーをインストールする必要があります。

SAP HANAプラグインはエンドツーエンドトレースにも対応しています。詳細については、 エンドツーエンドトレースセクションを参照してください。

このチュートリアルでは、Domo SAP HANA ODBCプラグインを使用してSAP HANAデータに接続する方法を説明します。

必要条件

• Windows 10 64ビットオペレーティングシステム
• Domo Workbench
• SAP HANA ODBCドライバー
• SAP HANAプラグイン

SAP HANA ODBCドライバーをインストールする

SAPサポートパッケージスタックからSAP HANA ODBCドライバーをダウンロードできます。

1.  HDB_CLIENT_WINDOWS_X86_64にあるhdbsetup.exeを起動します。［新規SAP HANAデータベースクライアントのインストール］オプションが自動的に選択されます。

2. ［インストール］をクリックして、インストールが完了するのを待ちます。

3. ［終了］をクリックします。

Domo WorkbenchにSAP HANAデータプロバイダープラグインをインストールする

Workbenchのプラグインは、すべてダイナミックリンクライブラリ（DLL）に格納されています。Workbenchには、自分のマシンまたはネットワークから目的のDLLを選択することで、プラグインを追加することができます。

WorkbenchにSAP HANAプラグインを追加する

1. 左側のアイコンバーにあるをクリックします。
2. ［その他］ペインで［プラグイン］をクリックします（このペインが表示されていない場合は、をクリックして展開します）。Plugin Managerが開きます。
3. 「新規プラグインを登録」の下の［検索パス］フィールドの横にある省略記号（...）をクリックします。
   
4. マシンまたはネットワーク上で、SAP HANAプラグインのすべてのDLLを含むフォルダを探して開きます。
5. ディレクトリを選択したら、［追加］をクリックします。

SAP HANAデータに接続する

Workbench 5.1でSAP HANA DataSetジョブを作成する

1. 左側のアイコンバーにあるアイコンをクリックします。 

2. ジョブリストペインの右上にある［+］ボタンをクリックします。

3. ［Domoドメイン］ドロップダウンメニューで、必要なアカウント（Domoインスタンス）を選択します。アカウントが1つしか設定されていない場合は、そのアカウントが既に選択されているため、メニューは使用できません。

4. ［名前］フィールドに、DataSetジョブの名前を入力します。
これはWorkbenchで表示されるジョブ名です。DomoにアップロードされたDataSet名ではありません。

5. ［トランスポートタイプ］メニューから、［SAP HANAデータプロバイダー］を選択します。

6. ［読み取りタイプ］メニューで、［データベースクエリ］を選択します。

7. ［DataSet名］フィールドに、DataSet名を入力します。これは、DomoにアップロードされたDataSet名です。新しいジョブを保存した後に変更できるのは、この設定のみです。

8. ［DataSetタイプ］フィールドに、ドロップダウンからDataSetのタイプを選択します。
ここで選択または入力するDataSetのタイプは、ジョブ実行後のDomoのコネクタータイプに反映されます。

9. 必要に応じてDataSetの説明を入力します。
Domoに表示されるDataSetの説明です。 

10.［作成］をクリックします。
現在認証されているアカウントのジョブリストに、SAP HANA DataSetジョブが新規に追加されます。ジョブを作成した後は、DataSet名以外の設定は編集できません。他の設定を変更する場合は、新しいジョブを作成する必要があります。 

11.［設定］サブタブをクリックします。

12. 「ソース」の下の［編集］をクリックします。SAP HANA接続を設定し、クエリを定義するためのパネルが開きます。

13.  ［接続タイプ］フィールドで、接続オプションを選択します。

以下の表に、利用可能なオプションを説明しています。

14. （条件付き）以下のいずれかを行ってください。

• ［接続タイプ］に［システムDSN］を選択した場合は、
  1. ［システムDSN］メニューで、利用可能なDSNから目的のシステムDSNを選択します。このオプションには、SAP HANA ODBCドライバー用に作成されたDSNのみが表示されることに注意してください。
  2. （条件付き）このDSN接続が接続に認証を必要とする場合は、［認証が必要］をオンにし、ユーザー名とパスワードを該当フィールドに入力します。それ以外の場合は、［認証が必要］はオフにします。
• ［接続タイプ］に［Connection Builder］を選択した場合は、

       i. フィールドに適切な情報を入力します。接続によっては、パラメーターは必要または不要になります。 

以下の表を参考にしてください。

• ［接続タイプ］に［接続文字列］を選択した場合は、

     i. データソースに接続するのに使用する接続文字列を入力します。   

     ii. 接続に32ビットSAP HANAドライバーを使用する場合、［32ビット実行が必要］チェックボックスを選択します。

15.  ［適用］をクリックします。

エンドツーエンドのトレース

SAP HANAプラグインは、SAP HANAデータベースのエンドツーエンドトレース機能をサポートしています。SAP HANAデータベースとのプラグインを使用して行われたすべての接続は、2つのセッション変数を持っています。APPLICATIONとAPPLICATIONUSERです。デフォルトでは、SAP HANAプラグインはAPPLICATIONセッション変数をDOMO、APPLICATIONUSERセッション変数を以下のように設定します。

a.  Workbenchジョブが偽装を使用するように設定されている場合、Windowsユーザー

b. またはDomoユーザー

セッション変数（APPLICATIONとAPPLICATIONUSERセッション変数）の値を明示的に指定する場合、以下のいずれかの方法を使用できます。

• 接続文字列にセッション変数を追加する

接続文字列として接続タイプを選択し、必要なセッション変数を接続文字列に追加できます。HANA接続文字列でセッション変数を設定する方法の詳細は、SAPヘルプポータルの「セッション固有のクライアント情報を設定する」を参照してください。

接続文字列の例

DSN=HANADataSource;UID=myUser;PWD=myPassword;sessionVariable:APPLICATION=myapp;sessionVariable:APPLICATIONUSER=user1

• セッション変数でDSNを設定する

DOMO Workbenchは、データベースに接続する際にODBCデータソース名（DSN）に依存します。データソースはODBC管理者でエンドユーザーが定義し、そのエンドユーザーがSAP HANA ODBCドライバーを呼び出します。

1. Windows 10デスクトップで［開始］ボタンをクリックし、ODBCデータソースを検索します。ODBCデータソース（64ビット）をクリックします。

2. ODBCソース管理者ウィンドウでHANAサービスを選択し、［追加...］をクリックします。

3. SAP HANA ODBCドライバー（HDODBC）を選択し、［終了］をクリックします。

4. SAP HANAデータベースのデータソース、ホスト IP、インスタンス番号またはポート番号の名前を入力します。

5. ［テスト接続］ボタンをクリックして、設定が正しいかどうかを確認します。DSNが正しく設定されている場合、以下のように成功メッセージが表示されます。

6. 設定したら、［詳細］をクリックします。

7. ［追加］ をクリックします。

8. ［接続の追加／変更］ウィンドウで、SessionVariable:APPLICATIONの接続プロパティを入力します。

9. 同様に、SessionVariable:APPLICATIONUSERの接続プロパティを追加します。

10. セッション変数は以下のように表示されます。