# Comience a utilizar el editor de consultas de Aurora DSQL
<a name="getting-started-query-editor"></a>

Con el editor de consultas de Aurora DSQL, puede conectarse de forma segura a los clústeres de Aurora DSQL y ejecutar consultas SQL directamente desde la consola de administración de AWS sin instalar ni configurar clientes externos. Proporciona un espacio de trabajo intuitivo con resaltado de sintaxis integrado, autocompletado y asistencia de código inteligente. Puede explorar rápidamente los objetos del esquema, desarrollar y ejecutar consultas SQL y ver los resultados, todo desde una única interfaz.

En este tema se explican los pasos necesarios para conectarse a un clúster, ejecutar consultas, ver los resultados y explorar funciones avanzadas, como los planes de ejecución.

**nota**  
El editor de consultas está disponible en todas las regiones donde sea compatible con Aurora DSQL. Para obtener más información acerca de la disponibilidad regional, consulte [Servicios regionales de AWS](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

## Requisitos previos
<a name="query-editor-prerequisites"></a>

Antes de comenzar, asegúrese de que cumple los siguientes requisitos:
+ Tiene al menos un clúster de Aurora DSQL disponible. Para obtener más información sobre la creación de clústeres, consulte [Paso 1: creación de un clúster de Aurora DSQL de una sola región](getting-started.md#getting-started-create-cluster).
+ El punto de conexión del clúster es de acceso público. Actualmente, el editor de consultas no admite clústeres cuyo acceso público esté bloqueado por políticas basadas en recursos o clústeres administrados a través de puntos de conexión de VPC. Para obtener más información sobre las restricciones de acceso, consulte [Bloqueo de acceso público con políticas basadas en recursos en Aurora DSQL](rbp-block-public-access.md) y [Administración y conexión a clústeres de Amazon Aurora DSQL mediante AWS PrivateLink](privatelink-managing-clusters.md).
+ El usuario o el rol de IAM tiene los permisos necesarios para acceder al clúster y conectarse al mismo. Para obtener más información sobre los permisos, consulte . [Uso de roles de base de datos y autenticación de IAM](using-database-and-iam-roles.md).

## Trabajo con el editor de consultas
<a name="query-editor-working"></a>

### Apertura del editor de consultas
<a name="query-editor-open"></a>

**Apertura del editor de consultas**

1. Abra la [consola de Aurora DSQL](https://console.aws.amazon.com/dsql).

1. En el panel de navegación, elija **Query Editor (Editor de consultas)**.

Como alternativa, en la página **Clústeres**, seleccione el clúster que desee consultar y elija **Conectar con el editor de consultas** para iniciar el editor directamente.

**nota**  
El estado de trabajo y de conexión no se guardan. Si sale de la consola de Aurora DSQL, cierra la pestaña del navegador o cierra sesión, se perderán las conexiones, el texto de la consulta y los resultados.

### Conexión a un clúster
<a name="query-editor-connect"></a>

**Conexión a un clúster**

1. Si no existe ninguna conexión de clúster, el editor muestra **No se ha conectado ningún clúster**. Elija **Conectar** o seleccione **\$1** (Agregar) en el panel **Explorador de clústeres** para conectarse a un clúster existente.

1. (Opcional) Conéctese a varios clústeres o al mismo clúster usando roles diferentes.

### Exploración de objetos de clúster
<a name="query-editor-explore"></a>

El explorador de clústeres muestra todas las conexiones de clústeres disponibles y le permite buscar objetos como bases de datos, esquemas, tablas y vistas. También proporciona acciones comunes como **actualizar**, **crear una tabla** y otras opciones específicas del contexto.

### Ejecución de consultas
<a name="query-editor-run-queries"></a>

**Para ejecutar una consulta**

1. En el panel de pestañas del editor de consultas, ingrese la instrucción SQL. Por ejemplo:

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

1. Compruebe el **contexto de clúster activo** que se muestra en la parte superior derecha de la pestaña de consulta. Esto indica la conexión de clúster asociada a la pestaña de consulta actual.

1. (Opcional) Use el menú desplegable de **conexiones** para revisar todas las conexiones disponibles o cambiar a un clúster diferente. Al cambiar la conexión, se actualiza el lugar donde se ejecutan las consultas en esa pestaña.

1. Seleccione **Ejecutar** para ejecutar la consulta.

**nota**  
Cada consulta puede devolver hasta 10 000 filas en el panel de resultados. Para conjuntos de datos más grandes, ajuste la consulta con filtros o límites.

### Revisión de los resultados y los planes de ejecución
<a name="query-editor-view-results"></a>

Una vez ejecutada la consulta, revise el resultado en el **panel de resultados** situado en la parte inferior del editor. De forma predeterminada, cada ejecución de consulta muestra la pestaña **Resultados (tabla)**, que muestra el resultado de la consulta en forma de tabla.

Para obtener el plan de ejecución de la consulta, ejecute `EXPLAIN ANALYZE` o `EXPLAIN ANALYZE VERBOSE` para obtener información adicional sobre el rendimiento de la consulta. Para obtener más información sobre los planes de ejecución, consulte [Lectura de los planes EXPLAIN de Aurora DSQL](reading-dsql-explain-plans.md).

**sugerencia**  
El comando `EXPLAIN ANALYZE VERBOSE` muestra las estimaciones de uso de la DPU, incluidos los valores de cálculo, lectura, escritura y total de la DPU, lo que proporciona una visibilidad inmediata de los recursos que consumen las instrucciones SQL individuales.