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。

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

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

以下示例获取具有电子邮件 [e-mail] 的用户对 BI 引擎容量所做的所有更改：

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "[e-mail]"

结果类似于以下内容：

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  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 | [e-mail] | ["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 | [e-mail] | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | [e-mail] | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  

以下示例获取过去 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 | [e-mail] | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | [e-mail] | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+