创建和管理已保存的查询

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

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

所需的角色

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

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

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

所需权限

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

  • 如需创建和删除已保存的查询，请执行以下操作：
    • 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 查询用户 (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。

    1. 在 Spanner Studio 页面上，点击 New tab（新建标签页），或使用空白编辑器标签页。

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

  6. 点击保存。

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

  8. 点击保存。

打开并运行已保存的查询

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

  1. 在 Spanner Studio 页面上，点击 New tab（新建标签页），或使用空白编辑器标签页。
  2. 在浏览器窗格中，前往查询部分。点击已保存的查询，即可在新编辑器标签页中打开该查询。或者，点击已保存的查询旁边的 查看操作。然后，点击打开查询，在新的编辑器标签页中打开该查询。
  3. 点击运行。

更新已保存的查询

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

  1. 在 Spanner Studio 页面上，点击 New tab（新建标签页），或使用空白编辑器标签页。
  2. 在浏览器窗格中，前往查询部分。点击已保存的查询，即可在新编辑器标签页中打开该查询。或者，点击已保存的查询旁边的 查看操作。然后，点击打开查询，在新的编辑器标签页中打开该查询。
  3. 修改查询。
  4. 如需保存修改后的查询，请点击保存。

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

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

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

    实例

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

  3. 选择任意数据库。

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

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

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

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

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

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

删除已保存的查询

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

后续步骤