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 身分與存取權管理 (IAM) 權限。

如要進一步瞭解 BigQuery 權限,請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 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: Google Cloud 專案的 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"] |
  +---------------------+--------------+----------------------+-------------------+