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

Azure Cosmos DB について深く掘り下げる前に、よく使用するリソースの作成の基本を理解することが重要です。 ほとんどのシナリオでは、アカウント、データベース、コンテナー、および項目の作成に慣れている必要があります。 実際のシナリオでは、すべてのリソースが正しく作成されていることをテストするために、いくつかの基本的なクエリを “手元に” 用意しておくことも必要があります。

このラボでは、新しい Azure Cosmos DB アカウントを for NoSQL を使用して作成します。 次に、データ エクスプローラーを使用して、データベース、コンテナー、2 つの項目を作成します。 最後に、データベースに対してクエリを実行して、作成した項目を確認します。

新しい Azure Cosmos DB アカウントを作成する

Azure Cosmos DB は、複数の API をサポートするクラウドベースの NoSQL データベース サービスです。 Azure Cosmos DB アカウントを初めてプロビジョニングするときに、そのアカウントでサポートする API (たとえば、Mongo API や NoSQL API) を選択します。

  1. 新しい Web ブラウザー ウィンドウまたはタブで、Azure portal (portal.azure.com) に移動します。

  2. ご利用のサブスクリプションに関連付けられている Microsoft 資格情報を使用して、ポータルにサインインします。

  3. [Azure サービス] カテゴリで、[リソースの作成] を選択してから、[Azure Cosmos DB] を選択します。

    💡 または、[≡] メニューを展開し、[すべてのサービス] を選択し、[データベース] カテゴリで、[Azure Cosmos DB] を選んでから [作成] を選択します。

  4. [API オプションの選択] ペインで、[Azure Cosmos DB for NoSQL] セクションの [作成] オプションを選びます。

  5. [Azure Cosmos DB アカウントの作成] ペイン内で、[基本] タブを確認します。

  6. [基本] タブで、各設定に対して次の値を入力します。

    設定 Value
    サブスクリプション 既存の Azure サブスクリプションを使用します。 すべてのリソースはリソース グループに属している必要があります。すべてのリソース グループはサブスクリプションに属している必要があります。
    リソース グループ 既存のリソース グループを使うか、新しいリソース グループを作成します。 すべてのリソースは、リソース グループに属している必要があります。
    取引先企業名 グローバルに一意の名前を入力します。 グローバルに一意のアカウント名。この名前は、要求の DNS アドレスの一部として使用されます。ポータルでは、名前をリアルタイムで確認します。
    場所 使用可能なリージョンを選びます。 データベースが最初にホストされる地理的リージョンを選択します。
    容量モード プロビジョニング済みスループット
    Apply Free Tier Discount (Free レベル割引の適用) 適用しない

  7. [確認と作成] を選択して [確認と作成] タブに移動してから、 [作成] を選択します。

    📝 Azure Cosmos DB for NoSQL アカウントが使用できる状態になるまで、10 分から 15 分かかる場合があります。

  8. [デプロイ] ペインを確認します。 デプロイが完了すると、そのペインが更新され、 [デプロイに成功しました] というメッセージが表示されます。

  9. 引き続き [デプロイ] ペインで、[リソースに移動] を選択します。

データ エクスプローラーを使用して、新しいデータベースとコンテナーを作成する

Azure portal で Azure Cosmos DB for NoSQL データベースおよびコンテナーを管理する場合にはデータ エクスプローラーが主要なツールになります。 このラボで使用する基本的なデータベースとコンテナーを作成します。

  1. [Azure Cosmos DB アカウント] ペインで、リソース メニューから [データ エクスプローラー] を選択します。

  2. [データ エクスプローラー] ペインで、 [新しいコンテナー] を選択します。

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

    設定 Value
    データベース ID cosmicworks
    コンテナー間でスループットを共有する 未確認
    コンテナー ID products
    パーティション キー /categoryId
    コンテナーのスループット (自動スケーリング) [手動]
    RU/秒 400

  4. [データ エクスプローラー] ペインに戻り、cosmicworks データベース ノードを展開して、階層内の products コンテナー ノードを確認します。

データ エクスプローラーを使用して新しい項目を作成する

データ エクスプローラーには、Azure Cosmos DB for NoSQL コンテナー内で項目を照会、作成、管理するための一連の機能も含まれています。 データ エクスプローラーで未加工の JSON を使用して 2 つの基本的な項目を作成します。

  1. [データ エクスプローラー] ペインで、cosmicworksデータベース ノード、products コンテナー ノードの順に展開してから、[項目] を選択します。

  2. コマンドバーから [新しい項目] を選択し、エディターでプレースホルダーの JSON 項目を次の内容に置き換えます。

     {
   "categoryId": "4F34E180-384D-42FC-AC10-FEC30227577F",
   "categoryName": "Components, Pedals",
   "sku": "PD-R563",
   "name": "ML Road Pedal",
   "price": 62.09
 }

  3. コマンド バーから [保存] を選択して、最初の JSON 項目を追加します。

  4. [項目] タブに戻り、コマンド バーから [新しい項目] を選択します。 エディターで、プレースホルダーの JSON 項目を次の内容に置き換えます。

     {
   "categoryId": "75BF1ACB-168D-469C-9AA3-1FD26BB4EA4C",
   "categoryName": "Bikes, Touring Bikes",
   "sku": "BK-T18Y-44",
   "name": "Touring-3000 Yellow, 44",
   "price": 742.35
 }

  5. コマンド バーから [保存] を選択して、2 つ目の JSON 項目を追加します。

  6. [項目] タブの [項目] ペインで、2 つの新しい項目を確認します。

データ エクスプローラーを使用して基本クエリを発行する

最後に、データ エクスプローラーには組み込みのクエリ エディターが用意されています。これを使用して、クエリの発行、結果の確認、および 1 秒あたりの要求ユニット数 (RU/秒) 単位での影響の測定を行います。

  1. [データ エクスプローラー] ペインで [新しい SQL クエリ] を選択します。

  2. [クエリ] タブで、[クエリの実行] を選択して、フィルターなしですべての項目を選択する標準クエリを表示します。

  3. エディター領域のコンテンツを削除します。

  4. プレースホルダー クエリを次の内容に置き換えます。

     SELECT * FROM products p WHERE p.price > 500

    📝 このクエリを実行すると、価格が $500 を超えるすべての項目が選択されます。

  5. [クエリの実行] を選択します。

  6. クエリの結果を確認します。JSON 項目が 1 つと、そのすべてのプロパティが含まれている必要があります。

  7. [クエリ] タブで、[クエリ統計] を選択します。

  8. 引き続き、[クエリ] タブで、[クエリ統計] セクション内の [要求料金] フィールドの値を確認します。

    📝 通常、このシンプルなクエリの要求料金は、コンテナー サイズが小さい場合は 2 から 3 RU/s となります。

  9. Web ブラウザーのウィンドウまたはタブを閉じます。