PROJECT_OPTIONS 檢視畫面

您可以查詢 INFORMATION_SCHEMA.PROJECT_OPTIONS 檢視畫面,擷取 BigQuery 專案選項的即時中繼資料。這個檢視畫面包含專案中與預設值不同的設定選項資訊。

所需權限

如要取得設定選項中繼資料,您必須具備下列身分與存取權管理 (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

請依指示取代下列項目:

範例

以下範例會從 INFORMATION_SCHEMA.PROJECT_OPTIONS 檢視畫面擷取 OPTION_NAMEOPTION_TYPEOPTION_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             |
  +--------------------------------------------+-------------+---------------------+