Denodo Platform で Sage 300 のデータに接続

Jerod Johnson
Senior Technology Evangelist

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

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

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

Sage 300 仮想ポートの作成

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

CData JDBC Driver for Sage 300 インストーラーをダウンロードし、パッケージを解凍して JAR ファイルを実行してドライバーをインストールします。
インストール先（通常は C:\Program Files\CData\CData JDBC Driver for Sage 300\lib\）から JAR ファイル（およびライセンスファイルが存在する場合はそれも）を Denodo 外部ライブラリディレクトリ（C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-sage300-19）にコピーします。
Denodo Virtual DataPort Administrator ツールを開き、Server Explorer タブに移動します。
"admin" を右クリックし、New -> Data source -> JDBC を選択します。
JDBC 接続を設定します:
- Name: 任意の名前（例: sage300）
- Database adapter: Generic
- Driver class path: C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-sage300-19
- Driver class: cdata.jdbc.sage300.Sage300Driver
- Database URI: 必要な接続プロパティを使用して JDBC URL を設定します。例:
  
  jdbc:sage300:User=SAMPLE;Password=password;URL=http://127.0.0.1/Sage300WebApi/v1/-/;Company=SAMINC;
  
  Database URI の作成方法は以下のとおりです:
  
  ビルトイン接続文字列デザイナー
  
  JDBC URL の構築には、Sage 300 JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
	java -jar cdata.jdbc.sage300.jar
	
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  Sage 300 には、Sage 300 Web API で通信するための初期設定が必要となるます。
  - Sage 300 のユーザー向けのセキュリティグループを設定します。Sage 300 のユーザーに、Security Groups の下にあるbSage 300 Web API オプションへのアクセスを付与します（各モジュール毎に必要です）。
  - /Online/Web と/Online/WebApi フォルダ内のweb.config ファイルを両方編集して、AllowWebApiAccessForAdmin のキーを true 設定します。webAPI アプリプールを再起動すると設定が反映されます。
  - ユーザーアクセスを設定したら、https://server/Sage300WebApi/ をクリックして、web API へのアクセスを確認してください。
  Basic 認証を使用してSage 300 へ認証します。
  
  Basic 認証を使用して接続する
  
  Sage 300 に認証するには、次のプロパティを入力してください。プロバイダーは、クッキーを使用してSage 300 が開いたセッションを再利用することに注意してください。そのため、資格情報はセッションを開く最初のリクエストでのみ使用されます。その後は、Sage 300 が返すクッキーを認証に使用します。
  - Url：Sage 300 をホストするサーバーのURL に設定します。Sage 300 Web API 用のURL を次のように作成してください。 {protocol}://{host-application-path}/v{version}/{tenant}/ 例えば、 http://localhost/Sage300WebApi/v1.0/-/ です。
  - User：アカウントのユーザー名に設定します。
  - Password：アカウントのパスワードに設定します。
"Test connection" ボタンをクリックして設定を確認し、Save をクリックします。

VirtualPort Administrator ツールで Sage 300 のデータを表示

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

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