CAPACITY_COMMITMENT_CHANGES 檢視畫面

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 檢視畫面會列出管理專案中容量使用承諾的所有變更，幾乎是即時更新的清單。每列代表對單一容量承諾的單一變更。如要進一步瞭解預留功能，請參閱「承諾使用合約」。

必要權限

如要查詢 INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 檢視畫面，您必須具備專案的 bigquery.capacityCommitments.list 身分與存取權管理 (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`。

範例

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

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    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+