创建和管理保存的查询

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

保存的查询功能仅在 Google Cloud 控制台中提供。

所需的角色

如需获得使用保存的查询所需的权限，请让管理员向您授予项目的以下 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. 前往 Google Cloud 控制台中的所有数据库 页面。
   所有数据库
2. 选择要在其中创建保存的查询的 Cloud Firestore 数据库。
3. 在导航菜单中，点击 Cloud Firestore Studio。
4. 在 探索器 窗格中，前往 合集 部分。Cloud Firestore
5. 点击集合，打开新的编辑器标签页。您也可以点击集合旁边的 more_vert 查看操作。然后，点击查询集合 ，打开新的编辑器标签页。
6. 在查询编辑器中输入查询内容。
7. 点击保存 。
8. 在保存查询对话框中，为保存的查询输入一个名称。
9. 点击保存。

打开并运行保存的查询

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

1. 在 Cloud Firestore Studio 页面的 探索器 窗格中，前往 查询 部分。
2. 点击保存的查询，即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 more_vert 查看操作。然后，点击打开查询，在“新编辑器”标签页中打开该查询。
3. 点击运行。

更新已保存的查询

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

1. 在 Cloud Firestore Studio 页面的 探索器 窗格中，前往 查询 部分。
2. 点击保存的查询，即可在新的编辑器标签页中打开该查询。您也可以点击保存的查询旁边的 more_vert 查看操作。然后，点击打开查询，在“新编辑器”标签页中打开该查询。
3. 修改查询。
4. 要保存修改的查询，请点击保存。

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

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

1. 前往 Google Cloud 控制台中的所有数据库 页面。
   所有数据库
2. 选择任意数据库。由于保存的查询是项目的子级，因此只要您拥有所需的角色，就可以从任何数据库中查看项目中的所有保存的查询。

3. 选择任意数据库。
4. 在 Cloud Firestore Studio 页面的 探索器 窗格中，前往 查询 部分。
5. 点击保存的查询旁边的 more_vert 查看操作 。然后，点击管理查询。

   系统会打开保存的查询 页面。此页面会列出此项目中的所有保存的 查询，包括其他 Google Cloud产品的保存的查询。

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

删除已保存的查询

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

1. 在 Cloud Firestore Studio 页面的 探索器 窗格中，前往 查询 部分。
2. 点击要删除的保存的查询旁边的 more_vert 查看操作 。 然后，点击删除查询以删除保存的查询。
3. 在删除查询对话框中，点击删除。

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

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

后续步骤

• 了解保存的查询。