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"] | +---------------------+--------------+----------------------+-------------------+