INFORMATION_SCHEMA.BI_CAPACITIES 檢視
INFORMATION_SCHEMA.BI_CAPACITIES
檢視畫面包含 BI Engine 容量目前狀態的中繼資料。如要查看 BI Engine 保留空間的變更記錄,請參閱 INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
檢視畫面。
必要權限
如要查詢 INFORMATION_SCHEMA.BI_CAPACITIES
檢視畫面,您必須具備 BI Engine 預留資料的 bigquery.bireservations.get
身分與存取權管理 (IAM) 權限。
如要進一步瞭解 BigQuery 權限,請參閱「使用身分與存取權管理功能控管存取權」。
結構定義
查詢 INFORMATION_SCHEMA.BI_CAPACITIES
檢視表時,查詢結果會包含一個資料列,其中包含 BI Engine 容量的目前狀態。
INFORMATION_SCHEMA.BI_CAPACITIES
檢視表具有下列結構定義:
資料欄名稱 | 資料類型 | 值 |
---|---|---|
project_id |
STRING |
包含 BI Engine 容量的專案 ID。 |
project_number |
INTEGER |
含有 BI Engine 容量的專案專案編號。 |
bi_capacity_name |
STRING |
物件的名稱。目前每個專案只能有一個容量,因此名稱一律設為 default 。 |
size |
INTEGER |
BI Engine RAM 大小 (以位元組為單位) |
preferred_tables |
REPEATED STRING |
這個 BI Engine 容量必須用於的偏好資料表集合。如果設為 null ,則會使用 BI Engine 容量處理目前專案中的所有查詢 |
範圍和語法
對這個檢視表執行的查詢必須包含區域限定詞。專案 ID 為選填欄位。如果未指定專案 ID,系統會使用查詢執行的專案。
檢視表名稱 | 資源範圍 | 區域範圍 |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES |
專案層級 | REGION |
-
選用:
PROJECT_ID
: Google Cloud 專案的 ID。如果未指定,系統會使用預設專案。 -
REGION
:任何資料集區域名稱。例如:`region-us`
。
示例
-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;
範例
以下範例會從 INFORMATION_SCHEMA.BI_CAPACITIES
檢視畫面擷取目前的 BI Engine 容量變更。
如要對查詢執行所在專案以外的專案執行查詢,請使用下列格式將專案 ID 新增至區域:`project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES
。
以下範例顯示 ID 為「my-project-id」專案中 BI Engine 的目前狀態:
SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES
傳回的結果看起來類似下列內容:
+---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+ | project_id | project_number | bi_capacity_name | size | preferred_tables | +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+ | my-project-id | 123456789000 | default | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] | +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
以下範例會針對查詢專案,以 GB 為單位傳回 BI Engine 容量的大小:
SELECT
project_id,
size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES
傳回的結果看起來類似下列內容:
+---------------+---------+ | project_id | size_gb | +---------------+---------+ | my-project-id | 250.0 | +---------------+---------+