# Uso del editor de consultas de Aurora El editor de consultas de Aurora le permite ejecutar instrucciones SQL en su clúster de base de datos de Aurora a través de la Consola de administración de AWS. Puede ejecutar consultas SQL, instrucciones de manipulación de datos (DML) e instrucciones de definición de datos (DDL). El uso de la interfaz de la consola le permite realizar el mantenimiento de la base de datos, generar informes y realizar experimentos de SQL. Puede evitar configurar la red para conectarse al clúster de base de datos desde un sistema cliente independiente, como una instancia EC2 o un ordenador portátil. El editor de consultas requiere un clúster de base de datos de Aurora con la API de datos de RDS (API de datos) habilitada. Para obtener información sobre los clústeres de bases de datos que admiten la API de datos y cómo habilitarla, consulte [Uso de la API de datos de Amazon RDS](data-api.md). El SQL que puede ejecutar está sujeto a las limitaciones de la API de datos. Para obtener más información, consulte [Limitaciones de la API de datos de Amazon RDS](data-api.limitations.md). ## Disponibilidad del editor de consultas El editor de consultas está disponible para clústeres de bases de datos de Aurora en los que se utilicen versiones del motor de Aurora MySQL y Aurora PostgreSQL compatibles con la API de datos, y en las Regiones de AWS en las que la API de datos esté disponible. Para obtener más información, consulte [Regiones y motores de base de datos Aurora admitidos para API de datos de RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md). ## Autorizar el acceso al editor de consultas Para ejecutar consultas en el editor de consultas, el usuario debe estar autorizado. Puede autorizar a un usuario para que ejecute consultas en el editor de consultas agregando la política `AmazonRDSDataFullAccess`, una política de AWS Identity and Access Management (IAM) predefinida, a dicho usuario. **nota** Asegúrese de utilizar el mismo nombre de usuario y la misma contraseña al crear el usuario de IAM que para el usuario de la base de datos, como el nombre de usuario y la contraseña administrativos. Para obtener más información, consulte [Creación de un usuario de IAM en su Cuenta de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) en la *AWS Identity and Access ManagementGuía del usuario de *. También puede crear una política de IAM que conceda acceso al editor de consultas. Tras crear la política, añádala a cada usuario que necesite acceder al editor de consultas. La siguiente política proporciona los permisos mínimos necesarios para que un usuario acceda al editor de consultas. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "QueryEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "secretsmanager:PutResourcePolicy", "secretsmanager:PutSecretValue", "secretsmanager:DeleteSecret", "secretsmanager:DescribeSecret", "secretsmanager:TagResource" ], "Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*" }, { "Sid": "QueryEditor1", "Effect": "Allow", "Action": [ "secretsmanager:GetRandomPassword", "tag:GetResources", "secretsmanager:CreateSecret", "secretsmanager:ListSecrets", "dbqms:CreateFavoriteQuery", "dbqms:DescribeFavoriteQueries", "dbqms:UpdateFavoriteQuery", "dbqms:DeleteFavoriteQueries", "dbqms:GetQueryString", "dbqms:CreateQueryHistory", "dbqms:UpdateQueryHistory", "dbqms:DeleteQueryHistory", "dbqms:DescribeQueryHistory", "rds-data:BatchExecuteStatement", "rds-data:BeginTransaction", "rds-data:CommitTransaction", "rds-data:ExecuteStatement", "rds-data:RollbackTransaction" ], "Resource": "*" } ] } ``` ------ Para obtener más información acerca de cómo crear una política de IAM, consulte [Creación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) en la *Guía del usuario de AWS Identity and Access Management*. Para obtener información sobre cómo agregar una política de IAM a un usuario, consulte [Adición y eliminación de permisos de identidad de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) en la *Guía del usuario de AWS Identity and Access Management*. ## Ejecución de consultas en el editor de consultas Puede ejecutar instrucciones SQL en un clúster de base de datos de Aurora en el editor de consultas. El SQL que puede ejecutar está sujeto a las limitaciones de la API de datos. Para obtener más información, consulte [Limitaciones de la API de datos de Amazon RDS](data-api.limitations.md). **Para ejecutar una consulta en el editor de consultas** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. En la esquina superior derecha de la Consola de administración de AWS, seleccione la Región de AWS en la que ha creado los clústeres de base de datos de Aurora en los que desea realizar la consulta. 1. En el panel de navegación, elija **Databases** (Bases de datos). 1. Elija el clúster de base de datos de Aurora en el que desea ejecutar consultas SQL. 1. En **Actions (Acciones)**, seleccione **Query (Consultar)**. Si no se ha conectado aún a la base de datos, se abrirá la página **Connect to database (Conectar a la base de datos)**. ![\[Página de conexión a base de datos del editor de consultas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png) 1. Introduzca la información siguiente: 1. En **Clúster o instancia de base de datos**, elija el clúster de base de datos de Aurora en el que desea ejecutar consultas SQL. 1. En **Database username (Nombre de usuario de base de datos)**, seleccione el nombre de usuario del usuario de la base de datos al que conectarse o elija **Add new database credentials (Añadir nuevas credenciales de base de datos)**. Si elige **Add new database credentials (Añadir nuevas credenciales de base de datos)**, especifique el nombre de usuario de las nuevas credenciales de base de datos en **Enter database username (Introducir nombre de usuario de base de datos)**. 1. En **Enter database password (Introducir contraseña de base de datos)**, escriba la contraseña para el usuario de la base de datos que ha elegido. 1. En la última casilla, introduzca el nombre de la base de datos o esquema que quiera usar para el clúster de base de datos de Aurora. 1. Seleccione **Connect to database (Conectar a base de datos)**. **nota** Si su conexión se establece correctamente, la información de conexión y autenticación se almacenará en AWS Secrets Manager. No tendrá que volver a introducir la información de conexión de nuevo. 1. En el editor de consultas, introduzca la consulta SQL que desea ejecutar en la base de datos. ![\[Editor de consultas con una instrucción SQL en el área de texto\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png) Cada instrucción SQL puede confirmarse automáticamente, o bien puede ejecutar instrucciones SQL en un script, como parte de una transacción. Para controlar este comportamiento, seleccione el icono de engranaje que se encuentra en la ventana de consulta. ![\[Icono de engranaje en el editor de consultas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png) Se visualizará la ventana **Query Editor Settings (Configuración del editor de consultas)**. ![\[Configuración del editor de consultas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png) Si elige **Auto-commit (Confirmación automática)**, todas las instrucciones SQL se confirmarán automáticamente. Si elige **Transacción**, puede ejecutar un grupo de sentencias en un script. Las instrucciones se confirman automáticamente al final del script a menos que se hayan confirmado explícitamente o se hayan revertido con anterioridad. Por otra parte, puede elegir parar un script que se está ejecutando si se produce un error, habilitando **Stop on error (Parar al producirse un error)**. **nota** En un grupo de instrucciones, las instrucciones de lenguaje de definición de datos (DDL) pueden hacer que las instrucciones de lenguaje de manipulación de datos (DML) anteriores se confirmen. También puede incluir instrucciones `COMMIT` y `ROLLBACK` en un grupo de instrucciones de un script. Después de elegir las opciones en la ventana **Query Editor Settings (Configuración del editor de consultas)**, elija **Save (Guardar)**. 1. Elija **Run (Ejecutar)** o pulse Ctrl\$1Intro, y el editor de consultas mostrará los resultados de su consulta. Tras ejecutar la consulta, guárdela en **Saved queries (Consultas guardadas)** seleccionando **Save (Guardar)**. Exporte los resultados de la consulta al formato de hoja de cálculo seleccionando **Export to csv (Exportar a csv)**. Puede encontrar, editar y volver a ejecutar consultas anteriores. Para ello, seleccione la pestaña **Recent (Reciente)** o la pestaña **Saved queries (Consultas guardadas)**, seleccione el texto de la consulta y después elija **Run (Ejecutar)**. Para cambiar la base de datos, elija **Change database (Cambiar base de datos)**. # Referencia de la API de Database Query Metadata Service (DBQMS) El Database Query Metadata Service (`dbqms`) es un servicio únicamente interno. Proporciona sus consultas recientes y guardadas para el editor de consultas en la Consola de administración de AWS para varios servicios de la AWS, incluido Amazon RDS. **Topics** + [CreateAvoriteQuery](#CreateFavoriteQuery) + [CreateQueryHistory](#CreateQueryHistory) + [CreateTab](#CreateTab) + [DeleteFavoritequeries](#DeleteFavoriteQueries) + [DeletEqueryHistory](#DeleteQueryHistory) + [Deletetab](#DeleteTab) + [DescribeFavoritequeries](#DescribeFavoriteQueries) + [DescribeQueryHistory](#DescribeQueryHistory) + [DescribeABS](#DescribeTabs) + [GetQueryString](#GetQueryString) + [UpdateFavoriteQuery](#UpdateFavoriteQuery) + [UpdateQueryHistory](#UpdateQueryHistory) + [UpdateTab](#UpdateTab) ## CreateAvoriteQuery Guarde una nueva consulta favorita. Cada usuario puede crear hasta 1000 consultas guardadas. Este límite está sujeto a cambios en el futuro. ## CreateQueryHistory Guarde una nueva entrada del historial de consultas. ## CreateTab Guarde una nueva pestaña de consulta. Cada usuario puede crear hasta 10 pestañas de consulta. ## DeleteFavoritequeries Elimine una o más consultas guardadas. ## DeletEqueryHistory Elimine las entradas del historial de consultas. ## Deletetab Elimine las entradas de la ficha de consulta. ## DescribeFavoritequeries Lista de las consultas guardadas creadas por un usuario en una cuenta determinada. ## DescribeQueryHistory Lista de las entradas del historial de consultas. ## DescribeABS Lista de las pestañas de consulta creadas por un usuario en una cuenta determinada. ## GetQueryString Recupere el texto completo de la consulta de un ID de consulta. ## UpdateFavoriteQuery Actualice la cadena de consulta, la descripción, el nombre o la fecha de caducidad. ## UpdateQueryHistory Actualice el estado del historial de consultas. ## UpdateTab Actualice el nombre de la ficha de consulta y la cadena de consulta.