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 Identity and Access Management (IAM) 权限。

如需详细了解 BigQuery 权限，请参阅使用 IAM 进行访问权限控制。

架构

查询 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。

注意：您必须指定位置以查询 INFORMATION_SCHEMA 视图，并且查询执行的位置必须与 INFORMATION_SCHEMA 视图的区域相匹配。

示例

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

以下示例返回查询项目的 BI Engine 容量大小（以 GB 为单位）：

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