创建和管理保存的查询

本页面介绍了如何创建和管理已保存的查询。在 Firebase 控制台中编写查询时,您可以保存和管理这些查询。如需了解详情,请参阅保存的查询概览。

保存的查询功能仅在控制台中提供,无法通过 API 使用。

所需的角色

如需获得使用保存的查询所需的权限,请让管理员向您授予项目的以下 Identity and Access Management (IAM) 角色:

  • 如需查看已保存的查询,您需要具备以下角色: Cloud Datastore Viewer (roles/datastore.viewer)
  • 查看、创建、修改和删除已保存的查询:Cloud Datastore User (roles/datastore.user)
  • 如需管理、查看、创建、修改和删除已保存的查询,请使用 Cloud Datastore Owner (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 Query User (roles/databasesconsole.studioQueryUser) 角色可提供创建、查看和写入保存的查询的访问权限。此角色可满足大多数用户的需求。

仅向管理员授予 Studio Query Admin (roles/databasesconsole.studioQueryAdmin) 角色。如需详细了解 Cloud Firestore IAM,请参阅 Identity and Access Management 。

创建已保存的查询

如需创建已保存的查询,请按照下列步骤操作:

  1. 前往 Firebase 控制台中的 Cloud Firestore 页面。
    Cloud Firestore
  2. 选择要在其中创建已保存的查询的数据库。数据库必须是企业版实例。
  3. 点击查询编辑器标签页。
  4. 在查询编辑器中输入查询内容。
  5. 点击保存。
  6. 在保存查询对话框中,为保存的查询输入一个名称。
  7. 点击保存。

打开并运行保存的查询

如需将保存的查询作为新查询打开,请按照以下步骤操作:

  1. 在查询编辑器中,点击已保存的查询 ()。
  2. 点击保存的查询,即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 查看操作。然后,点击打开查询,在“新编辑器”标签页中打开该查询。
  3. 点击运行。

更新已保存的查询

如需更新现有的已保存的查询,请按以下步骤操作:

  1. 在查询编辑器中,点击已保存的查询 ()。
  2. 点击保存的查询,即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 查看操作。然后,点击打开查询,在“新编辑器”标签页中打开该查询。
  3. 修改查询。
  4. 要保存修改的查询,请点击保存。

查看和管理所有保存的查询的列表

如需查看项目中所有保存的查询的列表,请按照以下步骤操作:

在 Google Cloud 控制台中,前往已保存的查询页面。

前往“已保存的查询”

您可以在保存的查询页面上搜索、过滤、查看和删除查询。您无法在保存的查询页面上修改现有查询。

删除已保存的查询

您可以在 Google Cloud 控制台中的 Cloud Firestore Studio 页面或保存的查询页面上删除保存的查询。

  1. 在查询编辑器中,点击已保存的查询 ()。
  2. 点击要删除的保存的查询旁边的 查看操作。 然后,点击删除查询以删除保存的查询。
  3. 在删除查询对话框中,点击删除。

您还可以在保存的查询页面上删除保存的查询。如需在保存的查询页面上删除保存的查询,请按照以下步骤操作:

  1. 前往保存的查询页面。
  2. 点击要删除的保存的查询旁边的 查看操作。
  3. 点击删除查询以删除保存的查询。
  4. 在删除查询对话框中,点击删除。

后续步骤