创建和管理保存的查询

预览版

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

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

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

所需的角色

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

• 查看已保存的查询：Bigtable Reader (roles/bigtable.reader)
• 查看、创建、修改和删除已保存的查询：Bigtable User (roles/bigtable.user)
• 如需管理、查看、创建、修改和删除已保存的查询，您需要拥有 Bigtable Admin (roles/bigtable.admin) 角色。此角色具有广泛的权限，可提供对 Bigtable 的完全访问权限，仅供管理员使用。

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

这些预定义角色包含使用保存的查询所需的权限。如需详细了解所需权限，请参阅所需权限。

所需权限

如需创建、查看、修改和删除保存的查询，您需要在项目级具有以下 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) 角色。如需详细了解 Bigtable IAM，请参阅使用 IAM 进行 Bigtable 访问权限控制。

创建已保存的查询

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

1. 在 Google Cloud 控制台中，前往 Bigtable 实例页面。
   实例
2. 选择要在其中创建已保存的查询的实例。

3. 在导航菜单中，点击 Bigtable Studio。

   探索器窗格会显示实例中的表、视图和查询列表。

4. 在编辑器标签页中，运行查询。

   结果会显示在结果表中。

5. 如果您对结果不满意，请修改查询，然后再次运行。对查询感到满意后，点击保存。
6. 在保存查询对话框中，为保存的查询输入一个名称。
7. 点击保存。

可选：

• 如需使用其他名称保存查询，请点击另存为展开箭头，选择另存为查询，然后在对话框中输入新名称。
• 如需更改此已保存的查询使用的区域，请选择显示高级选项。然后，从区域列表中选择一个区域。

您还可以将查询另存为逻辑或持续物化视图。

打开并运行保存的查询

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

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

更新已保存的查询

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

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

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

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

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

3. 在 Bigtable Studio 页面上的探索器窗格中，前往查询部分。
4. 点击保存的查询旁边的 查看操作。然后，点击管理查询。

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

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

删除已保存的查询

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

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

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

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

后续步骤

• 了解保存的查询。