尋找在 Azure Cosmos DB for MongoDB 中執行作業的要求單位費用

適用於： MongoDB

Azure Cosmos DB 支援許多 API，例如 SQL、MongoDB、Cassandra、Gremlin 和資料表。 每個 API 都有它自己的一組資料庫作業。 這些作業的範圍可從簡單的點讀取和寫入到複雜查詢。 每個資料庫作業都會根據作業的複雜度來取用系統資源。

所有資料庫作業的成本會由 Azure Cosmos DB 進行正規化，並以要求單位 (簡稱 RU) 表示。 要求費用是所有資料庫作業耗用的要求單位。 您可以將 RU 視為效能貨幣，抽象表示執行 Azure Cosmos DB 支援的資料庫作業時所需的系統資源，例如 CPU、IOPS 和記憶體。 無論您使用哪種 API 與 Azure Cosmos DB 容器互動，成本始終由 RU 測量。 無論資料庫作業是寫入、點讀取還是查詢，成本一律以 RU 為單位進行測量。 若要深入了解，請參閱要求單位及其事項一文。

此文章介紹各種方法，讓您在對 Azure Cosmos DB for MongoDB 中的容器執行任何作業時，找出其要求單位 (RU) 耗用量。 如果您使用的是不同的 API，請參閱API for NoSQL、API for Cassandra、API for Gremlin 和 API for Table 等文章，以尋找 RU/秒費用。

RU 費用可用名為 getLastRequestStatistics 的自訂資料庫命令來公開。 此命令會傳回一份文件，其中包含最後執行的作業名稱，及其要求費用和持續時間。 如果您使用的是 Azure Cosmos DB for MongoDB，會有多個選項可供擷取 RU 費用。

使用 Azure 入口網站

1. 登入 Azure 入口網站。

2. 建立新的 Azure Cosmos DB 帳戶並為其提供資料，或選取已包含資料的現有帳戶。

3. 前往 [資料總管] 窗格，然後選取您要處理的容器。

4. 選取容器名稱旁邊的 [...]，然後選取 [新增查詢]。

5. 輸入有效的查詢，然後選取 [執行查詢]。

6. 選取下 [查詢統計資料]，以顯示您執行的要求實際的要求費用。 此查詢編輯器只可讓您執行和檢視查詢述詞的要求單位費用。 此編輯器不能用於資料操作命令，例如 insert 陳述式。

   

7. 若要取得資料操作命令的要求費用，請從以殼層為基礎的 UI 執行 getLastRequestStatistics 命令，例如 Mongo 殼層、Robo 3T、MongoDB Compass，或支援殼層指令碼的 VS Code 擴充功能。

   db.runCommand({getLastRequestStatistics: 1})

以程式設計方式

Mongo 殼層

當您使用 Mongo 殼層時，您可以使用 runCommand() 來執行命令。

db.runCommand('getLastRequestStatistics')

.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 for MongoDB 建置 .NET Web 應用程式。

JAVA 驅動程式

使用官方的 MongoDB Java 驅動程式時，可以對 MongoDatabase 物件呼叫 runCommand 方法來執行命令：

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

如需詳細資訊，請參閱快速入門：使用 Azure Cosmos DB for MongoDB 和 Java SDK 建置 Web 應用程式。

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。

Python 驅動程式

response = db.command('getLastRequestStatistics')
requestCharge = response['RequestCharge']

下一步

若要了解如何最佳化您的 RU 耗用量，請參閱下列文章：

• Azure Cosmos DB 中的要求單位和輸送量
• 在 Azure Cosmos DB 中最佳化已佈建的輸送量成本
• 在 Azure Cosmos DB 中最佳化查詢成本
• 正在嘗試為遷移至 Azure Cosmos DB 進行容量規劃嗎？ 您可以使用現有資料庫叢集的相關資訊進行容量規劃。
  • 如果您知道現有資料庫叢集中的虛擬核心和伺服器數目，請參閱使用虛擬核心或 vCPU 來估計要求單位
  • 如果您知道目前資料庫工作負載的一般要求率，請參閱使用 Azure Cosmos DB 容量規劃工具來估計要求單位