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。
project_id STRING 專案 ID。
project_number INTEGER 專案編號。
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 這個專案中,排入佇列的批次查詢預設逾時時間 (毫秒)。
preflight_fluid_autoscaling_reservations STRING 已選擇加入流暢擴充功能的預留項目清單,以秒計費,沒有最短時間限制。
reusable_column_aliases_mode STRING 這項專案是否啟用可重複使用的資料欄別名。

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

資料保留

這個檢視畫面會顯示目前執行的工作階段,以及過去 180 天內完成的工作階段記錄。

範圍和語法

針對這個檢視區塊的查詢必須包含區域限定詞。

檢視表名稱 資源範圍 區域範圍
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS 指定專案中的設定選項。 REGION

替換下列內容:

範例

以下範例會從 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             |
  +--------------------------------------------+-------------+---------------------+