限制 Azure Cosmos DB 帳戶上佈建的總輸送量

適用於：NoSQL MongoDB Cassandra Gremlin 桌子

當您在佈建的輸送量模式中使用 Azure Cosmos DB 帳戶時，大部分的成本通常來自您跨帳戶所佈建的輸送量。 尤其，這些成本會直接受到下列因素影響：

• 具有共用輸送量的資料庫數目。
• 具有專用輸送量的資料庫數目。
• 其中每個資源上佈建的輸送量。
• 可在其中使用您帳戶的區域數目。

追蹤您已跨帳戶佈建的總輸送量，尤其是當您開始使用 Azure Cosmos DB 時，可能很有挑戰性。 這可能會產生非預期的費用，因為此金額最終會超過您不應該超過的特定預算。 為了協助您更好地控制成本，Azure Cosmos DB 可讓您限制帳戶上佈建的總輸送量。

注意

無伺服器帳戶無法使用此功能。

在您對帳戶的總輸送量設定限制之後，系統會封鎖下列任何導致超過此限制的作業，而且這作業將明確地失敗：

• 建立一個具有共用輸送量的新資料庫。
• 建立一個具有專用輸送量的新資料庫。
• 在標準 (手動) 模式中設定的資源上增加佈建的輸送量。
• 在自動調整模式中設定的資源上增加佈建的輸送量上限。
• 新增區域至您的帳戶。

注意

針對在自動調整模式中設定的資源，這是在資源上設定的輸送量上限，其會計入您帳戶的總輸送量。

重要

一旦在您的帳戶上啟用了總輸送量限制，您就必須在建立新的容器時傳遞明確的輸送量值。 如果嘗試建立沒有明確輸送量的容器，您目前會收到錯誤。

從 Azure 入口網站設定總輸送量限制

新增帳戶

從入口網站建立新的 Azure Cosmos DB 帳戶時，您可以選擇限制帳戶的總輸送量：

核取此選項後，若是免費層帳戶，會將您帳戶的輸送量總計限制為 1,000 RU/秒，若是一般、非免費層帳戶，則限制為 4,000 RU/秒。 您可以在建立帳戶之後變更此值。

現有帳戶

在 Azure 入口網站中，瀏覽至您的 Azure Cosmos DB 帳戶，然後從左側功能表中選取 [成本管理]。

本節會顯示在您帳戶上佈建的總輸送量摘要，並可讓您設定總輸送量限制。 有下列三個選項可用：

• 將帳戶的總佈建輸送量限制為免費層折扣中包含的數量。 此選項僅能在免費層帳戶上使用，而且會將您帳戶的總輸送量限制為 1000 RU/秒。 核取此選項時，您可以確保不會對佈建的輸送量產生任何費用。
• 允許將帳戶的總輸送量佈建為自訂數量。 此選項可讓您輸入不想要超過的總佈建輸送量。 對應到您輸入的每月預估成本會顯示為參考。

  注意

  此自訂限制不能低於目前跨帳戶佈建的總輸送量。

• 沒有限制，允許將帳戶的總輸送量佈建為自訂數量。 此選項會停用限制。

以程式設計方式設定總輸送量限制

使用 Azure Resource Manager 範本

使用 Azure Resource Manager 建立或更新 Azure Cosmos DB 帳戶時，您可以設定 properties.capacity.totalThroughputLimit 屬性來設定總輸送量限制：

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

將此屬性設定為 -1，以停用限制。

常見問題集

在某些情況下，佈建的總輸送量可能超過限制嗎？

Azure Cosmos DB 針對儲存的每 GB 資料強制執行最小輸送量 1 RU/秒。 如果您要內嵌資料，但已達該下限，則資源上佈建的輸送量將會自動增加，以接受每 GB 1 RU/秒。 在此情況下 (並只限此情況)，您的總佈建輸送量可能會超過您設定的限制。

下一步

• 開始在 Azure Cosmos DB 上規劃和管理您的成本。
• 深入了解佈建的輸送量。
• 了解如何最佳化佈建的輸送量成本。