CDATAQUERY 関数を使って、Excel スプレッドシートにCosmos DB を自動挿入

CData Excel Add-In for CosmosDB の関数を使って、スプレッドシートにデータを取り込むことができます。下記の3つの手順では、次のタスクを自動化する方法について説明します：ユーザー定義の値でCosmos DB を検索し、その結果をExcel スプレッドシートに出力します。

CDATAQUERY 関数の構文は次のとおりです： =CDATAQUERY(Query, [Connection], [Parameters], [ResultLocation]);

この関数に入力する値は以下の3つです：

• Query：取得したいCosmos DB data レコードの宣言、もしくは修正を簡単な構文で記述。
• Connection：CosmosDBConnection1 のような接続名、もしくは接続文字列を入力。接続文字列は、Cosmos DB への接続に必要なプロパティのセミコロン区切りとなります。一般的な接続文字列は次のとおりです：
  • AccountEndpoint
  • AccountKey

  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 をこの値に設定します。
• ResultLocation：結果のアウトプットを開始するセル。

スプレッドシートのセルをクエリのインプットとして渡す

下記の処理では、すべての関数インプットをひとつ目のカラムでオーガナイズするスプレッドシートができます。

1. 関数をインプットするセルを定義します。接続インプットに加えて、Name のように、Cosmos DB の検索に使われるフィルタ用の基準を定義する追加のインプットを入力します。
2. 別のセルに、上で定義したユーザーインプットセルからセルの値を参照する関数を書きます。住所などスペースを含む可能性のある値は、シングルクオートで囲みます。
=CDATAQUERY("SELECT * FROM Customers WHERE Name = '"&B3&"'","AccountEndpoint="&B1&";AccountKey="&B2&";Provider=CosmosDB",B4)
3. フィルタを変更してデータを変更します。