INFORMATION_SCHEMA.BI_CAPACITY_CHANGES 檢視畫面

INFORMATION_SCHEMA.BI_CAPACITY_CHANGES檢視畫面會顯示 BI Engine 容量的變更記錄。如要查看 BI Engine 預留項目的目前狀態，請參閱INFORMATION_SCHEMA.BI_CAPACITIES 檢視畫面。

必要權限

如要查詢 INFORMATION_SCHEMA.BI_CAPACITY_CHANGES 檢視畫面，您需要具備 BI Engine 預留空間的 bigquery.bireservations.get Identity and Access Management (IAM) 權限。

如要進一步瞭解 BigQuery 權限，請參閱「使用 IAM 控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.BI_CAPACITY_CHANGES 檢視表時，查詢結果會針對 BI Engine 容量的每次更新 (包括目前狀態)，各列出一個相對應的資料列。

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

資料欄名稱 資料類型 值
change_timestamp TIMESTAMP 上次更新 BI Engine 容量的時間戳記。
project_id STRING 包含 BI Engine 容量的專案 ID。
project_number INTEGER 包含 BI Engine 容量的專案編號。
bi_capacity_name STRING 物件的名稱。每個專案只能有一個容量，因此名稱一律為 default。
size INTEGER BI Engine RAM (以位元組為單位)。
user_email STRING 進行變更的使用者電子郵件地址或員工身分聯盟主體。google，瞭解 Google 進行的變更。NULL：如果電子郵件地址不明。
preferred_tables REPEATED STRING 這組偏好資料表必須使用此 BI Engine 容量。如果設為 null，目前專案中的所有查詢都會使用 BI Engine 容量。

語法

對這個檢視表執行的查詢必須包含區域限定詞。專案 ID 為選填欄位。如果未指定專案 ID，系統會使用查詢執行的專案。

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

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

範例

以下範例會從 INFORMATION_SCHEMA.BI_CAPACITY_CHANGES 檢視表擷取目前的 BI Engine 容量變化。

如要對查詢執行所在的專案以外的專案執行查詢，請使用下列格式將專案 ID 新增至區域：`project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES。

以下範例會取得電子郵件地址為 email@mycompanymail.com 的使用者對 BI Engine 容量所做的所有變更：

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

傳回的結果看起來類似下列內容：

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

以下範例會取得過去七天的 BI Engine 容量變化：

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

傳回的結果看起來類似下列內容：

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+