ORGANIZATION_OPTIONS_CHANGES 视图

您可以查询 INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 视图以检索有关组织中的 BigQuery 配置更改的实时元数据。此视图反映了 2024 年 1 月 31 日之后进行的组织级和项目级配置更改。

所需权限

如需获得获取配置更改所需的权限，请让您的管理员为您授予组织的 BigQuery Admin (roles/bigquery.admin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含获取配置更改所需的 bigquery.config.update 权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

架构

查询 INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 视图时，组织中的每项配置更改都会有一行对应的查询结果。

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

列名 数据类型 值
update_time TIMESTAMP 配置更改发生的时间。
username STRING 对于第一方用户，这是其用户电子邮件地址。对于第三方用户，这是用户在第三方身份提供方中设置的名称。
updated_options JSON 用户在更改中更新的配置选项的 JSON 对象，包含更新字段的先前值和新值。
project_id STRING 项目 ID。 对于组织级配置更改，此字段为空。
project_number INTEGER 项目编号。对于组织级配置更改，此字段为空。

数据保留

此视图包含正在运行的会话以及过去 180 天内完成的会话的历史记录。

范围和语法

针对此视图的查询必须具有区域限定符。

视图名称 资源范围 区域范围
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 指定组织内的配置更改。 REGION

替换以下内容：

示例

以下示例会检索 default_query_job_timeout_ms option 选项的所有更改：

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

结果类似于以下内容：

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+