本頁說明如何建立及管理已儲存的查詢。在 Firebase 控制台中撰寫查詢時，您可以儲存及管理這些查詢。詳情請參閱已儲存查詢總覽。
儲存查詢功能僅適用於主控台，無法透過 API 使用。
必要的角色
如要取得使用已儲存查詢所需的權限，請要求管理員授予您專案的下列 Identity and Access Management (IAM) 角色：
- 如要查看已儲存的查詢：
Cloud Datastore 檢視器 (
roles/datastore.viewer) - 如要查看、建立、修改及刪除已儲存的查詢：Cloud Datastore 使用者 (
roles/datastore.user) - 如要管理、查看、建立、修改及刪除已儲存的查詢，請使用：
Cloud Datastore 擁有者 (
roles/datastore.owner)。這個角色具有廣泛的權限，並提供 Cloud Firestore 的完整存取權，僅供管理員使用。
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這些預先定義的角色具備使用已儲存查詢所需的權限。如要進一步瞭解必要權限，請參閱「必要權限」。
所需權限
如要建立、查看、修改及刪除已儲存的查詢，您需要專案層級的下列 IAM 權限：
| 動作 | 必要的 IAM 權限 |
|---|---|
| 建立已儲存的查詢 |
|
| 查看已儲存的查詢 |
|
| 修改已儲存的查詢 |
|
| 刪除已儲存的查詢 |
|
| 管理已儲存的查詢 (僅限管理員使用) |
|
Studio 查詢使用者
(roles/databasesconsole.studioQueryUser)
角色可建立、查看及寫入已儲存的查詢。這個角色可滿足大多數使用者的需求。
只授予管理員「Studio 查詢管理員」(roles/databasesconsole.studioQueryAdmin) 角色。如要進一步瞭解 Cloud Firestore IAM，請參閱「身分與存取權管理」。
建立已儲存的查詢
如要建立已儲存的查詢，請按照下列步驟操作：
- 前往 Firebase 控制台的「Cloud Firestore」頁面。
Cloud Firestore - 選取要建立已儲存的查詢的資料庫。資料庫必須是 Enterprise 版執行個體。
- 按一下「查詢編輯器」分頁標籤。
- 在查詢編輯器中輸入查詢。
- 按一下 [儲存]。
- 在「儲存查詢」對話方塊中，輸入已儲存的查詢名稱。
- 按一下 [儲存]。
開啟並執行已儲存的查詢
如要以新查詢的形式開啟已儲存的查詢，請按照下列步驟操作：
- 在「查詢編輯器」中，按一下「已儲存的查詢」圖示 ()。
- 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「查看動作」，然後按一下「開啟查詢」，在新編輯器分頁中開啟查詢。
- 按一下「執行」。
更新已儲存的查詢
如要更新現有的已儲存的查詢，請按照下列步驟操作：
- 在「查詢編輯器」中，按一下「已儲存的查詢」圖示 ()。
- 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「查看動作」，然後按一下「開啟查詢」，在新編輯器分頁中開啟查詢。
- 修改查詢。
- 如要儲存修改後的查詢，請按一下「儲存」。
查看及管理所有已儲存的查詢清單
如要查看專案中所有已儲存查詢的清單，請按照下列步驟操作：
前往 Google Cloud 控制台的「已儲存的查詢」頁面。
前往「已儲存的查詢」您可以在「已儲存的查詢」頁面中搜尋、篩選、查看及刪除查詢。您無法在「已儲存的查詢」頁面上編輯現有查詢。
刪除已儲存的查詢
您可以從 Cloud Firestore Studio 頁面或 Google Cloud 控制台的「已儲存的查詢」頁面刪除已儲存的查詢。
- 在「查詢編輯器」中，按一下「已儲存的查詢」圖示 ()。
- 找出要刪除的已儲存的查詢，然後按一下旁邊的 「查看動作」。然後按一下「刪除查詢」，即可刪除已儲存的查詢。
- 在「Delete query」(刪除查詢) 對話方塊中，按一下「Delete」(刪除)。
您也可以在「已儲存的查詢」頁面中刪除已儲存的查詢。如要刪除「已儲存的查詢」頁面上的已儲存查詢，請按照下列步驟操作：
- 前往「已儲存的查詢」頁面。
- 找出要刪除的已儲存查詢，然後按一下旁邊的 「查看動作」。
- 按一下「刪除查詢」即可刪除已儲存的查詢。
- 在「Delete query」(刪除查詢) 對話方塊中，按一下「Delete」(刪除)。
後續步驟
- 瞭解已儲存的查詢。