APOS Live Data Gateway で Cosmos DB のデータのセマンティックレイヤービューを構築

Dibyendu Datta
Lead Technology Evangelist

CData Connect AI と APOS Live Data Gateway を使用してCosmos DB のデータのセマンティックレイヤービューを構築します。

APOS Live Data Gateway（LDG）は、データ接続とデータ変換のソリューションとして機能し、SAP Analytics Cloud やその他の SAP ソリューション向けにライブデータ接続を促進し、データソースの可能性を広げます。CData Connect AI と統合することで、ユーザーはCosmos DB のデータにリアルタイムアクセスするためのセマンティックレイヤービューを構築でき、リレーショナルデータベースと同様の方法で Cosmos DB のリアルタイム分析が可能になります。

CData Connect AI は Cosmos DB に接続するための専用 SQL Server インターフェースを提供し、ネイティブ対応データベースへのデータレプリケーションを必要とせずに Cosmos DB から直接データをクエリできます。事前に最適化されたデータ処理機能を備えており、CData Connect AI はフィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に Cosmos DB へ直接送信します。サーバーサイド処理を活用することで、要求されたCosmos DB のデータを迅速に取得できます。

APOS Live Data Gateway 用に Cosmos DB への接続を設定

APOS Live Data Gateway から Cosmos DB への接続は CData Connect AI を介して行います。APOS Live Data Gateway でCosmos DB のデータを操作するには、まず Cosmos DB への接続を作成・設定します。

Connect AI にログインして「Sources」をクリック、次に「 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」をクリック
Cosmos DB 接続の追加ページで「Permissions」タブに移動し、ユーザーベースのアクセス許可を設定します。

Personal Access Token の作成

REST API、OData API、または Virtual SQL Server を介して Connect AI に接続する場合、Personal Access Token（PAT）を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別の PAT を作成することをお勧めします。

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

接続と PAT が設定できたので、APOS Live Data Gateway からCosmos DB のデータに接続する準備が整いました。

Cosmos DB への接続とセマンティックレイヤービューの作成

CData Connect AI で接続を設定したら、Live Data Gateway Admin ツールで Cosmos DB に接続し、Live Data Gateway Web UI でセマンティックレイヤービューを構築する準備が整います。

Cosmos DB への接続を設定

APOS Live Data Gateway Manager にログインします。
まだの場合は、APOS LDG ライセンスファイルを更新します。
1. 「File」→「Configurations」をクリック
2. License の「...」メニューをクリック
3. CData Connect AI ライセンスを含む APOS チームからのライセンスファイルを選択
APOS Live Data Gateway Manager で「Add」をクリックします。
APOS Live Data Gateway の「Connection」タブで接続を設定します。
- Data Source を「Database」に設定
- Database を「JDBC Generic」に設定
- Connection String を以下のような接続文字列に設定（先ほど設定した接続名を使用）:
```
jdbc:sqlserver://tds.cdata.com:14333;databaseName=CosmosDB1
```
- Driver Class を「com.CData.connect.Driver」に設定（デフォルトで設定されています）
「Test Connection」をクリック
「Save」をクリック
接続に一意のプレフィックスを付けます（例: "cosmosdb"）
新しく作成した接続をハイライトし、「File」→「Approve Users For Web UI」をクリックします。
ビューを作成できる適切な DB ユーザーを承認し、「Save」をクリックします。