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

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

架构

当您查询 INFORMATION_SCHEMA.BI_CAPACITY_CHANGES 视图时,查询结果包含一行,用于 BI 引擎容量的每次更新,包括当前状态。

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 引擎容量所做的所有更改:

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

    以下示例获取过去 7 天的 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"] |
      +---------------------+--------------+----------------------+-------------------+