製品をチェック

Zuora Driver の30日間無償トライアルをダウンロード

 ダウンロードはこちら

製品の詳細

Zuora アイコン Zuora JDBC Driver 相談したい

Zuora データを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

DBeaver からZuora データに接続する方法

クエリブラウザなど、DBeaver のビジュアルツールを使ってZuora データを管理する方法を解説。

加藤龍彦
ウェブデベロッパー

最終更新日:2023-09-07
zuora ロゴ

CData

jdbc ロゴ画像
DBeaver ロゴ

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

CData JDBC Driver for Zuora は、IDE のウィザードからBI ツールまで、サードパーティーツールからZuora データの読み書きを可能にするJDBC 標準を実装しています。本記事では、DBeaver のウィザードを使ってZuora データに接続し、DBeaver のGUI でデータを参照する方法を紹介します。

Zuora データのJDBC データソースを作成する

以下の手順で、DBeaver にドライバーのJAR ファイルをロードします。

  1. DBeaver アプリケーションを開き、「データベース」メニューの「ドライバーマネジャー」オプションを選択します。「新規」をクリックして「新しいドライバを作成する」フォームを開きます。
  2. 「ドライバ名」ボックスに、ドライバーの分かりやすい名称を入力します。
  3. .jar ファイルを追加するために、「ファイルを追加」をクリックします。
  4. 表示されるダイアログで、インストールディレクトリのlib フォルダにあるcdata.jdbc.zuora.jar ファイルを選択します。
  5. 「クラスを見つける」ボタンをクリックし、検索結果から「Zuora ドライバクラス」を選択します。これにより、フォーム上部にある「クラス名」フィールドが自動的に入力されます。ドライバーのクラス名はcdata.jdbc.zuora.ZuoraDriver です。
  6. 「URL テンプレート」フィールドにjdbc:zuora: を追加します。
JAR パス、ドライバクラス、JDBC URL によって定義されるJDBC データソース(QuickBooks の場合)

Zuora データへの接続を作成する

以下の手順で、認証情報およびその他の必要な接続プロパティを追加します。

  1. 「データベース」メニューから、「新しい接続」をクリックします。
  2. 表示される「新しい接続を作成する」ウィザードで、ドライバーを選択します。
  3. ウィザードで「次へ」をクリックし、表示されたページで「ドライバのプロパティ」タブをクリックします。
  4. 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 サービスを使用します。デフォルトでは、ZuoraServiceAQuADataExport に設定されています。

    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 を生成(Salesforce の場合)

    一般的な接続文字列:

    jdbc:zuora:OAuthClientID=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;Tenant=USProduction;ZuoraService=DataQuery;InitiateOAuth=GETANDREFRESH
接続に必要な認証情報とその他のパラメータ(QuickBooks の場合)

Zuora データにクエリを実行

これで、公開済みテーブルのデータにクエリを実行できるようになりました。「テーブル」を右クリックし、「テーブルの編集」をクリックします。「データ」タブでデータを確認できます。

DBeaver でクエリを実行した結果(QuickBooks の場合)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。