在 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 来创建容器。

注释

创建容器时，请确保不创建名称相同但大小写不同的两个容器。这是因为Azure平台的某些部分不区分大小写，这可能会导致具有此类名称的容器上的遥测数据和动作发生混淆或冲突。

注释

命名Azure Cosmos DB 容器时，请避免包括敏感信息，例如access密钥、机密、客户数据或内部标识符。应用基于Microsoft Entra ID的访问控制和最小权限设置，以确保实际安全，并使容器名称保持中性并避免信息泄露。

使用 Azure portal 创建容器

登录到 Azure portal。
创建新的 Azure Cosmos DB 帐户，或选择现有帐户。
打开 Data Explorer 窗格，然后选择 New Container。接下来，请提供以下详细信息：
- 指示是要创建新数据库还是使用现有数据库。
- 输入容器 ID。
- 输入分区键值（例如）。
- 选择“自动缩放”或“手动”模式，并输入所需的“容器吞吐量”（例如，每秒1000 RU）。输入要预配的吞吐量（例如，1000 RU）
- 选择“确定”。

使用 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);

后续步骤

Last updated on 2026-03-10

通过