Metabase で Zuora のデータを連携利用する方法
Metabase は、インタラクティブなダッシュボードを作成できるオープンソースのデータ可視化ツールです。CData Connect AI と組み合わせることで、リアルタイムのZuora のデータにリンクされたビジュアライゼーションやダッシュボードを簡単に作成できます。この記事では、Zuora に接続し、Zuora のデータ を使用してシンプルなビジュアライゼーションを構築する方法を説明します。
CData Connect は Zuora 専用のクラウド間インターフェースを提供し、データをレプリケートすることなく、Metabase でリアルタイムのZuora のデータを簡単に連携できます。Connect はMetabase からSQL Server データベースと同じように見え、最適化されたデータ処理を標準で使用して、サポートされているすべてのSQL 操作（フィルター、JOIN など）を Zuora に直接プッシュし、サーバーサイド処理を活用してZuora のデータを迅速に返します。
Metabase 用に Zuora への接続を設定
Metabase から Zuora への接続は、CData Connect AI によって実現されます。Metabase からZuora のデータを操作するには、まず Zuora 接続を作成し設定します。
- 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」タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token の追加
REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token（PAT）を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
- Settings ページで「Access Tokens」セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
接続の設定とPAT の生成が完了したら、Metabase からZuora のデータに接続する準備が整いました。
Metabase からCData Connect AI に接続
Connect AI で接続を作成したら、Metabase インスタンスに移動します。SQL Server インターフェースを使用してConnect AI に接続します。
- 管理画面（Settings -> Admin）に移動し、「Databases」タブから「Add Database」をクリックします
- Connect AI への接続を設定し、「Save」をクリックします
- Database type: 「SQL Server」を選択します
- Name: 接続に名前を付けます（例：「Zuora (Connect AI)」）
- Host: tds.cdata.com
- Port: 14333
- Database name: 先ほど作成した接続の名前（例：Zuora1）
- Username: Connect AI のユーザー名（例：user@mydomain.com）
- Password: 先ほど作成したPAT
- Use a secure connection (SSL) にチェックを入れます
Metabase で Zuora のデータを実行
Connect AI への接続を設定したら、Zuora にクエリを実行してビジュアライゼーションを構築できます。
- 「Write SQL」ツールを使用してZuora のデータを取得します
- CData Connect AI の Zuora 接続に基づいてSQL クエリを記述します。例：
SELECT Id, BillingCity FROM Invoices WHERE BillingState = 'CA'
- 「Visualization」画面に移動し、ビジュアライゼーションを選択して設定します
詳細情報と無償トライアル
これで、Metabase でZuora のデータからシンプルなビジュアライゼーションを構築できました。Metabase では、SQL Server データベースと同じようにリアルタイムのZuora のデータを引き続き操作できます。Zuora（およびその他100以上のデータソース）へのリアルタイム接続の詳細については、Connect AI ページをご覧ください。無償トライアルに登録して、今すぐMetabase でリアルタイムのZuora のデータを活用してみてください。