RESERVATION_CHANGES 檢視畫面

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

必要權限

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

  • BigQuery 資源管理員 (roles/bigquery.resourceAdmin)
  • BigQuery 資源編輯者 (roles/bigquery.resourceEditor)
  • BigQuery 資源檢視者 (roles/bigquery.resourceViewer)
  • BigQuery 使用者 (roles/bigquery.user)
  • BigQuery 管理員 (roles/bigquery.admin)

如要進一步瞭解 BigQuery 權限，請參閱 BigQuery IAM 角色和權限。

結構定義

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 版本簡介」。
primary_location STRING 預訂項目主要副本的目前位置。這個欄位僅適用於使用代管災難復原功能的預訂。
secondary_location STRING 預留項目次要副本的目前位置。這個欄位只會為使用代管災難復原功能的預訂設定。
original_primary_location STRING 最初建立預訂的位置。
labels RECORD 與預訂項目相關聯的標籤陣列。
reservation_group_path STRING 預訂連結的階層式群組結構。 舉例來說，如果群組結構包含上層群組和子項群組，則 reservation_group_path 欄位會包含類似 [parent group, child group] 的清單。這個欄位目前為預先發布版。
max_slots INTEGER 這個預留項目可使用的運算單元數量上限，包括基準運算單元 (slot_capacity)、閒置運算單元 (如果 ignore_idle_slots 為 false) 和自動調度運算單元。使用者會指定這個欄位，以使用預訂預測功能。
scaling_mode STRING 預留項目的縮放模式，決定預留項目如何從基準縮放至 max_slots。使用者會指定這個欄位，以使用預訂預測功能。

為確保穩定性，建議您在資訊結構定義查詢中明確列出資料欄，而非使用萬用字元 (SELECT *)。明確列出資料欄可避免基礎結構定義變更時，查詢中斷。

資料保留

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

範圍和語法

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

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID].`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] 專案層級 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Google 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;