基本的な操作を確認する
Azure で Azure Cosmos DB for NoSQL アカウント リソースを作成するときはいつでも実行する必要がある基本的な操作がいくつかあります。
新しいアカウントの作成
Azure Cosmos DB の使用を開始するための最初の手順は、新しいアカウントを作成することです。
ポータルで新しいアカウントを作成する場合、最初に、ワークロードの API を選択する必要があります。 アカウントを作成した後に、選択した API を変更することはできません。 このセクションの残りの部分では、NoSQL API が選択されていることを前提とします。
次に、Azure portal で、さまざまな構成オプションのタブが表示されたステップ バイ ステップのウィザードを使用します。 ここでは、次のようなオプションを構成できます。
- アカウントのグローバルに一意な名前
- アカウントの場所 (Azure リージョン)
- 容量モード (プロビジョニングされたスループットまたはサーバーレス)
Note
Azure Cosmos DB アカウントを作成するために必要なのは、[基本] タブ内のオプションのみです。
新しいデータベースを作成する
データベースは、Azure Cosmos DB for NoSQL の論理ユニットであり、作成するのにそれほど多くのことは必要ありません。 新しいデータベースを作成するには、アカウント内で一意のデータベース名のみが必要です。
注意
ただし、データベース レベルでスループットをプロビジョニングすることを選択した場合、データベースの構成には追加の手順が必要になることがあります。 これについては、Azure Cosmos DB for NoSQL に関する他のトピックで詳しく説明しています。
新しいコンテナーの作成
コンテナーは、Azure Cosmos DB for NoSQL の主要なスケーラビリティ単位です。 コンテナーを作成する場合、次のものを指定する必要があります。
- 親データベース
- データベースで一意のコンテナーの名前
- パーティション キー値のパス
- "省略可能": データベースのプロビジョニングから推測されない場合は、プロビジョニングされたスループット。
Azure Cosmos DB サービスでは、個々のアイテムのパーティション キー値に基づいて、データを自動的かつ透過的にパーティション分割します。
単純な項目の作成
データベースおよびコンテナー リソースが作成されたら、最初の項目を作成する準備ができました。 Azure Cosmos DB for NoSQL で、項目とは JSON ドキュメントのことです。
注意
JavaScript Object Notation (JSON) は、オープン標準のファイル形式であり、データ交換形式でもあります。これは、人間が判読可能なテキストを使用して、属性と値のペアおよび配列データ型 (またはその他のシリアル化可能な値) で構成されるデータ オブジェクトを格納および送信します
JSON は、データ型が明確に定義された、言語に依存しないデータ形式であるため、さまざまなサービスやプログラミング言語でほぼ普遍的にサポートされています。 Azure Cosmos DB アカウントの項目になり得る JSON ドキュメントの例を次に示します。
{
"id": "0012D555-C7DE",
"type": "customer",
"fullName": "Franklin Ye",
"title": null,
"emailAddress": "fye@cosmic.works",
"creationDate": "2014-02-05",
"addresses": [
{
"addressLine": "1796 Westbury Drive",
"cityStateZip": "Melton, VIC 3337 AU"
},
{
"addressLine": "9505 Hargate Court",
"cityStateZip": "Bellflower, CA 90706 US"
}
],
"password": {
"hash": "GQF7qjEgMk=",
"salt": "12C0F5A5"
},
"salesOrderCount": 2
}