PROJECT_OPTIONS 视图

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

所需权限

如需获取配置选项元数据,您需要以下 Identity and Access Management (IAM) 权限:

  • bigquery.config.get

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

  • roles/bigquery.jobUser

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

架构

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

INFORMATION_SCHEMA.PROJECT_OPTIONS 视图具有如下架构:

列名 数据类型
OPTION_NAME STRING 所指定配置设置的选项 ID。
OPTION_DESCRIPTION STRING 选项说明。
OPTION_TYPE STRING OPTION_VALUE 的数据类型。
OPTION_VALUE STRING 选项的当前值。
选项表
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING 此项目的默认时区。
default_kms_key_name STRING 此项目的默认密钥名称。
default_query_job_timeout_ms STRING 此项目的默认查询超时(以毫秒为单位)。
default_interactive_query_queue_timeout_ms STRING 此项目已加入队列的交互式查询的默认超时(以毫秒为单位)。
default_batch_query_queue_timeout_ms STRING 此项目已加入队列的批量查询的默认超时(以毫秒为单位)。

数据保留

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

范围和语法

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

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

请替换以下内容:

示例

下面的示例从 INFORMATION_SCHEMA.PROJECT_OPTIONS 视图中检索 OPTION_NAMEOPTION_TYPEOPTION_VALUE 列。

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

结果类似于以下内容:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+