針對 Azure Cosmos DB Gremlin API 中執行的作業尋找要求單位費用

適用於: Gremlin API

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 Gremlin API 中的容器執行的任何作業,找到要求單位 (RU) 耗用量。 如果您使用不同的 api,請參閱適用于 MongoDB 的 APICassandra APISQL api資料表 API文章,以找出 RU/s 的費用。

Gremlin API 所傳回的標頭會對應至目前透過 Gremlin.NET 和 Java SDK 來呈現的自訂狀態屬性。 要求費用會提供在 x-ms-request-charge 索引鍵下方。 如果您使用的是 Gremlin API 時,會有多個選項可用來找出對 Azure Cosmos 容器的作業所產生的 RU 耗用量。

使用 Azure 入口網站

  1. 登入 Azure 入口網站

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

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

  4. 輸入有效的查詢,然後選取 [ 執行 Gremlin 查詢]。

  5. 選取下 [查詢統計資料],以顯示您執行的要求實際的要求費用。

在 Azure 入口網站中取得 Gremlin 查詢要求費用的螢幕擷取畫面

使用 .NET SDK 驅動程式

使用 Gremlin.NET SDK 時,狀態屬性會提供在 ResultSet<> 物件的 StatusAttributes 屬性下方:

ResultSet<dynamic> results = client.SubmitAsync<dynamic>("g.V().count()").Result;
double requestCharge = (double)results.StatusAttributes["x-ms-request-charge"];

如需詳細資訊,請參閱快速入門:使用 Azure Cosmos DB Gremlin API 帳戶建立 .NET Framework 或 Core 應用程式

使用 JAVA SDK 驅動程式

使用 Gremlin Java SDK 時,可以對於 ResultSet 物件呼叫 statusAttributes() 方法來擷取狀態屬性:

ResultSet results = client.submit("g.V().count()");
Double requestCharge = (Double)results.statusAttributes().get().get("x-ms-request-charge");

如需詳細資訊,請參閱快速入門:使用 JAVA SDK 在 Azure Cosmos DB 中建立圖形資料庫

後續步驟

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