CAPACITY_COMMITMENTS 檢視畫面

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 檢視畫面會列出管理專案中所有目前的容量使用承諾，且近乎即時更新。每一列代表一項目前的容量使用承諾。目前有待處理或有效的容量承諾，且尚未刪除。如要進一步瞭解預留項目，請參閱「預留配額」。

必要權限

如要查詢 INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 檢視畫面，您必須具備專案的 bigquery.capacityCommitments.list Identity and Access Management (IAM) 權限。下列預先定義的 IAM 角色都包含必要權限：

• roles/bigquery.resourceAdmin
• roles/bigquery.resourceEditor
• roles/bigquery.resourceViewer
• roles/bigquery.user
• roles/bigquery.admin

如要進一步瞭解 BigQuery 權限，請參閱使用 IAM 控管存取權

結構定義

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 檢視表具有下列結構定義：

資料欄名稱	資料類型	值
ddl	STRING	用來建立這項容量承諾的 DDL 陳述式。
project_id	STRING	管理專案的 ID。
project_number	INTEGER	管理專案的編號。
capacity_commitment_id	STRING	可明確識別容量承諾的 ID。
commitment_plan	STRING	容量使用承諾的合約方案。
state	STRING	容量使用承諾的狀態。可以是 PENDING 或 ACTIVE。
slot_count	INTEGER	與容量使用承諾相關聯的運算單元數量。
edition	STRING	與這項預訂相關聯的版本。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
is_flat_rate	BOOL	這項承諾是否與舊版固定費率容量模式或版本相關聯。如果為 FALSE，則目前的約期與版本相關聯。如果為 TRUE，則承諾是舊版固定費率容量模式。
renewal_plan	STRING	目前承諾使用方案結束後的新承諾使用方案。您可以在合約到期前隨時變更續約方案。

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。如未指定區域限定符，系統會從所有區域擷取中繼資料。下表說明這個檢視畫面的區域範圍：

檢視表名稱	資源範圍	區域範圍
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT]	專案層級	REGION

取代下列項目：

• 選用：PROJECT_ID：您的 Google Cloud 專案 ID。如未指定，系統會使用預設專案。
• REGION：任何資料集區域名稱。 例如：`region-us`。
  注意：您必須使用區域限定詞查詢 INFORMATION_SCHEMA 檢視畫面。查詢執行位置必須與 INFORMATION_SCHEMA 檢視區塊的區域相符。

範例

以下範例會傳回目前專案的有效容量承諾清單：

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

結果會類似如下：

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+