Azure Cosmos DB for NoSQL コンテナーのインデックス作成ポリシーをクエリ用に最適化する

Azure Cosmos DB for NoSQL アカウントを計画するときは、最も一般的なクエリを把握することにより、クエリのパフォーマンスができるだけ向上するように、インデックス作成ポリシーを調整することができます。

このラボでは、データエクスプローラーを使用して、既定のインデックス作成ポリシーと複合インデックスを含むインデックス作成ポリシーを使用して SQL クエリをテストします。

Azure Cosmos DB for NoSQL アカウントを作成する

Azure Cosmos DB は、複数の API をサポートするクラウドベースの NoSQL データベースサービスです。 Azure Cosmos DB アカウントを初めてプロビジョニングするときに、そのアカウントでサポートする API (たとえば、Mongo API や NoSQL API) を選択します。 Azure Cosmos DB for NoSQL アカウントのプロビジョニングが完了したら、エンドポイントとキーを取得し、Azure SDK for .NET または任意の他の SDK を使用して Azure Cosmos DB for NoSQL アカウントに接続する際に使用できます。

新しい Web ブラウザーウィンドウまたはタブで、Azure portal (portal.azure.com) に移動します。
ご利用のサブスクリプションに関連付けられている Microsoft 資格情報を使用して、ポータルにサインインします。

[+ リソースの作成] を選択し、Cosmos DB を検索して、新しい Azure Cosmos DB for NoSQL アカウントリソースを作成します。以下を設定して、残りの設定はすべて既定値のままにします。

設定	Value
サブスクリプション	’‘既存の Azure サブスクリプション’’
リソースグループ	’‘既存のリソースグループを選択するか、新しいものを作成します’’
アカウント名	’‘グローバルに一意の名前を入力します’’
場所	’‘使用可能なリージョンを選びます’’
容量モード	サーバーレス

📝 ご利用のラボ環境には、新しいリソースグループを作成できない制限が存在する場合があります。その場合は、事前に作成されている既存のリソースグループを使用します。

デプロイタスクが完了するまで待ってから、このタスクを続行してください。
新しく作成された Azure Cosmos DB アカウントリソースにアクセスし、[データエクスプローラー] ペインに移動します。
[データエクスプローラー] ペインで、 [新しいコンテナー] を選択します。

[新しいコンテナー] ポップアップで、各設定に次の値を入力してから [OK] を選択します。

設定	Value
データベース ID	新規作成 \| `cosmicworks`
コンテナー ID	`products`
パーティションキー	`/categoryId`

[データエクスプローラー] ペインに戻り、cosmicworks データベースノードを展開して、階層内の products コンテナーノードを確認します。
リソースブレードで、[キー] ペインに移動します。
このペインには、SDK からアカウントに接続するために必要な接続の詳細と資格情報が含まれています。具体的な内容は次のとおりです。
1. [URI] フィールドに注目します。このエンドポイントの値は、この演習で後ほど使用します。
2. [主キー] フィールドに注目します。このキーの値は、この演習で後ほど使用します。
Visual Studio Code を開きます。

Azure Cosmos DB for NoSQL アカウントにサンプルデータをシードする

cosmicworks データベースと products コンテナーを作成するコマンドラインユーティリティを使用します。ツールで一連の項目を作成して、ターミナルウィンドウで実行されている変更フィードプロセッサを使用して確認します。

Visual Studio Code で、[ターミナル] メニューを開き、[新しいターミナル] を選択して新しいターミナルを開いてください。
[cosmicworks][nuget.org/packages/cosmicworks] コマンドラインツールをインストールして、マシンにグローバルに使用できるようにします。
```
 dotnet tool install cosmicworks --global --version 1.*
```
💡 このコマンドが完了するまで数分かかる場合があります。過去にこのツールの最新バージョンを既にインストールしている場合は、このコマンドによって警告メッセージ (*ツール ‘cosmicworks’ は既にインストールされています) が出力されます。

cosmicworks を実行し、次のコマンドラインオプションを使用して Azure Cosmos DB アカウントをシードします。

オプション	Value
–endpoint	’‘このラボで先ほどコピーしたエンドポイントの値’’
–key	’‘このラボで先ほどコピーしたキーの値’’
–datasets	product

 cosmicworks --endpoint <cosmos-endpoint> --key <cosmos-key> --datasets product

📝 たとえば、エンドポイントが https://dp420.documents.azure.com:443/ で、キーが fDR2ci9QgkdkvERTQ== の場合、コマンドは次のようになります。cosmicworks --endpoint https://dp420.documents.azure.com:443/ --key fDR2ci9QgkdkvERTQ== --datasets product

cosmicworks コマンドによって、データベース、コンテナー、および項目がアカウントに設定されるまで待ちます。
統合ターミナルを閉じます。
Visual Studio Code を閉じて、ブラウザーに戻ります。

SQL のクエリを実行し、要求ユニットの料金を測定する

