Azure Cosmos DB を調べる

この演習では、自分の Azure サブスクリプションで Azure Cosmos DB データベースをプロビジョニングし、それを使用して非リレーショナルデータを格納するさまざまな方法を検討します。

このラボは完了するまで、約 15 分かかります。

開始する前に

管理レベルのアクセス権を持つ Azure サブスクリプションが必要です。

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

Cosmos DB を使うには、Azure サブスクリプションで Cosmos DB アカウントをプロビジョニングする必要があります。この演習では、Azure Cosmos DB for NoSQL を使う Cosmos DB のアカウントをプロビジョニングします。

Azure portal で、左上隅の [+ リソースの作成] を選び、Azure Cosmos DB を検索します。結果で [Azure Cosmos DB] を選択し、 [作成] を選択します。
Azure Cosmos DB for NoSQL のタイルで、 [作成] を選びます。
次の詳細を入力して、[確認および作成] を選択します。
- サブスクリプション: サンドボックスを使用している場合は、[コンシェルジェサブスクリプション] を選択します。** それ以外の場合は、ご自分の Azure サブスクリプションを選択します。
- リソースグループ: サンドボックスを使用している場合は、既存のリソースグループを選択します (この名前は、learn-xxxx… のようになります)。それ以外の場合は、任意の名前で新しいリソースグループを作成します。
- アカウント名: 一意の名前を入力します。
- 場所: 任意の推奨される場所を選びます
- 容量モード: プロビジョニングされたスループット
- Apply Free-Tier Discount (Free レベル割引を適用する): 使用できる場合は [適用] を選びます。
- 合計アカウントスループットを制限する: オフ
構成を確認したら、[作成] を選びます。
デプロイが完了するまで待ちます。次に、デプロイされたリソースに移動します。

サンプルデータベースの作成

“この手順全体を通して、ポータルに表示されるヒントをすべて閉じます”。**

新しい Cosmos DB アカウントのページの左側のペインで [Data Explorer] を選びます。
[Data Explorer] ページで、[クイックスタートの起動] を選びます。
[新しいコンテナー] タブで、サンプルデータベースの事前に設定された値を確認して、[OK] を選びます。
SampleDB データベースとその SampleContainer コンテナーが作成されるまで、画面の下部にあるパネルで状態を観察します (1 分ほどかかる場合があります)。

項目の表示と作成

[Data Explorer] ページで SampleDB データベースと SampleContainer コンテナーを展開し、[項目] を選んでコンテナー内の項目の一覧を表示します。項目は製品データを表し、それぞれに一意の ID と他のプロパティがあります。
一覧内の項目を選ぶと、項目データの JSON 表現が表示されます。
ページの上部にある [新しい項目] を選び、新しい空白の項目を作成します。

新しい項目の JSON を以下のように変更し、[保存] を選びます。

 {
     "name": "Road Helmet,45",
     "id": "123456789",
     "categoryID": "123456789",
     "SKU": "AB-1234-56",
     "description": "The product called \"Road Helmet,45\" ",
     "price": 48.74
 }

新しい項目を保存すると、追加のメタデータプロパティが自動的に追加されることに注意してください。

データベースのクエリを実行する

[Data Explorer] ページで、[新しい SQL クエリ] アイコンを選びます。
SQL クエリエディターで既定のクエリ (SELECT * FROM c) を確認し、SELECT * FROM c ボタンを使って実行します。
すべての項目の完全な JSON 表現を含む結果を確認します。

次のように、クエリを変更します。

 SELECT *
 FROM c
 WHERE CONTAINS(c.name,"Helmet")

[クエリの実行] ボタンを使って、修正したクエリを実行し、結果を確認します。これには、name フィールドに “Helmet” というテキストが含まれる項目の JSON エンティティが含まれます。
SQL クエリエディターを閉じ、変更内容を破棄します。

ここでは、Azure portal の Data Explorer インターフェイスを使って、Cosmos DB データベースで JSON エンティティを作成し、クエリを実行する方法について確認しました。実際のシナリオでは、アプリケーション開発者は、数多くあるプログラミング言語固有のソフトウェア開発キット (SDK) のいずれかを使って NoSQL API を呼び出し、データベース内のデータを操作します。