au PAY Market JDBC ドライバーを使用したOBIEE でのau PAY Market レポート

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for auPAYMarket は、au PAY Market へのリアルタイムアクセスをJava ベースのレポートサーバーに統合できる標準のデータベースドライバーです。この記事では、ドライバーをOracle Business Intelligence Enterprise Edition (OBIEE) にデプロイし、変更を反映するau PAY Market に関する方法を示します。

JDBC ドライバーをデプロイ

以下のステップに従って、WebLogic のクラスパスにJDBC ドライバーを追加します。

WebLogic 12.2.1 の場合、ドライバーJAR と.lic ファイルをORACLE_HOME\user_projects\domains\MY_DOMAIN\lib のようにDOMAIN_HOME\lib に配置します。これらのファイルは、起動時にサーバーのクラスパスに追加されます。

ドライバーをクラスパスに手動で追加することもできます。これは、以前のバージョンで必要です。setDomainEnv.cmd (Windows) または setDomainEnv.sh (Unix) のPRE_CLASSPATH の前に以下を追加します。このスクリプトは、そのドメインのフォルダーのbin サブフォルダーにあります。例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\bin.

DOMAIN_HOME\bitools\bin でstop コマンドとstart コマンドを実行するなど、すべてのサーバーを再起動します。

JDBC Data Source for auPAYMarket の作成

JDBC ドライバーをデプロイした後、BI Publisher からJDBC データソースを作成できます。

1. BI Publisher にURL http://localhost:9502/analytics でログインし、［Administration］->［Manage BI Publisher］とクリックします。
2. ［JDBC Connection］->［Add Data Source］と進みます。
3. 以下の情報を入力します。
   • Data Source Name:ユーザーが接続を作成する名前をレポートに入力します。
   • Driver Type:SELECTOther.
   • Database DriverClass:ドライバークラスに cdata.jdbc.aupaymarket.auPAYMarketDriver を入力します。
   • Connection String:JDBC URL を入力します。

     au PAY マーケットに接続するには、ShopId およびApiKey が必要です。

     au PAY マーケットへのアクセスの設定

     ShopId およびApiKey を取得するには、以下の手順に従ってください。

     • Wow! manager サイトにログインして、「各種お申し込み」メニューの「API利用申請」に移動します。
     • API利用規約に同意します。
     • 「APIキーの発行はこちら」をクリックします。
     • 「発行」ボタンをクリックして、API キーを生成します。
     • 「接続元IPアドレスを登録」に、対象とするIP アドレスを入力します。
     • 「登録」ボタンをクリックして、設定を保存します。

     au PAY マーケットアカウントの認証

     次の接続プロパティを設定して接続します。

     • ShopId：接続先のau PAY マーケットShop ID を設定。
     • ApiKey：API キーを設定。au PAY マーケットストアアカウントから取得したAPI キーです。
     • UseSandbox：Sandbox 環境に接続する場合はTrue を設定。

     ビルトイン接続文字列デザイナ

     JDBC URL の構成については、au PAY Market JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

     java -jar cdata.jdbc.aupaymarket.jar

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

     以下は一般的なJDBC URL です。

     jdbc:aupaymarket:ApiKey=MyApiKey;ShopId=MyShopId
   • Username:ユーザー名。
   • Password:パスワード。
4. ［Security］セクションで、許可されているユーザーロールを選択します。

リアルタイムのau PAY Market レポートを作成

リアルタイムのau PAY Market に基づいてレポートと分析を作成できるようになります。以下のステップに従って、標準のレポートウィザードを使用してau PAY Market への変更を反映するインタラクティブなレポートを作成します。

1. グローバルヘッダーで、［New］->［Data Model］をクリックします。
2. Diagram タブでメニューからSQL クエリを選択します。
3. クエリの名前を入力し、［Data Source］メニューで、作成したau PAY Market JDBC データを選択します。
4. 標準のSQL を選択し、以下のようなクエリを入力します。 SELECT ItemCode, Price FROM Items
5. ［View Data］をクリックし、レポートの作成に使用するサンプルデータを生成します。
6. サンプルデータに含める行数を選択し、［View］をクリックして［Save As Sample Data］をクリックします。
7. ［Create Report］->［Use Data Model］とクリックします。
8. ［Guide Me］を選択し、［Select Layout］ページで含めるレポートオブジェクトを選択します。この例では、［Chart］と［Table］を選択します。
9. Price のような数値列をy 軸の［Drop Value Here］ボックスにドロップします。ItemCode のようなディメンション列をx 軸の［Drop Label Here］ボックスにドロップします。
10. ［Refresh］をクリックしてau PAY Market への変更を取得します。