查找 Azure Cosmos DB API for MongoDB 中执行的操作的请求单位费用

适用于: Azure Cosmos DB API for MongoDB

Azure Cosmos DB 支持多种 API,例如 SQL、MongoDB、Cassandra、Gremlin 和表。 每个 API 具有自身的数据库操作集。 这些操作包括简单的点读取和写入,以及复杂的查询等等。 每个数据库操作根据其复杂性消耗系统资源。

所有数据库操作的成本将由 Azure Cosmos DB 规范化,并以“请求单位”(简称 RU)表示。 请求费用是所有数据库操作使用的请求单位。 你可以将 RU 视为性能货币,它抽象化了执行 Azure Cosmos DB 支持的数据库操作所需的系统资源,例如 CPU、IOPS 和内存。 不管使用哪个 API 来与 Azure Cosmos 容器和数据库操作交互,都始终以 RU 来计量成本。 无论数据库操作是写入、点读取还是查询,都始终以 RU 来计量成本。 若要了解详细信息,请参阅请求单位和注意事项一文。

本文介绍如何通过不同的方式,来查找针对 Azure Cosmos DB API for MongoDB 中的容器执行的任何操作所消耗的请求单位 (RU)。 如果你使用的是其他 API,请参阅 SQL APICassandra APIGremlin API表 API 文章,找到每秒的 RU 费用。

RU 费用由名为 getLastRequestStatistics 的自定义数据库命令公开。 该命令返回一个文档,其中包含上次执行的操作的名称、其请求费用和持续时间。 如果使用 Azure Cosmos DB API for MongoDB,则可以通过多个选项来检索 RU 费用。

使用 Azure 门户

  1. 登录到 Azure 门户

  2. 创建新的 Azure Cosmos 帐户并在其中植入数据,或选择一个已包含数据的现有帐户。

  3. 转到“数据资源管理器”窗格,然后选择要处理的容器。

  4. 选择容器名称旁边的“...”,然后选择“新建查询” 。

  5. 输入有效的查询,然后选择“执行查询”。

  6. 选择“查询统计信息”,以显示执行的请求的实际请求费用。 此查询编辑器允许你仅针对查询谓词运行和查看请求单位费用。 不能将此编辑器用于数据操作命令(例如 insert 语句)。

    Azure 门户中的 MongoDB 查询请求费用屏幕截图

  7. 若要获取数据操作命令的请求费用,请在基于 shell 的 UI(如 Mongo shell、Robo 3TMongoDB Compass 或包含 shell 脚本的 VS Code 扩展)中运行 getLastRequestStatistics 命令。

    db.runCommand({getLastRequestStatistics: 1})

使用 MongoDB .NET 驱动程序

使用官方 MongoDB .NET 驱动程序时,可以通过对 IMongoDatabase 对象调用 RunCommand 方法来执行命令。 此方法需要 Command<> 抽象类的实现:

class GetLastRequestStatisticsCommand : Command<Dictionary<string, object>>
{
    public override RenderedCommand<Dictionary<string, object>> Render(IBsonSerializerRegistry serializerRegistry)
    {
        return new RenderedCommand<Dictionary<string, object>>(new BsonDocument("getLastRequestStatistics", 1), serializerRegistry.GetSerializer<Dictionary<string, object>>());
    }
}

Dictionary<string, object> stats = database.RunCommand(new GetLastRequestStatisticsCommand());
double requestCharge = (double)stats["RequestCharge"];

有关详细信息,请参阅快速入门:使用 Azure Cosmos DB API for MongoDB 生成 .NET Web 应用

使用 MongoDB Java 驱动程序

使用官方 MongoDB Java 驱动程序时,可以通过对 MongoDatabase 对象调用 runCommand 方法来执行命令:

Document stats = database.runCommand(new Document("getLastRequestStatistics", 1));
Double requestCharge = stats.getDouble("RequestCharge");

有关详细信息,请参阅快速入门:使用 Azure Cosmos DB API for MongoDB 和 Java SDK 生成 Web 应用

使用 MongoDB Node.js 驱动程序

使用官方 MongoDB Node.js 驱动程序时,可以通过对 db 对象调用 command 方法来执行命令:

db.command({ getLastRequestStatistics: 1 }, function(err, result) {
    assert.equal(err, null);
    const requestCharge = result['RequestCharge'];
});

有关详细信息,请参阅快速入门:将现有的 MongoDB Node.js Web 应用迁移到 Azure Cosmos DB

后续步骤

若要了解如何优化 RU 消耗量,请参阅以下文章: