Pentaho Report Designer でZuora のデータを連携利用

Jerod Johnson
Senior Technology Evangelist

Pentaho BI ツールでZuora のデータをもとにしたレポートを公開。

CData JDBC Driver for Zuora のデータを使えば、ダッシュボードやレポートからリアルタイムデータにアクセスできます。この記事では、Zuora のデータにJDBC データソースとして接続し、Pentaho でZuora のデータをもとにしたレポートを公開する方法を説明します。

接続してレポートを作成

インストールディレクトリのlib サブフォルダ内にあるドライバーのJAR ファイルを、Pentaho ディレクトリ内の\Report-Designer\lib\jdbc\ フォルダにコピーします。
\Report-Designer\ フォルダ内のreport-designer.bat ファイルを実行してReport-Designer UI を開きます。
Data -> Add Data Source -> Advanced -> JDBC（Custom）をクリックし、新しいZuora 接続を作成して、ドライバーで新しいデータソースを作成します。表示されるダイアログで、以下のように接続プロパティを設定します。
- Custom Connection URL property：JDBC URL を入力します。JDBC URL はjdbc:zuora: で始まり、その後にセミコロン区切りで接続プロパティを指定します。
  
  Zuora はユーザー認証にOAuth 標準を使用しています。OAuth 認証ついて詳しくは、オンラインヘルプドキュメントを参照してください。
  
  Tenant プロパティの設定
  プロバイダへの有効な接続を作成するには、アカウントの設定と合致するテナント値を1つ選択する必要があります。以下は、利用可能なオプションのリストです。
  - USProduction：リクエストはhttps://rest.zuora.com に送信されます。
  - USAPISandbox：リクエストはhttps://rest.apisandbox.zuora.com に送信されます。
  - USPerformanceTest：リクエストはhttps://rest.pt1.zuora.com に送信されます。
  - EUProduction：リクエストはhttps://rest.eu.zuora.com に送信されます。
  - EUSandbox：リクエストはhttps://rest.sandbox.eu.zuora.com に送信されます。
  デフォルトではUSProduction テナントを使用します。
  Zuora サービスの選択
  データクエリとAQuA API の2つのZuora サービスを使用します。デフォルトでは、ZuoraService はAQuADataExport に設定されています。
  DataQuery
  データクエリ機能は、非同期の読み取り専用SQL クエリを実行することで、Zuora テナントからのデータのエクスポートを実現します。このサービスは、素早く軽量なSQL クエリでの使用を推奨します。
  制限
  - フィルタ適用後の、テーブルごとの入力レコードの最大数： 1,000,000
  - 出力レコードの最大数： 100,000
  - テナントごとの、実行用に送信される同時クエリの最大数： 5
  - テナントごとの、同時クエリの制限に達した後に実行用に送信され、キューに追加されるクエリの最大数： 10
  - 1時間単位での、各クエリの最大処理時間： 1
  - GB 単位での、各クエリに割り当てられるメモリの最大サイズ： 2
  - Index Join を使用する際のインデックスの最大値。言い換えれば、Index Join を使用する際にWHERE 句で使われる一意の値に基づいた、左のテーブルから返されるレコードの最大数： 20.000
  AQuADataExport
  AQuA API のエクスポートは、すべてのオブジェクト（テーブル）のすべてのレコードをエクスポートするように設計されています。AQuA のクエリジョブには以下の制限があります。
  制限
  - AQuA のジョブ内のクエリが8時間以上実行されている場合、ジョブは自動的に停止されます。
  - 停止されたAQuA のジョブは3回再試行可能で、その後失敗として返されます。
  組み込みの接続文字列デザイナー
  
  JDBC URL の構成については、Zuora JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。
```
java -jar cdata.jdbc.zuora.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  JDBC URL を設定する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限されます。特にレポートやビジュアライゼーションを設計する際のパフォーマンス向上に役立ちます。
  
  一般的なJDBC URL は次のとおりです：
```
jdbc:zuora:OAuthClientID=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;Tenant=USProduction;ZuoraService=DataQuery;
```
- Custom Driver Class Name：cdata.jdbc.zuora.ZuoraDriver を入力します。
- User Name：認証に使用するユーザー名。
- Password：認証に使用するパスワード。

レポートにZuora のデータを追加

Zuora のデータをもとにレポートを作成する準備が整いました。

レポートにZuora のソースを追加します。Data -> Add Data Source -> JDBC をクリックしてデータソースを選択します。
クエリを設定します。この記事では以下のクエリを使用します：
```
SELECT Id, BillingCity FROM Invoices WHERE BillingState = 'CA'
```
レポートにチャートをドラッグし、ダブルクリックしてチャートを編集します。レポートを実行してチャートを表示します。このクエリの結果を使用して、Invoices テーブルのシンプルなチャートを作成できます。
最後に、レポートを実行してチャートを確認します。