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 を呼び出し、データベース内のデータを操作します。
ヒント: Azure Cosmos DB の調査が完了した場合は、この演習で作成したリソース グループを削除してください。