建立及管理已儲存的查詢

本頁說明如何建立及管理已儲存的查詢。在 Cloud Firestore Studio 中編寫查詢時，可以儲存及管理這些查詢。詳情請參閱已儲存查詢總覽。

已儲存的查詢功能僅適用於 Google Cloud 控制台。

必要的角色

如要取得使用已儲存查詢所需的權限，請要求管理員授予您專案的下列 Identity and Access Management (IAM) 角色：

  • 如要查看已儲存的查詢： Cloud Datastore 檢視器 (roles/datastore.viewer)
  • 如要查看、建立、修改及刪除已儲存的查詢：Cloud Datastore 使用者 (roles/datastore.user)
  • 如要管理、查看、建立、修改及刪除已儲存的查詢，請使用： Cloud Datastore 擁有者 (roles/datastore.owner)。這個角色具有廣泛的權限，並提供 Cloud Firestore 的完整存取權，僅供管理員使用。

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色具備使用已儲存查詢所需的權限。如要進一步瞭解必要權限，請參閱「必要權限」。

所需權限

如要建立、查看、修改及刪除已儲存的查詢，您需要專案層級的下列 IAM 權限：

動作 必要的 IAM 權限
建立已儲存的查詢
  • databasesconsole.studioQueries.create
查看已儲存的查詢
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
修改已儲存的查詢
  • databasesconsole.studioQueries.update
刪除已儲存的查詢
  • databasesconsole.studioQueries.delete
管理已儲存的查詢
(僅限管理員使用)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

您也可以使用自訂角色或其他預先定義的角色取得這些權限。

Studio 查詢使用者 (roles/databasesconsole.studioQueryUser) 角色提供建立、查看及寫入已儲存查詢的存取權。這個角色可滿足大多數使用者的需求。

請只授予管理員「Studio 查詢管理員」(roles/databasesconsole.studioQueryAdmin) 角色。如要進一步瞭解 Cloud Firestore IAM，請參閱「身分與存取權管理」。

建立已儲存的查詢

如要建立已儲存的查詢，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「所有資料庫」頁面。
    所有資料庫
  2. 選取要建立已儲存的查詢的 Cloud Firestore 資料庫。
  3. 在導覽選單中，按一下「Cloud Firestore Studio」。
  4. 在 Cloud Firestore Studio 頁面的「Explorer」窗格中，前往「Collections」部分。
  5. 按一下集合，開啟新的編輯器分頁。(選用) 你可以點選集合旁的 「查看動作」，然後按一下「查詢集合」，開啟新的編輯器分頁。
  6. 在查詢編輯器中輸入查詢。
  7. 按一下 [儲存]。
  8. 在「儲存查詢」對話方塊中，輸入已儲存的查詢名稱。
  9. 按一下 [儲存]。

開啟並執行已儲存的查詢

如要以新查詢的形式開啟已儲存的查詢，請按照下列步驟操作：

  1. 在「Cloud Firestore Studio」頁面的「Explorer」窗格中，前往「Queries」部分。
  2. 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「查看動作」，然後按一下「開啟查詢」，在新編輯器分頁中開啟查詢。
  3. 按一下「執行」。

更新已儲存的查詢

如要更新現有的已儲存的查詢，請按照下列步驟操作：

  1. 在「Cloud Firestore Studio」頁面的「Explorer」窗格中，前往「Queries」部分。
  2. 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「查看動作」，然後按一下「開啟查詢」，在新編輯器分頁中開啟查詢。
  3. 修改查詢。
  4. 如要儲存修改後的查詢，請按一下「儲存」。

查看及管理所有已儲存的查詢清單

如要查看專案中所有已儲存查詢的清單，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「所有資料庫」頁面。
    所有資料庫
  2. 選取任一資料庫。由於已儲存的查詢是專案的子項，只要您具備必要角色，就能從任何資料庫查看專案中的所有已儲存的查詢。
  1. 選取任何資料庫。
  2. 在「Cloud Firestore Studio」頁面的「Explorer」窗格中，前往「Queries」部分。
  3. 按一下已儲存的查詢旁的「查看動作」。然後按一下「管理查詢」。

    「已儲存的查詢」頁面隨即開啟。這個頁面會列出這項專案中所有已儲存的查詢，包括其他 Google Cloud 產品的已儲存查詢。

您可以在「已儲存的查詢」頁面中搜尋、篩選、查看及刪除查詢。您無法在「已儲存的查詢」頁面編輯現有查詢。

刪除已儲存的查詢

您可以從 Cloud Firestore Studio 頁面，或 Google Cloud 控制台的「已儲存的查詢」頁面刪除已儲存的查詢。

  1. 在「Cloud Firestore Studio」頁面的「Explorer」窗格中，前往「Queries」專區。
  2. 找出要刪除的已儲存的查詢，然後按一下旁邊的 「查看動作」。然後按一下「刪除查詢」，即可刪除已儲存的查詢。
  3. 在「Delete query」(刪除查詢) 對話方塊中，按一下「Delete」(刪除)。

您也可以在「已儲存的查詢」頁面中刪除已儲存的查詢。如要刪除「已儲存的查詢」頁面上的已儲存查詢，請按照下列步驟操作：

  1. 前往「已儲存的查詢」頁面。
  2. 找出要刪除的已儲存查詢，然後按一下旁邊的 「查看動作」。
  3. 按一下「刪除查詢」即可刪除已儲存的查詢。
  4. 在「Delete query」(刪除查詢) 對話方塊中，按一下「Delete」(刪除)。

後續步驟