已儲存的查詢簡介
在 BigQuery 中使用已儲存的查詢，安全地儲存、管理及協作 SQL 指令碼。在查詢編輯器中工作時，系統會自動儲存變更，避免不小心遺失工作內容。
已儲存的查詢是由 Dataform 支援的 BigQuery Studio 程式碼資產，因此提供進階協作和版本管控功能。您可以：
- 安全協作：使用 Identity and Access Management (IAM)，與特定使用者和群組共用已儲存的查詢。
- 追蹤變更：查看查詢編輯器的詳細版本記錄。
- 管理版本：從查詢的先前版本分支或還原，安全地測試修改內容。
已儲存的查詢功能僅適用於 Google Cloud 控制台。
已儲存的查詢安全性
您可以使用 Identity and Access Management (IAM) 角色控管已儲存的查詢的存取權。詳情請參閱「共用已儲存的查詢」和「已儲存查詢的安全性考量」。
支援的地區
所有已儲存的查詢都會儲存在預設區域。更新預設區域後，之後建立的查詢都會變更位置。下表列出 BigQuery Studio 支援的區域：
| 地區說明 | 區域名稱 | 詳細資料 | |
|---|---|---|---|
| 非洲 | |||
| 約翰尼斯堡 | africa-south1 |
||
| 美洲 | |||
| 哥倫布 | us-east5 |
||
| 達拉斯 | us-south1 |
 低二氧化碳排放
|
|
| 愛荷華州 | us-central1 |
低二氧化碳排放
|
|
| 洛杉磯 | us-west2 |
||
| 拉斯維加斯 | us-west4 |
||
| 蒙特婁 | northamerica-northeast1 |
低二氧化碳排放
|
|
| 北維吉尼亞州 | us-east4 |
||
| 奧勒岡州 | us-west1 |
低二氧化碳排放
|
|
| 聖保羅 | southamerica-east1 |
低二氧化碳排放
|
|
| 南卡羅來納州 | us-east1 |
||
| 亞太地區 | |||
| 香港 | asia-east2 |
||
| 雅加達 | asia-southeast2 |
||
| 孟買 | asia-south1 |
||
| 首爾 | asia-northeast3 |
||
| 新加坡 | asia-southeast1 |
||
| 雪梨 | australia-southeast1 |
||
| 台灣 | asia-east1 |
||
| 東京 | asia-northeast1 |
||
| 歐洲 | |||
| 比利時 | europe-west1 |
低二氧化碳排放
|
|
| 芬蘭 | europe-north1 |
低二氧化碳排放
|
|
| 法蘭克福 | europe-west3 |
||
| 倫敦 | europe-west2 |
低二氧化碳排放
|
|
| 馬德里 | europe-southwest1 |
低二氧化碳排放
|
|
| 米蘭 | europe-west8 |
低二氧化碳排放
|
|
| 荷蘭 | europe-west4 |
低二氧化碳排放
|
|
| 杜林 | europe-west12 |
低二氧化碳排放
|
|
| 華沙 | europe-central2 |
低二氧化碳排放
|
|
| 蘇黎世 | europe-west6 |
低二氧化碳排放
|
|
| 中東地區 | |||
| 達曼 | me-central2 |
||
| 杜哈 | me-central1 |
||
| 特拉維夫 | me-west1 |
||
配額與限制
詳情請參閱「已儲存的查詢的配額和限制」。
限制
已儲存的查詢有下列限制：
- 您只能將已儲存的查詢的公開存取權授予
allAuthenticatedUsers主體。您無法將已儲存的查詢的存取權授予allUsers主體。 - 如果 Google Cloud 專案包含超過 2,500 項傳統版已儲存的查詢，則無法使用批次遷移，將傳統版已儲存的查詢遷移至已儲存的查詢。
傳統版已儲存的查詢 (已淘汰)
傳統版已儲存查詢完全淘汰後，如要編輯現有查詢，請遷移至 BigQuery Studio。
傳統版已儲存的查詢是儲存及共用 SQL 的舊方法。與 BigQuery Studio 已儲存的查詢不同，這些查詢只會保留查詢文字和 SQL 版本 (舊版 SQL 或 GoogleSQL)。
在 Google Cloud 控制台中，這些查詢會顯示在「Explorer」窗格的「(Classic) Queries」資料夾中。(如果尚未啟用 BigQuery Studio，則會顯示在「傳統版 Explorer」窗格的「已儲存的查詢 (NUMBER)」資料夾中)。
傳統版已儲存的查詢分為三種：
個人 ()：只有建立者可以查看。
- 注意：如果個人查詢含有機密資訊，您必須先刪除查詢或移除機密資料，才能進行遷移。
專案層級 ()：任何具備必要權限的主體都能查看。
公開 ()：任何擁有查詢連結的使用者都能查看。
遷移和存取權的 IAM 角色
下列預先定義的 BigQuery IAM 角色包含必要的 Dataform 權限，可協助您轉換至 BigQuery Studio 已儲存的查詢：
- BigQuery 管理員 (
roles/bigquery.admin) 包含roles/dataform.admin權限。 - BigQuery 工作使用者 (
roles/bigquery.jobUser) 和 BigQuery 使用者 (roles/bigquery.user) 包含：dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
如果您沒有這些預先定義的角色，請要求必要權限。自訂角色不會自動更新，必須手動編輯。