Azure Cosmos DB for NoSQL にコンテナーを作成する

適用対象: NoSQL

この記事では、Azure Cosmos DB for NoSQL にコンテナーを作成するいくつかの方法について説明します。 Azure portal、Azure CLI、PowerShell、またはサポートされているソフトウェア開発キット (SDK) を使用してコンテナーを作成する方法を示します。 この記事では、コンテナーを作成してパーティション キーを指定し、スループットをプロビジョニングする方法を紹介します。

この記事では、Azure Cosmos DB for NoSQL にコンテナーを作成するいくつかの方法について説明します。 別の API を使用している場合は、 MongoDB 用 API、 Cassandra 用 API、 Gremlin 用 API、および テーブル用 API に関 する記事を参照してコンテナーを作成してください。

注

コンテナーを作成するときは、同じ名前で大文字と小文字が異なる 2 つのコンテナーを作成しないようにしてください。 これは、Azure プラットフォームの一部の部分では大文字と小文字が区別されず、このような名前のコンテナーに対するテレメトリとアクションが混同/衝突する可能性があるためです。

Azure portal を使用してコンテナーを作成する

1. Azure portal にサインインします。

2. 新しい Azure Cosmos DB アカウントを作成するか、既存のアカウントを選びます。

3. [データ エクスプローラー] ウィンドウを開いて [新しいコンテナー] を選択します。 次に、以下の詳細を指定します。

   • 新しいデータベースを作成するか、既存のデータベースを使用するかを指定します。
   • コンテナー ID を入力します。
   • パーティション キーの値を入力します (例: /ItemID)。
   • 自動スケーリングまたは手動スループットを選択し、必要なコンテナー スループットを入力します (例: 1,000 RU/秒)。 プロビジョニングするスループットを入力します (例: 1,000 RU)。
   • [OK] を選択します。

   

Azure CLI を使用してコンテナーを作成する

Azure CLI を使用してコンテナーを作成します。

PowerShell を使用してコンテナーを作成する

PowerShell を使用してコンテナーを作成します。

.NET SDK を使用してコンテナーを作成する

コレクションの作成時にタイムアウト例外が発生した場合は、コレクションが正常に作成されたかどうかを確認する読み取り操作を実行します。 この読み取り操作では、コレクションの作成操作が成功するまで例外がスローされます。 作成操作でサポートされている状態コードの一覧については、記事「Azure Cosmos DB の HTTP 状態コード」を参照してください。

TokenCredential credential = new DefaultAzureCredential();

CosmosClient client = new (
    accountEndpoint: "<nosql-account-endpoint>",
    tokenCredential: credential
);

// Create a container with a partition key and provision 400 RU/s manual throughput.
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

次のステップ

• Azure Cosmos DB でのパーティション分割
• Azure Cosmos DB の要求ユニット
• コンテナーとデータベースのスループットのプロビジョニング
• Azure Cosmos DB アカウントの使用