DbVisualizer で Cosmos DB データに連携しクエリを作成

CData JDBC Driver for CosmosDB は、JDBC 標準に準拠し、BI ツールからIDE まで幅広いアプリケーションでCosmos DB への接続を提供します。この記事では、DbVisualizer からCosmos DB に接続する方法、およびtable エディタを使ってCosmos DB を 編集、および保存 する方法を説明します。

Cosmos DB データの新しいJDBC データソースを作成

下記の手順に従って、Driver Manager を使ってDbVisualizer ツールからCosmos DB に接続します。

1. DbVisualizer で［Tools］>［Driver Manager］>［Create a New Driver］をクリックします。
2. データソースに名前を入力します。
3. ［URL Format］ボックスに以下を入力します： jdbc:cosmosdb:
   DbVisualizer Driver Manager
4. ［User Specified］タブで［User Specified］ボタンをクリックし、インストールディレクトリの［lib］サブフォルダ内のcdata.jdbc.cosmosdb.jar ファイルを選択します。
5. ［Driver Class］メニューでCosmosDBDriver クラス、cdata.jdbc.cosmosdb.CosmosDBDriver を選択します。

JDBC データソースへの接続を定義

下記の手順に従って、JDBC URL に接続プロパティを入力します。

1. ［Database］ タブで［Database Connection］ノードを右クリックし、［Create a Database Connection］をクリックします。

2. ［Connection］セクションで以下のオプションを設定します：

   • Database Type：ウィザードオプションを選択した場合は、データベースの種類は自動検出される。ウィザードを使用しないオプションを選択した場合は、［Database Type］メニューから［Generic］または［Auto Detect］オプションを選択。
   • Driver：先ほど作成したドライバーを選択。

   • Database URL：フルJDBC URL を入力。JDBC URL シンタックスは以下のとおりです。 jdbc:cosmosdb: 次に、セミコロン区切りでname-value ペアの接続プロパティを入力します。

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

     一般的な接続文字列は次のとおりです。

     jdbc:cosmosdb:AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;
   • Database UserId：Cosmos DB を認証するユーザーネーム。
   • Database Password：Cosmos DB を認証するパスワード。

3. ［Connection］タブで［Connect］をクリックします。

QuickBooks JDBC Driver が表示するテーブルをブラウズするには、テーブルを右クリックし［Open In New Tab］をクリックします。

SQL クエリの実行には、SQL Commander ツールを使います：［SQL Commander］>［New SQL Commander］をクリックします。利用可能なメニューから［Database Connection］、［Database］、［Schema］を選択します。

サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。