インデックス作成ポリシーを変更する前に、まず、いくつかのサンプル SQL クエリを実行して、ru に示されているベースライン要求ユニットの料金を取得します。インデックス作成ポリシーを変更する前に、まず、いくつかのサンプル SQL クエリを実行して、RU で表されるベースライン要求ユニットの料金を取得します。

Azure Cosmos DB アカウントリソース内で、 [データエクスプローラー] ペインに移動します。
[データエクスプローラー] で、cosmicworks データベースノードを展開し、products コンテナーノードを選択してから、[新しい SQL クエリ] を選択します。
[クエリの実行] を選択して、既定のクエリを実行します。
```
 SELECT * FROM c
```
クエリの結果を確認します。 [クエリ統計] を選択すると、RU の要求ユニットの料金が表示されます。
エディター領域のコンテンツを削除します。
すべてのドキュメントから 3 つの値をすべて返す新しい SQL クエリを作成します。
```
 SELECT 
     p.name,
     p.categoryName,
     p.price
 FROM
     products p    
```
[クエリの実行] を選択します。
クエリの結果と統計を確認します。要求ユニットの料金は、最初のクエリとほぼ同じです。
エディター領域のコンテンツを削除します。
すべてのドキュメントから 3 つの値を categoryName 順に並べ替えて返す新しい SQL クエリを作成します。
```
 SELECT 
     p.name,
     p.categoryName,
     p.price
 FROM
     products p
 ORDER BY
     p.categoryName DESC
```
[クエリの実行] を選択します。
クエリの結果と統計を確認します。 ORDER BY 句が原因で、要求ユニットの料金が増加しています。

インデックス作成ポリシーで複合インデックスを作成する

ここで、複数のプロパティを使用して項目を並べ替える場合は、複合インデックスを作成する必要があります。このタスクでは、項目を categoryName で並べ替えてから、実際の名前で並べ替える複合インデックスを作成します。

[データエクスプローラー] で、cosmicworks データベースノードを展開し、products コンテナーノードを選択してから、[新しい SQL クエリ] を選択します。
エディター領域のコンテンツを削除します。
結果を最初に categoryName の降順で並べ替え、次に price の昇順で並べ替える新しい SQL クエリを作成します。
```
 SELECT 
     p.name,
     p.categoryName,
     p.price
 FROM
     products p
 ORDER BY
     p.categoryName DESC,
     p.price ASC
```
[クエリの実行] を選択します。
クエリは、並べ替えクエリには、サービスを提供できる対応する複合インデックスがありませんというエラーが発生し、失敗します。
[データエクスプローラー] で、cosmicworksデータベースノード、products コンテナーノードの順に展開してから、[設定] を選択します。
[設定] タブで、[インデックス作成ポリシー] セクションに移動します。

既定のインデックス作成ポリシーを確認します。

 {
   "indexingMode": "consistent",
   "automatic": true,
   "includedPaths": [
     {
       "path": "/*"
     }
   ],
   "excludedPaths": [
     {
       "path": "/\"_etag\"/?"
     }
   ]
 }

インデックス作成ポリシーを、次の変更した JSON オブジェクトに置き換え、変更内容を保存します。

 {
   "indexingMode": "consistent",
   "automatic": true,
   "includedPaths": [
     {
       "path": "/*"
     }
   ],
   "excludedPaths": [],
   "compositeIndexes": [
     [
       {
         "path": "/categoryName",
         "order": "descending"
       },
       {
         "path": "/price",
         "order": "ascending"
       }
     ]
   ]
 }

[データエクスプローラー] で、cosmicworks データベースノードを展開し、products コンテナーノードを選択してから、[新しい SQL クエリ] を選択します。
エディター領域のコンテンツを削除します。
結果を最初に categoryName の降順で並べ替え、次に price の昇順で並べ替える新しい SQL クエリを作成します。
```
 SELECT 
     p.name,
     p.categoryName,
     p.price
 FROM
     products p
 ORDER BY
     p.categoryName DESC,
     p.price ASC
```
[クエリの実行] を選択します。
クエリの結果と統計を確認します。今回は、クエリが完了したので、RU の料金をもう一度確認できます。
エディター領域のコンテンツを削除します。
結果を最初に categoryName の降順で、次に name の昇順で、最後に price の昇順で並べ替える新しい SQL クエリを作成します。
```
 SELECT 
     p.name,
     p.categoryName,
     p.price
 FROM
     products p
 ORDER BY
     p.categoryName DESC,
     p.name ASC,
     p.price ASC
```
[クエリの実行] を選択します。
クエリは、並べ替えクエリには、サービスを提供できる対応する複合インデックスがありませんというエラーが発生し、失敗します。
[データエクスプローラー] で、cosmicworksデータベースノード、products コンテナーノードの順に展開してから、[設定] を再度選択します。
[設定] タブで、[インデックス作成ポリシー] セクションに移動します。