# 开始使用 Aurora DSQL 查询编辑器
<a name="getting-started-query-editor"></a>

借助 Aurora DSQL 查询编辑器，无需安装或配置外部客户端，即可直接从 AWS 管理控制台安全地连接到 Aurora DSQL 集群并运行 SQL 查询。它提供了一个直观的工作区，内置语法高亮、自动补全和智能代码辅助功能。您可以在单个界面中快速浏览架构对象、开发并运行 SQL 查询以及查看结果。

本主题将引导您完成连接到集群、运行查询、查看结果和浏览高级功能（例如，执行计划）所需的步骤。

**注意**  
查询编辑器已在所有支持 Aurora DSQL 的区域推出。有关区域可用性的更多详细信息，请参阅 [AWS 区域服务](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)。

## 先决条件
<a name="query-editor-prerequisites"></a>

在您开始之前，确保您满足以下要求：
+ 您拥有至少一个可用的 Aurora DSQL 集群。有关创建集群的更多详细信息，请参阅[步骤 1：创建 Aurora DSQL 单区域集群](getting-started.md#getting-started-create-cluster)。
+ 集群端点可公开访问。查询编辑器不支持公共访问受到基于资源的策略阻止的集群或通过 VPC 端点管理的集群。有关访问限制的更多详细信息，请参阅[在 Aurora DSQL 中使用基于资源的策略屏蔽公共访问权限](rbp-block-public-access.md)和[使用 AWS PrivateLink 管理和连接到 Amazon Aurora DSQL 集群](privatelink-managing-clusters.md)。
+ 您的 IAM 用户或角色具有访问和连接到集群所需的权限。有关权限的更多详细信息，请参阅[使用数据库角色和 IAM 身份验证](using-database-and-iam-roles.md)。

## 使用查询编辑器
<a name="query-editor-working"></a>

### 打开查询编辑器
<a name="query-editor-open"></a>

**要打开查询编辑器，请执行以下操作：**

1. 打开 [Aurora DSQL 控制台](https://console.aws.amazon.com/dsql)。

1. 在导航窗格中，选择**查询编辑器**。

或者，在**集群**页面中，选择要查询的集群，然后选择**使用查询编辑器进行连接**以直接启动该编辑器。

**注意**  
未保存工作和连接状态。如果您退出 Aurora DSQL 控制台、关闭浏览器标签页或注销，则您的连接、查询文本和结果都将丢失。

### 连接到集群
<a name="query-editor-connect"></a>

**要连接到集群，请执行以下操作：**

1. 如果不存在集群连接，编辑器将显示**未连接任何集群**。选择**连接**或在**集群资源管理器**窗格中选择 **\+**（添加）以连接到现有集群。

1. （可选）使用不同的角色连接到多个集群或同一集群。

### 浏览集群对象
<a name="query-editor-explore"></a>

集群资源管理器会显示所有可用的集群连接，并可让您浏览数据库、架构、表和视图等对象。它还提供常用操作（例如**刷新**、**创建表**）以及其他特定于上下文的选项。

### 运行查询
<a name="query-editor-run-queries"></a>

**运行查询**

1. 在查询编辑器选项卡窗格中，输入您的 SQL 语句。例如：

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. 验证查询选项卡右上角显示的**活动集群上下文**。这表示与当前查询选项卡关联的集群连接。

1. （可选）使用**连接**下拉列表查看所有可用连接或切换至其他集群。更改连接时将更新该选项卡中的查询执行位置。

1. 选择**运行**以运行查询。

**注意**  
每个查询在结果窗格中最多可返回 10000 行数据。对于大型数据集，请使用筛选条件或限制来优化查询。

### 查看结果和执行计划
<a name="query-editor-view-results"></a>

查询运行后，可在编辑器底部的**“结果”面板**中查看输出。默认情况下，每次执行查询都会显示**结果（表）**选项卡，并以表格形式呈现查询输出。

要获取查询执行计划，请运行 `EXPLAIN ANALYZE` 或 `EXPLAIN ANALYZE VERBOSE` 以获取有关查询性能的更多见解。有关执行计划的更多详细信息，请参阅[阅读 Aurora DSQL EXPLAIN 计划](reading-dsql-explain-plans.md)。

**提示**  
`EXPLAIN ANALYZE VERBOSE` 命令可用于显示 DPU 使用量估算值（包括计算、读取、写入和总 DPU 值），以便您即时了解单个 SQL 语句消耗的资源。