EFFECTIVE_PROJECT_OPTIONS 视图

您可以查询 INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 视图以检索有关 BigQuery 有效项目选项的实时元数据。此视图包含组织或项目级的默认设置。

所需权限

如需获取有效的项目选项元数据，您需要拥有 bigquery.config.get Identity and Access Management (IAM) 权限。

以下预定义的 IAM 角色包含获取有效的项目选项元数据所需的权限：

  • roles/bigquery.jobUser

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

架构

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

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

列名 数据类型 值
OPTION_NAME STRING 所指定配置设置的选项 ID。
OPTION_DESCRIPTION STRING 选项说明。
OPTION_TYPE STRING OPTION_VALUE 的数据类型。
OPTION_SET_LEVEL STRING 层次结构中用于定义设置的级别，可能的值为 DEFAULT、ORGANIZATION 或 PROJECTS
OPTION_SET_ON_ID STRING 根据 OPTION_SET_LEVEL 的值设置值：
  • 如果为 DEFAULT，则设置为 null。
  • 如果为 ORGANIZATION，则设置为 ""。
  • 如果为 PROJECT，则设置为 ID。
OPTION_VALUE STRING 选项的当前值。
选项表
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING 此项目的有效默认时区。
default_kms_key_name STRING 此项目的有效默认密钥名称。
default_query_job_timeout_ms INT64 此项目的有效默认查询超时（以毫秒为单位）。
default_interactive_query_queue_timeout_ms STRING 此项目已加入队列的交互式查询的有效默认超时（以毫秒为单位）。
default_batch_query_queue_timeout_ms STRING 此项目已加入队列的批量查询的有效默认超时（以毫秒为单位）。

数据保留

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

范围和语法

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

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

请替换以下内容：

示例

下面的示例从 INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 视图中检索 OPTION_NAME、OPTION_TYPE、OPTION_VALUE、OPTION_SET_LEVEL 和 OPTION_SET_ON_ID 列。

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

结果类似于以下内容：

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | option_name                                | option_type | option_value        | option_set_level | option_set_on_id   |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles | organizations    | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              | organization     | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+