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 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
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 使用以預留項目為基礎的公平性機制，而非以專案為基礎的公平性機制。
reusable_column_aliases_mode STRING 這項專案是否啟用可重複使用的資料欄別名。

為確保穩定性，建議您在資訊結構定義查詢中明確列出資料欄，而非使用萬用字元 (SELECT *)。明確列出資料欄可避免查詢因基礎結構定義變更而中斷。

資料保留

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