建立自訂查詢配額

本文說明如何設定或修改自訂查詢配額,以控管費用。如要瞭解 BigQuery 分析師如何估算及控管費用,請參閱「估算及控管費用」。

如果您有多個 BigQuery 專案和使用者,可以要求自訂配額,指定每天處理的資料量上限,藉此管理費用。系統會在太平洋時間凌晨 12 點重設每日配額。

自訂配額會主動控管,因此如果配額為 10 TB,就無法執行 11 TB 的查詢。您可以為處理的資料建立自訂配額,在專案或使用者層級控管費用。

如要設定自訂費用控管機制,您可以更新下列其中一項或兩項查詢配額:

  • QueryUsagePerDay:專案層級的自訂配額會限制該專案中所有使用者的匯總用量。

  • QueryUsagePerUserPerDay:使用者層級的自訂配額會分別套用至專案中的所有使用者和服務帳戶。無論每位使用者的用量限制為何,專案中所有使用者的總用量都不得超過每日查詢用量限制。

QueryUsagePerDay 配額的預設限制為每項專案每天處理 200 Tebibytes (TiB) 的資料。QueryUsagePerUserPerDay 的預設限制為無限制。如要查看目前的限制,請前往「Quotas」(配額) 頁面。您隨時可以變更限制,自訂覆寫設定會取代預設限制。

查詢用量配額僅適用於隨選查詢定價模式。

如要進一步瞭解可設定的 BigQuery 配額,請參閱「配額與限制」。

必要角色

如要取得變更配額所需的權限,請要求管理員授予您專案的配額管理員 (role/servicemanagement.quotaAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 serviceusage.quotas.update 權限,可變更配額。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

設定或修改自訂配額

在 Google Cloud 控制台的「Quotas & System Limits」(配額與系統限制) 頁面中,您可以為任何顯示的配額設定自訂配額,或修改現有的自訂配額。如果您要求降低配額,變更會在幾分鐘內生效。如果您要求提高配額,要求會經過核准程序,可能需要較多時間。詳情請參閱「要求調整配額」。

如要設定或更新自訂費用控管機制,例如限制每天可處理的 BigQuery 資料量,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面:

    前往「Quotas & System Limits」(配額與系統限制) 頁面

  2. 在「Filter」(篩選器) 搜尋框中使用「Service」(服務) 篩選器,篩選出 BigQuery API。

  3. 選取要調整的配額。舉例來說,如要限制專案層級和使用者層級每天可查詢的資料量,請選取「Query usage per day」(每天查詢用量) 和「Query usage per day per user」(每人每天查詢用量)。您可能需要翻頁瀏覽清單才能找到。選取配額後,畫面上會顯示工具列。

  4. 按一下工具列中的「編輯」圖示 。 「Quota changes」(配額變更) 對話方塊隨即開啟。

  5. 如果已選取「無限制」,請取消選取。

  6. 在「New value」(新值) 欄位,輸入所需的配額值 (以 TiB 為單位)。

  7. 按一下「完成」。

  8. 按一下 [提交要求]。

如要進一步瞭解如何查看及管理配額,請參閱「查看及管理配額」。

傳回的錯誤訊息

設定自訂配額後,如果超出配額,BigQuery 會傳回 quotaExceeded 錯誤。訊息會指出您超過的配額:QueryUsagePerDay 代表專案層級自訂配額,QueryUsagePerUserPerDay 代表使用者層級自訂配額:

  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerDay, which is set by your administrator.
  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerUserPerDay, which is set by your administrator.

如要診斷及解決這些錯誤,請參閱「排解自訂每日查詢配額錯誤」。

範例

假設您已為包含 10 名使用者的專案設定下列自訂配額,且其中一名使用者為服務帳戶:

  • 專案層級:每天 50 TB
  • 使用者層級:每天 10 TB

專案層級的自訂配額會限制同一專案中所有使用者的匯總用量。使用者層級的自訂配額會分別套用至單一專案中的每個使用者或服務帳戶。

下表說明 10 位使用者在單日內執行完所需查詢後的剩餘配額。

用量 剩餘配額
10 位使用者的查詢量各為 4 TB 專案層級:剩餘 10 TB。
使用者層級:每位使用者仍有 6 TB,但總計最多 10 TB。
服務帳戶使用了另外的 6 TB 查詢量 專案層級:剩餘 4 TB。
使用者層級:服務帳戶無法再使用 BigQuery。其他使用者各剩餘 6 TB,但總計最多只能再使用 4 TB。
1 名使用者使用了另外的 4 TB 查詢量 專案層級:剩餘 0 TB。
使用者層級:仍有數 TB 的配額,但由於已超過專案層級配額,因此任何人都無法使用 BigQuery。

由於已無剩餘配額,該項專案中的每位使用者都無法繼續使用 BigQuery。

後續步驟