こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
また、CData ODBC Driver for Zuora を使用して、リアルタイムデータをSAS JMP の統計分析に統合できます。ドライバーは、クエリを直接Zuora API にプロキシし、分析がデータへの変更を反映していることを確認します。CData ODBC Driver は、レポートをデザインする際バックグラウンドでJMP によって使用される、標準SQL をサポートします。
Zuora API は、双方向アクセスをサポートしています。この記事では、Zuora をレポートにアクセスし、データのビジュアライゼーションを作成する方法を説明します。また、SQL を使用してJMP Query Builder からZuora のデータをクエリおよび操作する方法も説明します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Zuora をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにZuora のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてZuora の接続を設定、2.SAP JMP 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとZuora への接続設定
まずは、本記事右側のサイドバーからZuora ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
未指定の場合は、初めにODBC DSN(data source name)で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、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 プロパティを定めることも可能です。これによって返される行数を制限するため、ビジュアライゼーション・レポートのデザイン時のパフォーマンスを向上させるのに役立ちます。
Query Builder でZuora のデータをインポート
Zuora DSN を作成したら、SQL を使用してZuora API の機能を呼び出すことができます。以下のステップに従ってQuery Builder でサポートされているクエリを実行します。
- SAS JMP で[File]->[Database]->[Query Builder]とクリックします。[Select Database Connection]ダイアログが表示されます。
- [New Connection]をクリックします。
- [Machine Data Source]タブで[DSN]を選択します。次のステップでは、[Select Tables for Query]ダイアログが表示されます。
- [Available Tables]セクションでテーブルを選択し、[Primary]をクリックします。
- [Available Columns]を[Included Columns]タブにドラッグすると、基になるSQL クエリが更新されます。
- データを表示するには[Run Query]をクリックします。
- 結果を現在のデータで更新するには、[Update from Database]を右クリックし、[Run Script]をクリックします。
Zuora のデータの操作
以下のようなJSL スクリプトから、データ操作クエリを実行できます。スクリプトを実行するには、ツールバーの[New Script]をクリックします。接続するには、DSN を指定します。これで、標準SQL 構文を使用できるようになります。
Open Database( "DSN=CData Zuora Source;",
"INSERT INTO Invoices
(BillingState)
VALUES ('CA');");
Zuora のデータをビジュアライズ
インポート後、Graph Builder を使用して視覚的にグラフを作成できます。Graph Builder を開くには、ツールバーの[Graph Builder]ボタンをクリックします。
- ディメンションカラムをx 軸にドラッグします。例:Id
- メジャーカラムをy 軸にドラッグします。例:BillingCity
- チャートタイプを選択します。例:棒グラフ
Zuora からSAP JMP へのデータ連携には、ぜひCData ODBC ドライバをご利用ください
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。