Jitterbit でライブ Zuora のデータと連携

Mohsin Turki
Technical Marketing Engineer

CData Connect AI を使用して、Jitterbit でライブ Zuora のデータに接続・連携します。

Jitterbit は、データワークフローを効率化できるエンタープライズ iPaaS（Integration Platform as a Service）です。CData Connect AI と組み合わせることで、Jitterbit からライブ Zuora のデータにアクセスできます。この記事では、Connect AI を使用して Zuora に接続し、Jitterbit でライブ Zuora のデータと連携する方法を説明します。

CData Connect AI は Zuora 用の純粋な OData インターフェースを提供し、ネイティブにサポートされているデータベースにデータをレプリケーションすることなく、Zuora からデータをクエリできます。CData Connect AI は最適化されたデータ処理機能を標準で備えており、サポートされているすべての SQL 操作（フィルタ、JOIN など）を Zuora に直接プッシュし、サーバーサイド処理を活用して、リクエストされた Zuora のデータを迅速に返します。

Jitterbit 向けに Zuora 接続を構成

Jitterbit から Zuora のデータを操作するには、Connect AI から Zuora に接続し、ユーザーにアクセス権を付与し、Zuora のデータ用のワークスペースを作成する必要があります。

Connect AI から Zuora に接続

CData Connect AI は、シンプルなポイント＆クリックインターフェースを使用してデータソースに接続します。

Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします。

Add Connection パネルから「Zuora」を選択します。

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 サービスを使用します。デフォルトでは、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回再試行可能で、その後失敗として返されます。
Save & Test をクリックします。
Add Zuora Connection ページの Permissions タブに移動し、User-based permissions を更新します。

パーソナルアクセストークンの追加

REST API、OData API、または仮想 SQL Server を介して Connect AI に接続する場合、パーソナルアクセストークン（PAT）を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに別々の PAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
PAT に名前を付け、Create をクリックします。
パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

Jitterbit 向けに Zuora エンドポイントを構成

Zuora に接続した後、目的のテーブル用のワークスペースを作成します。

Workspaces ページに移動し、 Add をクリックして新しいワークスペースを作成します（または既存のワークスペースを選択します）。
Add をクリックして、ワークスペースに新しいアセットを追加します。
Zuora 接続（例：Zuora1）を選択し、Next をクリックします。
操作するテーブルを選択し、Confirm をクリックします。
ワークスペースの OData Service URL（例：https://cloud.cdata.com/api/odata/{workspace_name}）をメモしておきます。

接続、PAT、およびワークスペースの構成が完了すると、Jitterbit から Zuora のデータに接続する準備が整います。

Connect AI を使用して Jitterbit から Zuora に接続

OData プロトコルを使用して Jitterbit から CData Connect AI への接続を確立するには、以下の手順に従います。

Jitterbit にログインします。
Cloud Studio でプロジェクトを作成し、ワークスペース環境を設定します。
Sources をクリックし、検索バーに OData と入力します。
OData コネクタを選択します。
OData 接続プロパティを入力します。

Connection Name：接続名を入力します。
OData Metadata URL：https://cloud.cdata.com/api/odata/{workspace_name} と入力します。
Authentication：Basic Auth を選択します。
User Name：CData Connect AI のユーザー名を入力します。これは CData Connect AI インターフェースの右上に表示されます（例：[email protected]）。
Password：Settings ページで生成した PAT を入力します。