「容量承諾異動」檢視畫面

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES檢視畫面會列出管理專案中容量使用承諾的所有變更，且近乎即時。每一列代表對單一容量承諾的單一變更。 詳情請參閱「預留配額承諾」。

必要權限

如要查詢 INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 檢視畫面，您必須具備專案的 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 權限，請參閱「使用身分與存取權管理功能控管存取權」一文。

結構定義

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

資料欄名稱	資料類型	值
change_timestamp	TIMESTAMP	變更發生的時間。
project_id	STRING	管理專案的 ID。
project_number	INTEGER	管理專案的編號。
capacity_commitment_id	STRING	可明確識別容量承諾的 ID。
commitment_plan	STRING	容量使用承諾的合約方案。
state	STRING	容量使用承諾的狀態。可以是 PENDING 或 ACTIVE。
slot_count	INTEGER	與容量使用承諾相關聯的運算單元數量。
action	STRING	容量承諾發生的事件類型。可以是 CREATE、UPDATE 或 DELETE。
user_email	STRING	進行變更的使用者電子郵件地址或員工身分聯盟主體。google，瞭解 Google 進行的變更。NULL：如果電子郵件地址不明。
commitment_start_time	TIMESTAMP	目前使用承諾期間的開始時間。僅適用於ACTIVE容量承諾，否則為NULL。
commitment_end_time	TIMESTAMP	目前使用承諾期間的結束時間。僅適用於ACTIVE容量承諾，否則為NULL。
failure_status	RECORD	如果是 FAILED 承諾方案，則提供失敗原因，否則為 NULL。RECORD 由 code 和 message 組成。
renewal_plan	STRING	容量使用承諾在 commitment_end_time 通過後轉換的方案。方案變更後，承諾期會根據承諾方案延長。僅適用於 ANNUAL 和 TRIAL 承諾，否則為 NULL。
edition	STRING	與這項預訂相關聯的版本。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
is_flat_rate	BOOL	這項承諾是否與舊版固定費率容量模式或版本相關聯。如果為 FALSE，則目前的約期與版本相關聯。如果為 TRUE，則承諾是舊版固定費率容量模式。

資料保留

這個檢視畫面會顯示目前的容量使用承諾，以及最多保留 41 天的已刪除容量使用承諾，之後這些承諾就會從檢視畫面中移除。

範圍和語法

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

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

取代下列項目：

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

範例

下列查詢會顯示在指定日期內，對目前專案進行最新容量承諾更新的使用者。

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

結果會類似如下：

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     [e-mail]     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+