PROJECT_OPTIONS_CHANGES 视图

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

注意：如需获得有关项目级配置更改的支持，或提供反馈，请联系 [e-mail]。

您可以查询 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

替换以下内容：

• REGION：任何数据集区域名称。 例如 US 或 us-west2。

注意：如需了解如何从 updated_options 列提取 JSON 标量值并将其转换为 SQL STRING 值（如 JSON_VALUE()），请参阅 JSON 函数。

示例

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

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

注意：INFORMATION_SCHEMA 视图名称区分大小写。

结果类似于以下内容：

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | [e-mail] | {"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 | [e-mail] | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+