MySQL Workbench で Cosmos DB のデータをクエリする方法

Cosmos DB 用のODBC Driver のSQL Gateway を使用すると、MySQL インターフェースを通じて Cosmos DB のデータ にクエリできます。以下の手順に従って、SQL Gateway のMySQL リモーティングサービスを起動し、MySQL Workbench でリアルタイムの Cosmos DB のデータ を操作してみましょう。

Cosmos DB のデータへの接続

まだ接続設定を行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を入力してください。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

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

SQL Gateway の設定

SQL Gateway の概要を参照して、Cosmos DB のデータ への接続を仮想MySQL データベースとしてセットアップしてください。クライアントからのMySQL リクエストをリッスンするMySQL リモーティングサービスを設定します。このサービスはSQL Gateway UI で設定できます。

MySQL Workbench から Cosmos DB をクエリ

以下の手順では、SQL Gateway で作成した仮想 Cosmos DB データベースにMySQL Workbench から接続し、基本的なクエリを発行してリアルタイムの Cosmos DB のデータ を操作する方法を説明します。

SQL Gateway 経由で Cosmos DB に接続

1. MySQL Workbench で、新しいMySQL 接続を追加するためにクリックします。
2. 接続に名前を付けます（CData SQL Gateway for Cosmos DB）。
3. SQL Gateway に接続するためのHostname、Port、Username パラメータを設定します。
4. Store in Vault をクリックしてパスワードを設定・保存します。
5. Test Connection をクリックして接続が正しく設定されていることを確認し、OK をクリックします。

NOTE: Username および Password は、SQL Gateway 用に作成したユーザーの資格情報を指します。

Cosmos DB のデータをクエリ

1. 作成した接続（CData SQL Gateway for Cosmos DB）を開きます。
2. File -> New Query Tab をクリックします。
3. SELECT * FROM `CData CosmosDB Sys`.Customers; のようなSQL クエリを記述して Cosmos DB のデータ を取得します。

MySQL Workbench からリアルタイムの Cosmos DB のデータ にアクセスできるようになりました。MySQL データベースと同じ感覚で Cosmos DB を簡単に操作できます。CData ODBC Driver for Cosmos DB とCData SQL Gateway の30日間の無償トライアルをぜひお試しください。