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