クイックスタート: Azure portal を使用して Azure Cosmos DB for NoSQL アカウントを作成する

適用対象: NoSQL

• Azure Portal
• Bicep
• Terraform
• Azure Resource Manager (JSON)

このクイックスタートでは、Azure portal で新しい Azure Cosmos DB for NoSQL アカウントを作成します。 その後、Azure portal 内でデータ エクスプローラー エクスペリエンスを使用して、必要なすべての設定を構成するデータベースとコンテナーを作成します。 最後に、コンテナーにサンプル データを追加し、基本的なクエリを発行します。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。

アカウントを作成する

新しい Azure Cosmos DB for NoSQL アカウントの作成して開始する

1. Azure portal (https://portal.azure.com) にサインインします。

2. グローバル検索バーに「Azure Cosmos DB」と入力します。

   

3. [サービス] で [Azure Cosmos DB] を選択します。

   

4. [Azure Cosmos DB アカウントの作成] ウィンドウで、[作成]、[Azure Cosmos DB for NoSQL] の順に選択します。

   

   

5. [基本情報] ウィンドウで、次のオプションを構成し、[レビュー + 作成] を選択します。

   	Value
   サブスクリプション	お使いの "Azure サブスクリプション" を選択します
   リソース グループ	新しいリソース グループを作成する、あるいは既存のリソース グループを選択します
   取引先企業名	グローバルに一意の名前を指定します
   可用性ゾーン	無効にする
   Location	サブスクリプションでサポートされている Azure リージョンを選択します

   

   ヒント

   指令されていないオプションは既定値のままでかまいません。 アカウントの合計処理能力を 1 秒あたり 1,000 要求ユニット (RU/秒) に制限し、Free レベルを有効にしてコストを最小限に抑えるようにアカウントを構成することもできます。

6. [レビュー + 作成] ウィンドウで、アカウントの検証が正常に完了するまで待ってから、[作成] を選択します。

   

7. Portal は自動的に [展開] ウィンドウに移動します。 デプロイが完了するまで待ちます。

   

8. 展開が完了したら、[リソースに移動] を選択して、新しい Azure Cosmos DB for NoSQL アカウントに移動します。

   

データベースとコンテナーを作成する

次に、データ エクスプローラーを使用して、データベースとコンテナーを作成します。

1. [アカウント リソース] ウィンドウで、サービス メニューの [データ エクスプローラー] を選択します。

   

2. [データ エクスプローラー] ウィンドウで、[新しいコンテナー] オプションを選択します。

   

3. [新しいコンテナー] ダイアログで、次の値を設定して [OK] を選択します。

   	値
   データベース	新規作成
   データベース ID	cosmicworks
   コンテナー間でスループットを共有する	選択しません
   コンテナー ID	employees
   パーティション キー	department/name
   コンテナーのスループット (自動スケーリング)	Autoscale
   コンテナーの最大 RU/秒	1000

   

4. demo.bicepparam または (demo.bicepparam) という名前の新しいファイルを作成します。

5. データ エクスプローラーの階層内で、新しく作成されたデータベースとコンテナーを確認します。

   

   ヒント

   必要に応じて、コンテナー ノードを展開して、追加のプロパティと構成設定を確認できます。

サンプル データの追加とクエリ

最後に、データ エクスプローラーを使用してサンプル品目を作成し、コンテナーに基本的なクエリを発行します。

1. データ エクスプローラーのツリーで、[従業員] コンテナーのノードを展開します。 次に、[品目] オプションを選択します。

   

2. [データ エクスプローラー] メニューで [新しい品目] を選択します。

   

3. まず、[従業員] コンテナーに新しい品目に対して次の JSON を挿入し、[保存] を選択します。

   {
     "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
     "name": {
       "first": "Kai",
       "last": "Carter"
     },
     "email": "<kai@adventure-works.com>",
     "department": {
       "name": "Logistics"
     }
   }
   

   

4. [データ エクスプローラー] メニューで [新しい SQL クエリ] を選択します。

   

5. まず、次の NoSQL クエリを挿入して、大文字と小文字を区別しない検索を使用して、logistics 部門のすべての品目を取得します。 その後、クエリによって、出力が構造化された JSON オブジェクトとして書式設定されます。 クエリを実行するには [クエリの実行] を選択します。

   SELECT VALUE {
       "name": CONCAT(e.name.last, " ", e.name.first),
       "department": e.department.name,
       "emailAddresses": [
           e.email
       ]
   }
   FROM
       employees e
   WHERE
       STRINGEQUALS(e.department.name, "logistics", true)
   

   

6. クエリからの JSON 配列の出力を確認します。

   [
     {
       "name": "Carter Kai",
       "department": "Logistics",
       "emailAddresses": [
         "kai@adventure-works.com"
       ]
     }
   ]
   

   

関連するコンテンツ

• Data Explorer
• NoSQL クエリ構文
• リソース モデル