Denodo Platform で SAP Ariba Source のデータに接続

Jerod Johnson
Senior Technology Evangelist

CData ドライバーを使用して、Denodo Virtual DataPort Administrator で SAP Ariba Source のデータ用の仮想データソースを作成する方法を説明します。

Denodo Platform は、エンタープライズデータベースのデータを統合的に扱うことができるデータ仮想化製品です。CData JDBC Driver for SAP Ariba Source と組み合わせることで、Denodo ユーザーは他のエンタープライズデータソースと並んでライブ SAP Ariba Source のデータを扱うことができます。本記事では、Denodo Virtual DataPort Administrator で SAP Ariba Source 用の仮想データソースを作成する方法を解説します。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、ライブ SAP Ariba Source のデータとのやり取りにおいて比類のないパフォーマンスを提供します。SAP Ariba Source に対して複雑な SQL クエリを発行すると、ドライバーはフィルターや集計などのサポートされている SQL 操作を直接 SAP Ariba Source にプッシュし、内蔵の SQL エンジンを使用してサポートされていない操作（主に SQL 関数や JOIN 操作）をクライアントサイドで処理します。また、動的メタデータクエリ機能を内蔵しているため、ネイティブデータ型を使用して SAP Ariba Source のデータを操作・分析できます。

SAP Ariba Source 仮想ポートの作成

Denodo からライブ SAP Ariba Source のデータに接続するには、JDBC Driver の JAR ファイルを Denodo の外部ライブラリディレクトリにコピーし、Virtual DataPort Administrator ツールで新しい JDBC データソースを作成します。

CData JDBC Driver for SAP Ariba Source インストーラーをダウンロードし、パッケージを解凍して JAR ファイルを実行してドライバーをインストールします。
インストール先（通常は C:\Program Files\CData\CData JDBC Driver for SAP Ariba Source\lib\）から JAR ファイル（およびライセンスファイルが存在する場合はそれも）を Denodo 外部ライブラリディレクトリ（C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-saparibasource-19）にコピーします。
Denodo Virtual DataPort Administrator ツールを開き、Server Explorer タブに移動します。
"admin" を右クリックし、New -> Data source -> JDBC を選択します。
JDBC 接続を設定します:
- Name: 任意の名前（例: saparibasource）
- Database adapter: Generic
- Driver class path: C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-saparibasource-19
- Driver class: cdata.jdbc.saparibasource.SAPAribaSourceDriver
- Database URI: 必要な接続プロパティを使用して JDBC URL を設定します。例:
  
  jdbc:saparibasource:API=SupplierDataAPIWithPagination-V4;APIKey=wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU;Environment=SANDBOX;Realm=testRealm;AuthScheme=OAuthClient;
  
  Database URI の作成方法は以下のとおりです:
  
  ビルトイン接続文字列デザイナー
  
  JDBC URL の構築には、SAP Ariba Source JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
	java -jar cdata.jdbc.saparibasource.jar
	
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  それでは、SAP Ariba Source に接続していきましょう。接続するには、以下のプロパティを設定します。
  - API：CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Supplier、Sourcing Project Management、またはContract API を選択します（可能な値は、SupplierDataAPIWithPaginationV4、SourcingProjectManagementAPIV2、または ContractAPIV1 です）
  - DataCenter：アカウントのデータがホストされているデータセンター
  - Realm：アクセスしたいサイト名
  - Environment：テスト環境、または本番環境のいずれかを指定してください。（可能な値は、TEST またはPRODUCTION）
  Supplier Data API またはContract API に接続する場合は、さらに以下のプロパティも設定してください。
  - User：API 呼び出しを行うユーザーのId
  - PasswordAdapter：認証するUser に関連付けられたパスワード
  Supplier API に接続している場合は、ProjectId をデータを取得したいソーシングプロジェクトのId に設定してください。
  
  OAuth 認証
  
  続いて、接続プロパティを設定した後、認証のためにOAuth 接続を設定する必要があります。
  - AuthScheme をOAuthClient に設定します
  - サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります
  OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。
  
  OAuth の自動リフレッシュ
  
  以下のプロパティを設定して、接続してみましょう。
  - APIKey：アプリケーション設定のApplication key
  - OAuthClientId：アプリケーション設定のOAuth Client Id
  - OAuthClientSecret：アプリケーション設定のOAuth Secret
  接続すると、CData 製品が自動でOAuth プロセスを完了します。
  1. CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
  2. CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
  3. OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます
"Test connection" ボタンをクリックして設定を確認し、Save をクリックします。

VirtualPort Administrator ツールで SAP Ariba Source のデータを表示

データソースを作成したら、Denodo Platform で使用する SAP Ariba Source のデータのベースビューを作成できます。

新しく作成した VirtualPort (admin.SAPAribaSource) で "Create base view" ボタンをクリックします。
オブジェクトツリーを展開し、インポートするオブジェクト（テーブル）を選択します。
"Create selected" ボタンをクリックして、SAP Ariba Source のデータのビューを作成します。
オプション: "Create associations from foreign keys" をクリックして、オブジェクト間のリレーションシップを定義できます。
ビューが作成されたら、Server Explorer で対象テーブル（cdata_saparibasource_vendors）に移動し、選択したテーブルをダブルクリックします。
新しいタブで "Execution panel" をクリックしてクエリパネルを開きます。
"Execute" タブでクエリをカスタマイズするか、デフォルトのクエリを使用します:
```
SELECT * FROM cdata_saparibasource_vendors CONTEXT ('i18n'='us_est', 'cache_wait_for_load'='true')
```
Execute をクリックしてデータを表示します。