RESERVATION_CHANGES 视图

INFORMATION_SCHEMA.RESERVATION_CHANGES 视图包含管理项目中对预留进行的所有更改的近乎实时列表。每一行代表对单个预留进行的一项更改。如需了解详情，请参阅预留简介。

所需权限

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

  • BigQuery Resource Admin (roles/bigquery.resourceAdmin)
  • BigQuery Resource Editor (roles/bigquery.resourceEditor)
  • BigQuery Resource Viewer (roles/bigquery.resourceViewer)
  • BigQuery User (roles/bigquery.user)
  • BigQuery Admin (roles/bigquery.admin)

如需详细了解 BigQuery 权限，请参阅 BigQuery IAM 角色和权限。

架构

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

列名 数据类型 值
change_timestamp TIMESTAMP 此项更改发生的时间。
project_id STRING 管理项目的 ID。
project_number INTEGER 管理项目的编号。
reservation_name STRING 用户提供的预留名称。
ignore_idle_slots BOOL 如果为 false，则使用此预留的任何查询都可以使用其他容量承诺中未被使用的空闲槽。
action STRING 预留发生的事件类型。可以是 CREATE、UPDATE 或 DELETE。
slot_capacity INTEGER 预留的基准。
user_email STRING 执行更改的用户的电子邮件地址或员工身份联合的主题。如果是 Google 执行的更改，则为 google。如果电子邮件地址未知，则为 NULL。
target_job_concurrency INTEGER 可以同时执行的查询的目标数量，受可用资源的限制。如果为零，则系统会根据可用资源自动计算此值。
autoscale STRUCT

有关预留的自动扩缩容量的信息。包括以下字段：

  • current_slots：通过自动扩缩添加到预留的槽数。
  • max_slots：可通过自动扩缩添加到预留的槽数上限。
edition STRING 与此预留关联的版本。如需详细了解版本，请参阅 BigQuery 版本简介。
primaryLocation STRING 预留的主副本的当前位置。此字段仅适用于使用灾难恢复托管功能的预留。
secondaryLocation STRING 预留的次要副本的当前位置。此字段仅适用于使用灾难恢复托管功能的预留。
originalPrimaryLocation STRING 最初创建预留的位置。
labels RECORD 与预留关联的标签数组。
max_slots INTEGER 此预留可以使用的槽数上限，包括基准槽 (slot_capacity)、空闲槽（如果 ignore_idle_slots 为 false）和自动扩缩槽。此字段由用户指定，用于使用预留可预测性功能。
scaling_mode STRING 预留的扩缩模式，用于确定预留如何从基准扩容到 max_slots。此字段由用户指定，用于使用预留可预测性功能。

数据保留

该视图包含当前预留和已删除的预留，已删除的预留最多保留 41 天，之后会从视图中移除。

范围和语法

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

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

示例

以下示例获取了指定预留的更改历史记录。可以使用此信息查看对特定预留进行的更改列表，例如创建或删除预留。

SELECT
  *
FROM
  reservation-admin-project.`region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;