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 |
替換下列內容:
REGION:任何資料集區域名稱。例如:region-us。
範例
以下範例會從 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 | +--------------------------------------------+-------------+---------------------+