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

資料欄名稱 資料類型 值
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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+