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

Mohsin Turki
Technical Marketing Engineer

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

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

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

Jitterbit 向けに Cosmos DB 接続を構成

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

Connect AI から Cosmos DB に接続

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

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

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

Cosmos DB に接続するために必要な認証プロパティを入力します。
CosmosDB 接続プロパティの取得・設定方法

SQL API を使ってCosmos DB アカウントに接続するために必要な接続文字列を取得するには、Azure Portal にログインして「Azure Cosmos DB」を選択し、自分のアカウントを選択します。「Settings」セクションで、「Connection String」をクリックして次の値を設定します。
- AccountEndpoint：この値は、Cosmos DB アカウントの「Keys」ブレードからのCosmos DB アカウントURL に設定してください。
- AccountKey：Azure ポータルで、Cosmos DB サービスに移動してAzure Cosmos DB アカウントを選択します。リソースメニューから、「Keys」ページに移動します。「PRIMARY KEY」値を見つけ、Token をこの値に設定します。
Save & Test をクリックします。
Add Cosmos DB 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 向けに Cosmos DB エンドポイントを構成

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

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

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

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

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 を入力します。