Excel からMicrosoft Query を使ってCosmos DB に接続

CData ODBC Driver for CosmosDB は、標準ODBC インターフェースを使ってCosmos DB data をMicrosoft Access やExcel のようなアプリケーションと繋ぎます。以下の手順に従ってMicrosoft Query を使ってCosmos DB data をスプレッドシートにインポートし、スプレッドシートのセルからパラメータ化されたクエリに値を提供します。

1. 接続プロパティが未設定の場合には、DSN（データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

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

   AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」を参照してください。

2. Excel で［データ］タブを開き［その他のデータソースから］>［Microsoft Query から］を選びます。
3. マシンにインストールされているMicrosoft Office のバージョンに合わせて、32 bit CData Cosmos DB Source または64 bit CData Cosmos DB Source x64 DSN を選びます。Query Wizard を使うオプションを選択し、クエリを作成／編集します。
4. Query Wizard で、スプレッドシートにインポートしたいテーブルのノードを展開します。インポートしたいカラムを選択し、矢印をクリックしてクエリに追加します。あるいはテーブル名を選択して、テーブルにあるすべてのカラムを追加します。
5. ［Filter Data］ページではクライテリアを指定できます。例えば、日付の範囲を設定して結果を絞れます。
6. クエリでパラメータを使いたい場合は、Microsoft Query でクエリを編集するオプションを選択します。

7. クエリにパラメータを設定するには、SQL ステートメントを直接修正する必要があります。その場合は、［Query Editor］の［SQL］ボタンをクリックします。フィルタクライテリアを事前に設定している場合は、クエリ内にWHERE 句が存在します。

   パラメータを使うには、WHERE 句のフィールド値にワイルドカード文字として "?" を使います。例えばCustomers をインポートしている場合は、"Name=?" を設定できます。

8. SQL ステートメントの編集が終わったら［SQL］ダイアログを閉じます。パラメータ値を入力するように促されますが、次のステップでセルを選択して値を入れることになるので、このダイアログではボックスは空のままにしておきます。

9. Microsoft Query を閉じます。［Import Data］ダイアログが表示されます。結果をインポートするセルを入力します。

10. ［Import Data］ダイアログを閉じます。パラメータ値を入力するように促されます。パラメータボックスの隣にあるボタンをクリックしてセルを選択します。値が変更されたらスプレッドシートを自動的にリフレッシュするオプションを選択します。