Aqua Data Studio からCosmos DB データに連携

CData JDBC Driver for CosmosDB は、Aqua Data Studio のようなIDE のウィザード・アナリティクスにCosmos DB データを統合します。本記事では、Cosmos DB データをコネクションマネージャーに接続してクエリを実行する手順を説明します。

JDBC Data Source の設定

コネクションマネージャーで、新しいJDBC データソースとして、接続プロパティ設定を行い、保存します。Cosmos DB データがAqua Data Studio ツールから使えるようになります。

1. Aqua Data Studio で、Server メニューから Register Server を選択します。
2. Register Server フォームで、 'Generic - JDBC' コネクションを選びます。
3. 次のJDBC 接続プロパティを設定します：
   • Name:任意の名前、データソースの名前など。
   • Driver Location:Browse ボタンをクリックして、インストールディレクトリのlib フォルダの cdata.jdbc.cosmosdb.jar ファイルを選択します。
   • Driver:クラス名に cdata.jdbc.cosmosdb.CosmosDBDriver を入力。
   • URL:jdbc:cosmosdb: から始まるJDBC URL を入力します。接続プロパティをカンマ区切りで書きます。接続プロパティの詳細は、ヘルプドキュメントを参照してください。一般的な接続文字列は：
     jdbc:cosmosdb:AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;

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 をこの値に設定します。

Cosmos DB データにクエリを実行

接続したテーブルにクエリを実行してみます。