Squirrel SQL Client からSAP Ariba Source のデータに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData JDBC Driver for SAPAribaSource を使用して、Squirrel SQL Client などのツールでSAP Ariba Source へのクエリを実行できます。この記事では、JDBC data source for SAPAribaSource を作成し、クエリを実行します。

JDBC Driver for SAPAribaSource を追加する

以下のステップに従ってドライバーJAR を追加します。

1. Squirrel SQL で［Windows］->［View Drivers］と進みます。
2. プラスアイコンをクリックし、［Add Driver］ウィザードを開きます。
3. ［Name］ボックスで、CData JDBC Driver for SAPAribaSource のようなドライバーのわかりやすい名前を入力します。
4. ［Example URL］ボックスで、jdbc:saparibasource: と入力します。
5. ［Extra Class Path］タブで［Add］をクリックします。
6. 表示される［file explorer］ダイアログで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルを選択します。
7. ［List Drivers］をクリックして［Class Name］メニューにドライバーのクラス名(cdata.jdbc.saparibasource.SAPAribaSourceDriver) を入力します。

接続プロパティを定義する

以下のステップに従って、接続プロパティをドライバーエイリアスに保存します。

1. ［Windows］->［View Aliases］と進みます。
2. エイリアスが一覧表示されているペインで、プラスアイコンをクリックします。

3. 表示される［Add Alias］ウィザードで、JDBC ドライバーには以下のフィールドが要求されます。

   • Name:CData SAP Ariba Source Source のようなエイリアスの名前を入力します。
   • Driver:CData JDBC Driver for SAPAribaSource を選択します。
   • URL:jdbc:saparibasource: と入力します。
4. 追加のプロパティを定義する場合は、［Properties］をクリックします。
5. 表示されるダイアログの［Driver properties］タブで、［Use driver properties］のチェックボックスを選択します。
6. ［Specify］カラムで必要な接続プロパティのチェックボックスを選択します。

   SAP Ariba Source に接続するには、以下を設定します。

   • API：本製品に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。

   接続すると、本製品は自動でOAuth プロセスを完了します。

   1. 本製品はSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします。
   2. 本製品はアクセストークンの期限が切れると自動的にリフレッシュします。
   3. OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます。

   以下は一般的な接続文字列です。

   jdbc:saparibasource:API=SupplierDataAPIWithPagination-V4;APIKey=wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU;Environment=SANDBOX;Realm=testRealm;AuthScheme=OAuthClient;InitiateOAuth=GETANDREFRESH
7. ［OK］をクリックし、表示されるダイアログで［connect］をクリックして接続を確認します。

スキーマを検出しSAP Ariba Source のデータをクエリする

メタデータが読み込まれると、SAP Ariba Source のデータソースの新しいタブが表示されます。［Objects］サブタブでは、使用可能なテーブルやビューなどのスキーマ情報を見つけることができます。

テーブルデータを表示するには［Objects］タブでテーブルを選択します。その後、テーブルデータが［Content］タブのグリッドに読み込まれます。

SQL クエリを実行するには、［SQL］タブにクエリを入力し、［Run SQL］(ランナーアイコン)をクリックします。例：