PROJECT_OPTIONS_CHANGES 视图

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

所需权限

如需获取配置，您需要拥有项目级的 bigquery.config.update Identity and Access Management (IAM) 权限。预定义的 IAM 角色 roles/bigquery.admin 包含创建配置所需的权限。

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

架构

当您查询 INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES 视图时，项目中的每个配置更改都会有一行对应的查询结果。

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

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

数据保留

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

范围和语法

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

视图名称 资源范围 区域范围
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES 指定项目中的配置更改。 REGION

替换以下内容：

示例

以下示例从 INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES 视图中检索所有列。

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

结果类似于以下内容：

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| 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_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+