创建和管理保存的查询

创建和管理保存的查询

预览版

此功能 受服务专用条款的约束。 非正式版功能“按原样”提供，且可能仅提供有限支持。 如需了解详情，请参阅发布阶段说明。

本页面介绍了如何创建和管理已保存的查询。在 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)。此角色具有广泛的权限，可提供对与 MongoDB 兼容的 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) 角色。如需详细了解与 MongoDB 兼容的 Firestore IAM，请参阅 Identity and Access Management。

创建已保存的查询

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

1. 前往 Google Cloud 控制台中的所有数据库页面。
   所有数据库
2. 选择要在其中创建已保存的查询的与 MongoDB 兼容的 Firestore 数据库。
3. 在导航菜单中，点击 Firestore Studio。
4. 在 Firestore Studio 页面上的探索器窗格中，前往集合部分。
5. 点击集合，打开新的编辑器标签页。您也可以点击集合旁边的 查看操作。然后，点击查询集合，打开新的编辑器标签页。
6. 在查询编辑器中输入查询内容。
7. 点击保存。
8. 在保存查询对话框中，为保存的查询输入一个名称。
9. 点击保存。

打开并运行保存的查询

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

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

更新已保存的查询

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

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

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

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

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

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

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

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

删除已保存的查询

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

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

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

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

后续步骤

• 了解保存的查询。