建立及管理已儲存的查詢

如要在不同工作階段重複使用及共用常見的資料庫作業，可以在 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 權限
建立已儲存的查詢
  • 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，請參閱「Identity and Access Management」。

建立已儲存的查詢

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

  1. 前往 Firebase 控制台的「Cloud Firestore」頁面。
    Cloud Firestore
  2. 選取要建立已儲存的查詢的資料庫。資料庫必須是 Enterprise 版執行個體。
  3. 按一下「Query editor」(查詢編輯器) 分頁標籤。
  4. 在查詢編輯器中輸入查詢。
  5. 按一下「儲存」。
  6. 在「儲存查詢」對話方塊中，輸入已儲存的查詢的名稱。
  7. 按一下「儲存」。

開啟並執行已儲存的查詢

如要將已儲存的查詢做為新查詢開啟，請按照下列步驟操作：

  1. 在「查詢編輯器」中，點選「已儲存的查詢」圖示 。
  2. 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「View actions」(查看動作)。然後按一下「Open query」(開啟查詢)，在新編輯器分頁中開啟查詢。
  3. 按一下「執行」。

更新已儲存的查詢

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

  1. 在「查詢編輯器」中，點選「已儲存的查詢」圖示 。
  2. 按一下已儲存的查詢，即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「View actions」(查看動作)。然後按一下「Open query」(開啟查詢)，在新編輯器分頁中開啟查詢。
  3. 修改查詢。
  4. 如要儲存修改後的查詢，請按一下「儲存」。

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

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

前往 Google Cloud 控制台的「Saved queries」(已儲存的查詢) 頁面。

前往「Saved queries」(已儲存的查詢) 頁面

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

刪除已儲存的查詢

您可以在 Google Cloud 控制台的「Cloud Firestore Studio」 頁面或「Saved queries」(已儲存的查詢) 頁面刪除已儲存的查詢。

  1. 在「查詢編輯器」中，點選「已儲存的查詢」圖示 。
  2. 按一下要刪除的已儲存查詢旁的 「View actions」(查看動作)。接著，如要刪除已儲存的查詢，請按一下「刪除查詢」。
  3. 在「Delete query」(刪除查詢) 對話方塊中，點選「Delete」(刪除)。

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

  1. 前往「Saved queries」(已儲存的查詢) 頁面。
  2. 按一下要刪除的已儲存的查詢旁的 「View actions」(查看動作)。
  3. 按一下「刪除查詢」，即可刪除已儲存的查詢。
  4. 在「Delete query」(刪除查詢) 對話方塊中，點選「Delete」(刪除)。

後續步驟