EFFECTIVE_PROJECT_OPTIONS 檢視畫面

您可以查詢 INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 檢視區塊，擷取 BigQuery 有效專案選項的即時中繼資料。這個檢視畫面包含在機構或專案層級設定的設定選項。如果機構和專案層級都設定了相同的設定選項，系統會顯示專案設定值。如要查看設定選項的預設值，請參閱設定設定。

所需權限

如要取得有效的專案選項中繼資料，您需要 bigquery.config.get身分與存取權管理 (IAM) 權限。

下列預先定義的 IAM 角色包含取得有效專案選項中繼資料所需的權限：

  • roles/bigquery.jobUser

如要進一步瞭解精細的 BigQuery 權限，請參閱角色和權限。

結構定義

查詢 INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 檢視表時，專案中的每個設定都會有一列相對應的查詢結果。

INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
project_id STRING 專案 ID。
project_number INTEGER 專案編號。
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 這項專案中，排入佇列的批次查詢有效預設逾時時間 (毫秒)。
enable_reservation_based_fairness BOOL 使用以預留項目為準的公平性，而非以專案為準的公平性。

資料保留

這個檢視畫面會顯示目前執行的工作階段，以及過去 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+