创建和管理已保存的查询

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

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

所需的角色

如需获得使用已保存的查询所需的权限，请让管理员向您授予项目的以下 IAM 角色：

  • 创建和删除已保存的查询：Studio Query User (roles/databasesConsole.studioQueryUser)
  • 管理项目中的所有已保存的查询，包括对“已保存的查询”页面的访问权限：Studio Query Admin (roles/databasesConsole.studioQueryAdmin)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含使用已保存的查询所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

使用已保存的查询需要以下权限：

  • 创建和删除已保存的查询：
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • 管理项目中的所有已保存的查询：
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

Studio Query User (roles/databasesConsole.studioQueryUser) 角色可提供创建、查看和写入已保存的查询的访问权限。这对于大多数用户来说已经足够。

仅应向管理员授予 Studio Query Admin (roles/databasesConsole.studioQueryAdmin) 角色。如需详细了解 Spanner Identity and Access Management (IAM)，请参阅 IAM 概览。

权限

如需创建已保存的查询，您需要在项目级别具有以下 IAM 权限：

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

如需查看已保存的查询，您需要在项目级层具有以下权限：

  • databasesConsole.studioQueries.search

如需修改和删除已保存的查询，您需要在项目级层具有以下权限：

  • databasesConsole.studioQueries.update

执行查询的权限是从数据库继承的。您可能有权查看查询，但无权执行查询。

创建已保存的查询

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

  1. 前往Google Cloud 控制台中的 Spanner 实例页面。

    实例

  2. 选择要在其中创建已保存的查询的实例。

  3. 选择要在其中创建已保存的查询的数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 在 Spanner Studio 页面上，点击 新标签页或使用空白编辑器标签页。

  6. 在查询编辑器中，输入有效的 SQL 查询。

  7. 点击保存。

  8. 在保存查询对话框中，为已保存的查询输入一个名称。

  9. 点击保存。

打开并运行已保存的查询

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

  1. 在 Spanner Studio 页面上，点击 新标签页或使用空白编辑器标签页。
  2. 在探索器窗格中，前往查询部分。点击已保存的查询，以在新编辑器标签页中将其打开。或者，点击已保存的查询旁边的 查看操作。然后，点击打开查询，以在新编辑器标签页中打开该查询。
  3. 点击运行。

更新已保存的查询

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

  1. 在 Spanner Studio 页面上，点击 新标签页或使用空白编辑器标签页。
  2. 在探索器窗格中，前往查询部分。点击已保存的查询，在新编辑器标签页中将其打开。或者，点击已保存的查询旁边的 查看操作。然后，点击打开查询，以在新编辑器标签页中打开该查询。
  3. 修改查询。
  4. 要保存修改的查询，请点击保存。

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

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

  1. 前往Google Cloud 控制台中的 Spanner 实例页面。

    实例

  2. 选择任意实例。（由于已保存的查询是项目的子级，因此只要您拥有所需的角色，就可以通过任何实例或数据库查看项目中的所有已保存的查询。）

  3. 选择任意数据库。

  4. 在 Spanner Studio 页面上，点击 新标签页或使用空白编辑器标签页。

  5. 在探索器窗格中，前往查询部分。点击已保存的查询旁边的 查看操作。然后，点击管理查询。

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

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

如需在已保存的查询页面上删除已保存的查询，请按以下步骤操作：

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

删除已保存的查询

  1. 在 Spanner Studio 页面上，点击 新标签页或使用空白编辑器标签页。
  2. 在探索器窗格中，展开查询文件夹。点击要删除的已保存的查询旁边的 查看操作。然后点击删除查询以删除已保存的查询。
  3. 在删除查询对话框中，点击删除。

后续步骤