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： 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;