Uso del editor de consultas para Aurora Serverless v1 - Amazon Aurora

Uso del editor de consultas para Aurora Serverless v1

Con el editor de consultas para Aurora Serverless v1, puede ejecutar consultas SQL en la consola de RDS. Puede ejecutar cualquier instrucción SQL válida en el clúster de base de datos de Aurora Serverless v1, incluidas las instrucciones de manipulación y de definición de datos.

El editor de consultas requiere un clúster de base de datos de Aurora Serverless v1 con la API de datos habilitada. Para obtener más información acerca de cómo crear un clúster de base de datos de Aurora Serverless v1 con la API de datos habilitada, consulte Uso de la API de datos para Aurora Serverless v1.

Disponibilidad del editor de consultas

El editor de consultas solo está disponible para los siguientes clústeres de base de datos de Aurora Serverless v1:

  • Aurora con compatibilidad con MySQL versión 5.6

  • Aurora con compatibilidad con MySQL versión 5.7

  • Aurora con compatibilidad con PostgreSQL versión 10.7

El editor de consultas está disponible actualmente para Aurora Serverless v1 en las siguientes Regiones de AWS:

  • Este de EE. UU. (Ohio)

  • EE.UU. Este (Norte de Virginia)

  • EE.UU. Oeste (Norte de California)

  • US West (Oregon)

  • Asia Pacific (Mumbai)

  • Asia Pacific (Seoul)

  • Asia Pacífico (Singapur)

  • Asia Pacífico (Sídney)

  • Asia Pacífico (Tokio)

  • Canada (Central)

  • Europe (Frankfurt)

  • Europe (Ireland)

  • Europe (London)

  • Europe (Paris)

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.

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.

{ "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 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 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 Serverless v1 en el editor de consultas.

Para ejecutar una consulta en el editor de consultas

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

  2. En la esquina superior derecha de la AWS Management Console, seleccione la Región de AWS en la que ha creado los clústeres de base de datos de Aurora Serverless v1 en los que desea realizar la consulta.

  3. En el panel de navegación, seleccione Databases (Bases de datos).

  4. Elija el clúster de base de datos de Aurora Serverless v1 en el que desea ejecutar consultas SQL.

  5. 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
  6. Introduzca la información siguiente:

    1. En Database instance or cluster (Clúster o instancia de base de datos), elija el clúster de base de datos de Aurora Serverless v1 en el que desea ejecutar consultas SQL.

    2. 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).

    3. 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.

    4. 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.

    5. 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.

  7. En el editor de consultas, introduzca la consulta SQL que desea ejecutar en la base de datos.

    
                            Editor de consultas

    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

    Se visualizará la ventana Query Editor Settings (Configuración del editor de consultas).

    
                            Configuración del editor de consultas

    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).

  8. Elija Run (Ejecutar) o pulse Ctrl+Intro, 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).