# Comece a usar o Editor de consultas do Aurora DSQL
<a name="getting-started-query-editor"></a>

Com o Editor de consultas do Aurora DSQL, você pode se conectar com segurança aos seus clusters do Aurora DSQL e executar consultas SQL diretamente do Console de Gerenciamento da AWS sem instalar nem configurar clientes externos. Ele oferece um espaço de trabalho intuitivo com destaque de sintaxe integrado, preenchimento automático e assistência inteligente de código. É possível explorar rapidamente objetos de esquema, desenvolver e executar consultas SQL e visualizar resultados, tudo em uma única interface.

Este tópico mostra as etapas para se conectar a um cluster, executar consultas, visualizar resultados e explorar recursos avançados, como planos de execução.

**nota**  
O Editor de consultas está disponível em todas as regiões onde o Aurora DSQL é aceito. Para ter mais informações sobre disponibilidade regional, consulte [Serviços regionais da AWS](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

## Pré-requisitos
<a name="query-editor-prerequisites"></a>

Antes de começar, certifique-se de que os seguintes requisitos são atendidos:
+ Você tem pelo menos um cluster do Aurora DSQL disponível. Para ver mais detalhes sobre como criar clusters, consulte [Etapa 1: criar um cluster do Aurora DSQL de região única](getting-started.md#getting-started-create-cluster).
+ O endpoint do cluster pode ser acessado publicamente. O Editor de Consultas não aceita clusters com acesso público bloqueado por políticas baseadas em recursos ou clusters gerenciados por meio de endpoints da VPC. Para ver mais detalhes sobre restrições de acesso, consulte [Bloquear o acesso público com políticas baseadas em recursos no Aurora DSQL](rbp-block-public-access.md) e [Gerenciar e conectar-se com clusters do Amazon Aurora DSQL usando o AWS PrivateLink](privatelink-managing-clusters.md).
+ Seu usuário ou perfil do IAM tem as permissões necessárias para acessar e se conectar ao cluster. Para obter detalhes sobre permissões, consulte [Usar perfis de banco de dados e autenticação do IAM](using-database-and-iam-roles.md).

## Trabalhar com o Editor de consultas
<a name="query-editor-working"></a>

### Abra o editor de consulta
<a name="query-editor-open"></a>

**Como abrir o Editor de consultas**

1. Abra o [console do Aurora DSQL](https://console.aws.amazon.com/dsql).

1. No painel de navegação, selecione **Query Editor (Editor de consultas)**.

Como alternativa, na página **Clusters**, selecione o cluster que você deseja consultar e escolha **Conectar com o Editor de consultas** para iniciar o editor diretamente.

**nota**  
O trabalho e o estado da conexão não são salvos. Se você sair do console do Aurora DSQL, fechar a guia do navegador ou sair, suas conexões, o texto da consulta e os resultados serão perdidos.

### Conectar-se a um cluster
<a name="query-editor-connect"></a>

**Como se conectar a um cluster**

1. Se não houver nenhuma conexão de cluster, o editor exibirá **Nenhum cluster foi conectado**. Escolha **Conectar** ou selecione **\$1** (Adicionar) no painel **Explorador de clusters** para se conectar a um cluster existente.

1. (Opcional) Conecte-se a vários clusters ou ao mesmo cluster usando perfis diferentes.

### Explorar objetos de cluster
<a name="query-editor-explore"></a>

O Explorador de clusters exibe todas as conexões de cluster disponíveis e permite que você procure objetos, como bancos de dados, esquemas, tabelas e visualizações. Ele também fornece ações comuns, como **Atualizar**, **Criar tabela** e outras opções específicas do contexto.

### Executar consultas
<a name="query-editor-run-queries"></a>

**Para executar uma consulta**

1. No painel da guia do Editor de consultas, insira sua instrução SQL. Por exemplo:

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

1. Verifique o **contexto do cluster ativo** exibido no canto superior direito da guia de consulta. Isso indica a conexão do cluster associada à guia de consulta atual.

1. (Opcional) Use o menu suspenso de **conexão** para revisar todas as conexões disponíveis ou alternar para um cluster diferente. Alterar as atualizações de conexão onde suas consultas nessa guia são executadas.

1. Para executar a consulta, escolha **Executar**.

**nota**  
Cada consulta pode exibir até 10 mil linhas no painel de resultados. Para conjuntos de dados maiores, refine sua consulta com filtros ou limites.

### Analise os resultados e os planos de execução
<a name="query-editor-view-results"></a>

Depois que a consulta for executada, revise a saída no **painel Resultados** na parte inferior do editor. Por padrão, cada execução de consulta exibe a guia **Resultados (Tabela)**, mostrando a saída da consulta tabular.

Para recuperar o plano de execução da consulta, execute `EXPLAIN ANALYZE` ou `EXPLAIN ANALYZE VERBOSE` para ter insights adicionais sobre a performance da consulta. Para ter mais informações sobre planos de execução, consulte [Ler os planos EXPLAIN do Aurora DSQL](reading-dsql-explain-plans.md).

**dica**  
O comando `EXPLAIN ANALYZE VERBOSE` apresenta estimativas de uso de DPU, como valores de computação, leitura, gravação e total de DPU, e oferece visibilidade imediata dos recursos consumidos por instruções SQL individuais.