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 |
请替换以下内容:
REGION
:任何数据集区域名称。 例如region-us
。
示例
下面的示例从 INFORMATION_SCHEMA.PROJECT_OPTIONS
视图中检索 OPTION_NAME
、OPTION_TYPE
和 OPTION_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 | +--------------------------------------------+-------------+---------------------+