你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure Cosmos DB 的数据库中预配标准（手动）吞吐量 - API for NoSQL

适用范围： NoSQL

本文说明了如何在 Azure Cosmos DB for NoSQL 的数据库中预配标准（手动）吞吐量。 可以为单个容器预配吞吐量，也可以为数据库预配吞吐量，并在数据库中的容器之间共享吞吐量。 若要了解何时使用容器级别和数据库级别吞吐量，请参阅容器和数据库预配吞吐量的用例一文。 可以使用 Azure 门户或 Azure Cosmos DB SDK 来预配数据库级别吞吐量。

如果使用的是其他 API，请参阅 API for MongoDB、API for Cassandra、API for Gremlin 这几篇文章来预配吞吐量。

使用 Azure 门户预配吞吐量

1. 登录 Azure 门户。

2. 新建 Azure Cosmos DB 帐户，或选择现有的 Azure Cosmos DB 帐户。

3. 打开“数据资源管理器”窗格，然后选择“新建数据库” 。 提供以下详细信息：

   • 输入数据库 ID。
   • 选择“跨容器共享吞吐量”选项。
   • 选择“自动缩放”或“手动缩放”吞吐量并输入所需的“数据库吞吐量”（例如，1000 RU/秒）。
   • 在“容器 ID”下输入容器的名称
   • 输入一个“分区键”
   • 选择“确定”。

   

使用 Azure CLI 或 PowerShell 预配吞吐量

若要创建具有共享吞吐量的数据库，请参阅

• 使用 Azure CLI 创建数据库
• 使用 PowerShell 创建数据库

使用 .NET SDK 预配吞吐量

注意

可以使用适用于 NoSQL API 的 Azure Cosmos DB SDK 为所有 API 预配吞吐量。 也可以选择将以下示例用于 Cassandra API。

.NET SDK V2

//set the throughput for the database
RequestOptions options = new RequestOptions
{
    OfferThroughput = 500
};

//create the database
await client.CreateDatabaseIfNotExistsAsync(
    new Database {Id = databaseName},  
    options);

.NET SDK V3

//create the database with throughput
string databaseName = "MyDatabaseName";
await this.cosmosClient.CreateDatabaseIfNotExistsAsync(
        id: databaseName,
        throughput: 1000);

后续步骤

请参阅以下文章，了解在 Azure Cosmos DB 中预配的吞吐量：

• 全局缩放预配的吞吐量
• 在容器和数据库上预配吞吐量
• 如何在容器上预配标准（手动）吞吐量
• 如何为容器预配自动缩放吞吐量
• Azure Cosmos DB 中的请求单位和吞吐量