RESERVATION_CHANGES 檢視畫面

INFORMATION_SCHEMA.RESERVATION_CHANGES 檢視畫面會列出管理專案中所有預留項目的變更，並近乎即時更新。每一列代表單一預訂的變更。詳情請參閱「預留項目簡介」。

必要權限

如要查詢 INFORMATION_SCHEMA.RESERVATION_CHANGES 檢視畫面，您需要 bigquery.reservations.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.RESERVATION_CHANGES 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
change_timestamp TIMESTAMP 變更發生的時間。
project_id STRING 管理專案的 ID。
project_number INTEGER 管理專案的編號。
reservation_name STRING 使用者提供的預留項目名稱。
ignore_idle_slots BOOL 如為 false，使用這個預留項目的任何查詢都可以使用其他容量承諾的閒置運算單元。
action STRING 預訂發生的事件類型。可以是 CREATE、UPDATE 或 DELETE。
slot_capacity INTEGER 預留項目的基準。
user_email STRING 進行變更的使用者電子郵件地址或員工身分聯盟主體。google，瞭解 Google 進行的變更。NULL：如果電子郵件地址不明。
target_job_concurrency INTEGER 可同時執行的查詢目標數量，這會受到可用資源的限制。如果為零，系統會根據可用資源自動計算這個值。
autoscale STRUCT

保留項目的自動調整容量相關資訊。欄位包括：

  • current_slots：自動調度資源功能為預訂新增的時段數量。
  • max_slots：自動調度資源可為預留項目新增的運算單元數量上限。
edition STRING 與這項預訂相關聯的版本。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
primaryLocation STRING 預訂項目主要副本的目前位置。這個欄位只會針對使用代管災難復原功能的預訂設定。
secondaryLocation STRING 預留項目次要副本的目前位置。這個欄位只會針對使用代管災難復原功能的預留項目設定。
originalPrimaryLocation STRING 最初建立預訂的位置。
labels RECORD 與預訂項目相關聯的標籤陣列。
max_slots INTEGER 這個預留項目可使用的運算單元數量上限，包括基準運算單元 (slot_capacity)、閒置運算單元 (如果 ignore_idle_slots 為 false) 和自動調度運算單元。使用者會指定這個欄位，以使用預訂預測功能。
scaling_mode STRING 預留項目的縮放模式，決定預留項目如何從基準縮放至 max_slots。使用者會指定這個欄位，以使用預訂預測功能。

資料保留

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

範圍和語法

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

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID].`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] 專案層級 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Trusted Cloud 專案 ID。如未指定，系統會使用預設專案。
  • REGION：任何資料集區域名稱。 例如：`region-us`。

範例

以下範例會取得特定預訂的變更記錄。您可以使用這項資訊查看特定預訂項目的變更清單，例如建立或刪除預訂項目。

SELECT
  *
FROM
  reservation-admin-project.`region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;