RAD Studio Data Explorer で Zuora のデータ を表示
Embarcadero RAD Studio は、Delphi および C++Builder アプリケーション用の開発環境を提供します。CData ODBC ドライバ for Zuora を使用すると、RAD Studio 内からリアルタイムZuora のデータにアクセスでき、データをテーブル、ビュー、ストアドプロシージャとして抽象化してZuora のデータの取得および更新が可能です。この記事では、Data Explorer を使用して Zuora に接続する方法を説明します。
Zuora への接続を設定
まだ設定していない場合は、ODBC DSN(データソース名)で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、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回再試行可能で、その後失敗として返されます。
Data Explorer を使用して Zuora のデータ に接続
CData FireDAC Components for Zuora と新しい VCL フォームアプリケーションを利用して、Zuora のデータ を表示するシンプルなアプリケーションを作成できます。
- RAD Studio で Data Explorer を開き、FireDAC を展開します。
- Data Explorer で ODBC Data Source ノードを右クリックします。
- [新しい接続の追加] をクリックします。

- 接続の名前を入力します。
- 表示される FireDAC Connection Editor で、DataSource プロパティに Zuora 用 ODBC DSN の名前を設定します。

- Data Explorer に戻り、この接続のテーブルを展開します。
新しい VCL フォームアプリケーションを作成し、テーブル(例: Invoices)をフォームにドラッグします。

- フォーム上の InvoicesTable オブジェクトを選択し、Active プロパティを true に設定します。
オブジェクトを右クリックし、[ビジュアルにバインド] を選択して、すべて(*)を新しいコントロール(TStringGrid)にリンクします。

TStringGrid をフォームに配置し、アプリケーションを実行して Invoices データを確認します。

関連記事
RAD Studio、Delphi、C++ Builder で CData ODBC ドライバを使用するその他の記事は以下をご覧ください。