已儲存的查詢簡介
本文將簡介 BigQuery 中已儲存的查詢。您可以使用已儲存的查詢建立及管理 SQL 指令碼，系統會自動儲存已儲存查詢的變更，因此關閉查詢編輯器時不會遺失工作內容。已儲存的查詢提供下列選項，可提升協作效率及查詢管理成效：
- 使用 Identity and Access Management (IAM)，與特定使用者和群組共用已儲存的查詢。
- 查看查詢版本記錄。
- 還原或從先前的查詢版本建立分支。
已儲存的查詢是 Dataform 支援的 BigQuery Studio 程式碼資產。筆記本也是程式碼資產。所有程式碼資產都會儲存在預設區域。更新預設區域後，之後建立的所有程式碼資產都會使用新的區域。
儲存查詢功能僅適用於 Google Cloud 控制台。
已儲存查詢的安全性
您可以使用 Identity and Access Management (IAM) 角色，控管已儲存查詢的存取權。詳情請參閱共用已儲存的查詢。
支援的地區
您可以在 BigQuery Studio 中儲存、共用及管理已儲存的查詢。下表列出 BigQuery Studio 適用的區域：
| 地區說明 | 地區名稱 | 詳細資料 | |
|---|---|---|---|
| 非洲 | |||
| 約翰尼斯堡 | africa-south1 |
||
| 美洲 | |||
| 哥倫布 | us-east5 |
||
| 達拉斯 | us-south1 |
 二氧化碳排放量低2
|
|
| 愛荷華州 | us-central1 |
二氧化碳排放量低2
|
|
| 洛杉磯 | us-west2 |
||
| 拉斯維加斯 | us-west4 |
||
| 蒙特婁 | northamerica-northeast1 |
二氧化碳排放量低2
|
|
| 北維吉尼亞州 | us-east4 |
||
| 奧勒岡州 | us-west1 |
二氧化碳排放量低2 |
|
| 聖保羅 | southamerica-east1 |
二氧化碳排放量低2
|
|
| 南卡羅來納州 | us-east1 |
||
| 亞太地區 | |||
| 香港 | asia-east2 |
||
| 雅加達 | asia-southeast2 |
||
| 孟買 | asia-south1 |
||
| 首爾 | asia-northeast3 |
||
| 新加坡 | asia-southeast1 |
||
| 雪梨 | australia-southeast1 |
||
| 台灣 | asia-east1 |
||
| 東京 | asia-northeast1 |
||
| 歐洲 | |||
| 比利時 | europe-west1 |
二氧化碳排放量低2
|
|
| 法蘭克福 | europe-west3 |
二氧化碳排放量低2
|
|
| 倫敦 | europe-west2 |
二氧化碳排放量低2
|
|
| 馬德里 | europe-southwest1 |
二氧化碳排放量低2
|
|
| 荷蘭 | europe-west4 |
二氧化碳排放量低2
|
|
| 杜林 | europe-west12 |
||
| 蘇黎世 | europe-west6 |
二氧化碳排放量低2
|
|
| 中東地區 | |||
| 杜哈 | me-central1 |
||
| 達曼 | me-central2 |
||
配額與限制
詳情請參閱「已儲存查詢的配額與限制」。
限制
已儲存的查詢有以下限制：
- 您只能將已儲存查詢的公開存取權授予
allAuthenticatedUsers主體。您無法將已儲存查詢的存取權授予allUsers主體。 - 如果 Google Cloud 專案包含超過 2500 項傳統版已儲存查詢，您就無法使用批次遷移，將傳統版已儲存查詢遷移至已儲存查詢。
傳統版已儲存查詢
傳統版已儲存查詢是較早儲存及共用 SQL 查詢的方式。 傳統版已儲存查詢會提供查詢文字，且唯一保留的查詢設定是 SQL 版本。這項設定會決定查詢要使用舊版 SQL 還是 GoogleSQL。如要查詢資料，使用者必須能存取已儲存查詢所存取的資料。
您可以在「Explorer」窗格的「(傳統版) 查詢」資料夾中查看傳統版已儲存查詢：
傳統版已儲存查詢可分為 3 種類型：
- 個人。只有建立者才能查看個人傳統版已儲存查詢。這類檔案會以 圖示標示。
- 專案層級。凡是擁有必要權限的主體，都能看到專案層級的儲存查詢。這類檔案會標示 圖示。
- 公開。擁有查詢連結的任何人都可看到公開的傳統版已儲存查詢。這類檔案會以 圖示標示。
您可以將傳統版已儲存查詢遷移至已儲存查詢，以便使用新功能，也可以繼續以傳統版已儲存查詢的形式維護這些查詢，直到淘汰為止。淘汰時程正在審查中。
傳統的已儲存查詢功能僅適用於Google Cloud 控制台。
淘汰傳統版已儲存查詢
BigQuery Studio 的已儲存查詢功能將取代傳統的已儲存查詢。我們正在審查淘汰時程。如要在傳統版已儲存查詢淘汰後編輯這類查詢，請將傳統版查詢遷移至 BigQuery Studio 已儲存查詢。
如果使用者 (包括您) 的個人查詢含有不應向專案資料存取者公開的資訊，查詢擁有者必須先刪除查詢或資訊，才能完成遷移作業。
為支援這項轉換，我們在 2024 年 2 月更新了下列 BigQuery IAM 角色：
BigQuery 管理員 (
roles/bigquery.admin) 將取得 Dataform 管理員 (roles/dataform.admin) 權限。BigQuery 工作使用者 (
roles/bigquery.jobUser) 將取得下列權限：dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
BigQuery 使用者 (
roles/bigquery.user) 將取得下列權限：dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
如要讓沒有 BigQuery 管理員、BigQuery 工作使用者或 BigQuery 使用者角色的使用者使用已儲存的查詢，請在 IAM 中授予他們必要權限。
自訂角色不會自動更新。如要更新自訂角色並授予必要權限，請參閱「編輯現有的自訂角色」。