创建和管理保存的查询

本页面介绍了如何创建和管理已保存的查询。在 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 。

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

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

在查询编辑器 中，点击保存的查询 （）。
点击保存的查询，即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 查看操作。然后，点击打开查询，在“新编辑器”标签页中打开该查询。
点击运行。

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

在查询编辑器 中，点击保存的查询 （）。
点击保存的查询，即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 查看操作。然后，点击打开查询，在“新编辑器”标签页中打开该查询。
修改查询。
要保存修改的查询，请点击保存。

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

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

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

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

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