CAPACITY_COMMITMENT_CHANGES 视图

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 视图包含管理项目中容量承诺的所有变更的近乎实时列表。每一行代表对单个容量承诺进行的一项更改。如需了解详情，请参阅槽承诺。

所需权限

如需查询 INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 视图，您需要拥有项目的 bigquery.capacityCommitments.list Identity and Access Management (IAM) 权限。以下每个预定义的 IAM 角色均可提供所需的权限：

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

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

架构

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 视图具有如下架构：

列名 数据类型 值
change_timestamp TIMESTAMP 此项更改发生的时间。
project_id STRING 管理项目的 ID。
project_number INTEGER 管理项目的编号。
capacity_commitment_id STRING 唯一标识容量承诺的 ID。
commitment_plan STRING 容量承诺的承诺使用合约方案。
state STRING 容量承诺所处的状态。可以是 PENDING 或 ACTIVE。
slot_count INTEGER 与容量承诺关联的槽计数。
action STRING 容量承诺发生的事件类型。可以是 CREATE、UPDATE 或 DELETE。
user_email STRING 执行更改的用户的电子邮件地址或员工身份联合的主题。如果是 Google 执行的更改，则为 google。如果电子邮件地址未知，则为 NULL。
commitment_start_time TIMESTAMP 当前承诺期的开始时间。仅适用于 ACTIVE 容量承诺，否则为 NULL。
commitment_end_time TIMESTAMP 当前承诺期的结束时间。仅适用于 ACTIVE 容量承诺，否则为 NULL。
failure_status RECORD 对于 FAILED 承诺方案，请提供失败原因，否则为 NULL。RECORD 由 code 和 message 组成。
renewal_plan STRING 此容量承诺在 commitment_end_time 过后转换为的方案。更改方案后，系统会根据承诺方案延长承诺期。仅适用于 ANNUAL 和 TRIAL 承诺，否则为 NULL。
edition STRING 与此预留关联的版本。如需详细了解版本，请参阅 BigQuery 版本简介。
is_flat_rate BOOL 承诺是否与旧版固定费率容量模型或版本相关联。如果为 FALSE，则当前承诺与一个版本相关联。如果为 TRUE，则承诺为旧版统一费率容量模型。

数据保留

此视图包含当前的容量承诺以及已删除的容量承诺，已删除的承诺最多保留 41 天，之后将从视图中移除。

范围和语法

针对此视图的查询必须包含区域限定符。如果您未指定区域限定符，则会从所有区域检索元数据。下表说明了此视图的区域范围：

视图名称 资源范围 区域范围
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES[_BY_PROJECT] 项目级 REGION
请替换以下内容：
  • 可选：PROJECT_ID：您的 Google Cloud 项目的 ID。如果未指定，则使用默认项目。
  • REGION：任何数据集区域名称。 例如 `region-us`。

示例

以下查询显示了在指定日期内对当前项目执行最新容量承诺更新的用户。

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

结果类似于以下内容：

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+