製品をチェック

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

 ダウンロードはこちら

製品の詳細

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

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

SnapLogic でZuora を外部サービスに連携

CData JDBC Driver を使用して、SnapLogic と外部サービスを連携。

古川えりか
コンテンツスペシャリスト

最終更新日:2021-11-05
zuora ロゴ

CData

jdbc ロゴ画像
SnapLogic ロゴ

こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。

SnapLogic はintegration Platform-as-a-Service(iPaaS)であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC Drivers と組み合わせることで、ユーザーはSnapLogic ワークフローからZuora を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムZuora データを高速に扱えます。プラットフォームがZuora に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をZuora に直接プッシュし、サポートされていない操作(主にSQL 関数とJOIN 操作)は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してZuora データを操作することができます。

SnapLogic からZuora に接続する

SnapLogic からZuora データに接続するには、CData Zuora JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ(デフォルトでは、C:/Program Files/CData/CData JDBC Driver for Zuora/lib)にJAR ファイルが作成されます。

Zuora JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ(例えば、projects/Jerod Johnson)にManager タブからアップロードします。

アップロードされたJDBC Driver(Salesforce とQuickBooks Online の場合)

接続を設定する

JDBC Driver がアップロードされると、Zuora への接続を作成できます。

  1. Designer タブに移動します。
  2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。 designer にGeneric JDBC snap を追加
  3. Add Account をクリック(または既存のものを選択)して、「Continue」をクリックします。
  4. 次のフォームでは、JDBC 接続プロパティを設定します。
    • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
    • JDBC Driver Classcdata.jdbc.zuora.ZuoraDriver に設定します。
    • JDBC URL をZuora JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

      jdbc:zuora:OAuthClientID=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;Tenant=USProduction;ZuoraService=DataQuery;RTK=XXXXXX;InitiateOAuth=GETANDREFRESH
      です。

      NOTE: RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください接続を設定(Salesforce の場合)

      組み込みの接続文字列デザイナー

      JDBC URL の作成の補助として、Zuora JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

      java -jar cdata.jdbc.zuora.jar

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      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 を生成(Salesforce の場合)
  5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

Zuora データを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

  • Schema name を"Zuora" に設定します。
  • Table name を、スキーマ名を使用したZuora 用のテーブルに設定します。例えば、"Zuora"."Invoices" です(ドロップダウンを使用して利用可能なテーブルの全リストを確認できます)。
  • テーブルから、使用したい項目ごとにOutput fields を追加します。
Select snap を設定(Salesforce の場合)

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分(以下のハイライト部分)をクリックしてデータをプレビューします。

snap の終端部分をクリックしてデータをプレビュー。

結果が期待どおりのものであることを確認したら、他のsnap を追加してZuora データを別のエンドポイントに渡すこともできます。

データをプレビュー(Salesforce の場合)。

Zuora データを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC Driver と利用してデータを外部サービスに移すこともできます。

  1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
  2. Google Sheets に接続するアカウントを追加します。 Google に接続
  3. Worksheet Writer snap を、Zuora データをGoogle Spreadsheet に書き込むよう設定します。 Google Spreadsheet に書き込み

これで、接続済みのパイプラインを実行してZuora からデータを抽出し、Google Spreadsheet にプッシュできます。

Google Spreadsheets に書き込まれたデータ(Salesforce の場合)

外部データをZuora にパイプ

上述のように、JDBC Driver for Zuora をSnapLogic から使用してデータをZuora に書き込むことができます。まずは、Generic JDBC - Insert またはGeneric JDBC - Update snap をダッシュボードに追加します。

  1. 既存の「Account」(接続)を選択するか、新しく作成します。
  2. クエリの設定。
    • Schema name を"Zuora" に設定します。
    • Table name をスキーマ名を使用したZuora のテーブルに設定します。例えば、"Zuora"."Invoices"(ドロップダウンを使用して利用可能な全テーブルの一覧を確認できます)。
    INSERT snap を設定(Salesforce の場合)
  3. Generic JDBC - Insert/Update snap を保存します。

これで、Zuora にデータを書き込んだり、新しいレコードを挿入したり、既存のレコードを更新するsnap が設定できました。

詳細情報と無償評価版

CData JDBC Driver for Zuora を使えば、Zuora データを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。Zuora への接続に関する詳細については、CData のZuora 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。

関連コンテンツ

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

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