Clear Analytics でZuora のデータを使ってチャートを作成
CData ODBC ドライバー for Zuora は、ODBC 標準を介してZuora のライブデータへのアクセスを可能にし、さまざまな BI、レポート、ETL ツールでZuora のデータ を直接扱うことができます。この記事では、Microsoft Excel のアドインである Clear Analytics を使って、Zuora に ODBC データソースとして接続し、Zuora のデータ を基にしたクエリ、テーブル、チャート(PivotTable を含む)を作成する方法を説明します。
Zuora のデータに接続
ODBC データソース名の設定
まだ設定していない場合は、データソース名(DSN)で必要な接続プロパティを指定します。Microsoft ODBC データソースアドミニストレーターを使って DSN を作成・設定できます。これはドライバーインストールの最終ステップでも可能です。Microsoft ODBC データソースアドミニストレーターを使った DSN の作成と設定方法については、ヘルプドキュメントの「はじめに」を参照してください。
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回再試行可能で、その後失敗として返されます。
DSN を設定する際、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを作成する際のパフォーマンス向上に役立ちます。
Clear Analytics でデータソースを設定
- Excel を開き、CLEAR ANALYTICS リボンに移動します。Data Manager を開きます。
- データソースとして Database を選択します。
- Set Connection セクションで、新しいデータベースを作成するオプションをクリックします。
- データソースとして Microsoft ODBC Data Source を選択し、OK をクリックします。
- ドロップダウンメニューから、先ほど設定した DSN を選択します。

- Set Connection セクションに戻り、SQL Builder Provider として Standard (ANSI ODBC) Query Builder を選択して Next をクリックします。
- Schema/Owner を選択し、Clear Analytics で使用するドメイン(テーブル)を選択します。

- 必要に応じて、テーブルやカラムの表示名と説明をカスタマイズしてデータオブジェクトを準備します。
- CData ODBC ドライバーの大半では、ドメインにキー日付を設定する必要はありません。
- Domain Relations セクションで、テーブル間のリレーション情報を追加します。
- Domain Tree セクションで、データのグループを作成し、利用可能な項目をグループに追加します。

- データのサマリーを確認し、Finish をクリックします。
Zuora のデータでチャートを作成
これでZuora のデータ を使ったチャートを作成する準備ができました。
新規クエリの作成
- CLEAR ANALYTICS リボンの Repository をクリックします。
- 新しいクエリを作成します。
- 取得するカラムを選択します。
- データの集計タイプを設定します(データを集計しない場合は空白のエントリを使用します)。
- カラムを下のウィンドウにドラッグして、フィルタと数式を設定します。
- クエリに名前を付けて Save をクリックします。

クエリレポートに基づいてチャートを作成
クエリを作成したら、レポートを実行してチャートを表示する準備ができました。- CLEAR ANALYTICS リボンの Report Explorer をクリックします。
- Report Explorer ペインで、ツールバーの「New Report」アイコンをクリックします。
- 先ほど作成したクエリを選択します。
- レポートに名前を付けて「Save and Execute」をクリックします。

- Report Explorer 内の Results タブをクリックします。
- レポートを展開し、チャートを Excel スプレッドシートにドラッグします。
- 表示される PivotChart ウィンドウで、フィールド(カラム)を Filters、Legends、Axis (Categories)、Values ウィンドウにドラッグします。

Clear Analytics で新しいデータソースを確立し、チャートを作成したら、Zuora のデータ の分析を始める準備ができました。ODBC Driver for Zuora と Clear Analytics を使用すると、Zuora からのライブデータを使って Excel でセルフサービス分析を実行できます。