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`。

    • 示例

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