# Conexión a la instancia de base de datos de MySQL Antes de conectar a una instancia de base de datos que ejecute el motor de base de datos MySQL, debe crear a una instancia de base de datos. Para obtener información, consulte [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md). Después de que Amazon RDS aprovisione una instancia de base de datos, puede usar cualquier utilidad o aplicación cliente estándar de MySQL para conectarse a la instancia. En la cadena de conexión, especifique la dirección DNS del punto de enlace de la instancia de base de datos como parámetro del host y especifique el número de puerto del punto de enlace de la instancia de base de datos como parámetro del puerto. Para autenticarse en la instancia de base de datos de RDS, puede usar uno de los métodos de autenticación de MySQL y la autenticación de base de datos AWS Identity and Access Management (IAM). + Para conocer el procedimiento para autenticarse en MySQL usando uno de los métodos de autenticación de MySQL, consulte [Authentication Method](https://dev.mysql.com/doc/internals/en/authentication-method.html) en la documentación de MySQL. + Para conocer el procedimiento de autenticación en MySQL mediante la autenticación de base de datos de IAM, consulte [Autenticación de bases de datos de IAM para MariaDB, MySQL, and PostgreSQL](UsingWithRDS.IAMDBAuth.md). Puede conectarse a una instancia de base de datos de MySQL con herramientas como la utilidad de línea de comandos de MySQL. Para obtener más información sobre el uso de la utilidad de línea de comandos d MySQL, consulte [mysql - the MySQL command-line client](https://dev.mysql.com/doc/refman/8.0/en/mysql.html) en la documentación de MySQL. MySQL Workbench es una de las aplicaciones basadas en interfaz gráfica de usuario (GUI) que puede utilizar para conectarse. Para obtener más información, consulte la página [Download MySQL Workbench](http://dev.mysql.com/downloads/workbench/). Para obtener información sobre la instalación de MySQL (incluida la utilidad de línea de comandos de MySQL), consulte [Installing and upgrading MySQL (Instalación y actualización de MySQL)](https://dev.mysql.com/doc/refman/8.0/en/installing.html). Para conectarse a una instancia de base de datos desde fuera de su Amazon VPC, la instancia de base de datos debe ser accesible públicamente, el acceso debe concederse mediante las reglas entrantes del grupo de seguridad de la instancia de base de datos y deben cumplirse otros requisitos. Para obtener más información, consulte [No puede conectarse a la instancia de base de datos de Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting). Puede utilizar el cifrado de la capa de sockets seguros (SSL) o de la seguridad de la capa de transporte (TLS) en las conexiones a una instancia de base de datos MySQL. Para obtener más información, consulta [Compatibilidad de SSL/TLS con instancias de bases de datos de MySQL en Amazon RDS](MySQL.Concepts.SSLSupport.md). Si está utilizando la autenticación de base de datos AWS Identity and Access Management (IAM), asegúrese de utilizar una conexión SSL/TLS. Para obtener información, consulte [Autenticación de bases de datos de IAM para MariaDB, MySQL, and PostgreSQL](UsingWithRDS.IAMDBAuth.md). También puede conectarse a una instancia de base de datos desde un servidor web. Para obtener más información, consulte [Explicación: crear un servidor web y una instancia de base de datos de Amazon RDS](TUT_WebAppWithRDS.md). **nota** Para obtener más información acerca de la conexión a una instancia de base de datos de MariaDB, consulte [Conexión a la instancia de base de datos de MariaDB](USER_ConnectToMariaDBInstance.md). Para buscar una instancia de base de datos de RDS para MySQL y conectarse a ella, consulte los temas siguientes. **Topics** + [Búsqueda de información de conexión para una instancia de base de datos RDS para MySQL](USER_ConnectToInstance.EndpointAndPort.md) + [Instalación de cliente de línea de comandos de MySQL](mysql-install-cli.md) + [Conexión desde la utilidad de línea de comandos de MySQL (sin cifrar)](USER_ConnectToInstance.CLI.md) + [Conexión desde MySQL Workbench](USER_ConnectToInstance.MySQLWorkbench.md) + [Conexión a RDS para MySQL con el controlador JDBC de AWS, el controlador Python de AWS y el controlador ODBC de AWS para MySQL](MySQL.Connecting.Drivers.md) + [Solución de problemas de conexiones a la instancia de base de datos MySQL](USER_ConnectToInstance.Troubleshooting.md) # Búsqueda de información de conexión para una instancia de base de datos RDS para MySQL La información de conexión de una instancia de base de datos incluye su punto de enlace, puerto y un usuario de base de datos válido, como el usuario maestro. Por ejemplo, supongamos que un valor de punto de enlace es `mydb.123456789012.us-east-1.rds.amazonaws.com`. En este caso, el valor del puerto es `3306` y el usuario de la base de datos es `admin`. Dada esta información, se especifican los siguientes valores en una cadena de conexión: + Para nombre de host o host o nombre DNS, especifique `mydb.123456789012.us-east-1.rds.amazonaws.com`. + Para el puerto, especifique `3306`. + Para el usuario, especifique `admin`. Para conectarse a una instancia de base de datos, utilice cualquier cliente para un motor de base de datos de MySQL. Por ejemplo, puede usar la utilidad de línea de comandos de MySQL o MySQL Workbench. Para buscar la información de conexión de una instancia de base de datos, puede utilizar la Consola de administración de AWS, el comando de AWS CLI [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) o la operación de la API de Amazon RDS [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) para enumerar sus detalles. ## Consola **Para buscar la información de conexión para una instancia de base de datos en Consola de administración de AWS** 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 el panel de navegación, elija **Databases (Bases de datos)** para ver una lista de las instancias de base de datos. 1. Seleccione el nombre de la instancia de base de datos MySQL para ver sus detalles. 1. En la pestaña **Connectivity & security (Conectividad y seguridad)**, copie el punto de enlace. También anote el número de puerto. Necesita el punto de enlace y el número de puerto para conectarse a la instancia de base de datos. ![\[El punto de conexión y el puerto de una instancia de base de datos en la consola de Amazon RDS.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/endpoint-port.png) 1. Si necesita encontrar el nombre de usuario maestro, elija la ficha **Configuration (Configuración)** y vea el valor de **Master username (Nombre de usuario maestro)** . ## AWS CLI Para encontrar la información de conexión para una instancia de base de datos MySQL llame el AWS CLIcomando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). En la llamada, consulte el ID de instancia de base de datos, el punto de enlace, el puerto y el nombre de usuario maestro. Para Linux, macOS o Unix: ``` aws rds describe-db-instances \ --filters "Name=engine,Values=mysql" \ --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]" ``` Para Windows: ``` aws rds describe-db-instances ^ --filters "Name=engine,Values=mysql" ^ --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]" ``` El resultado debería ser similar al siguiente. ``` [ [ "mydb1", "mydb1.123456789012.us-east-1.rds.amazonaws.com", 3306, "admin" ], [ "mydb2", "mydb2.123456789012.us-east-1.rds.amazonaws.com", 3306, "admin" ] ] ``` ## API de RDS Para buscar la información de conexión de una instancia de base de datos mediante la API Amazon RDS, llame a la operación [DescribedBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) . En el resultado, busque los valores de la dirección del punto de enlace, el puerto del punto de enlace y el nombre de usuario maestro. # Instalación de cliente de línea de comandos de MySQL La mayoría de las distribuciones de Linux incluyen el cliente MariaDB en lugar del cliente Oracle MySQL. Para instalar el cliente de línea de comandos de MySQL en Amazon Linux 2023, ejecute el siguiente comando: ``` sudo dnf install mariadb105 ``` Para instalar el cliente de línea de comandos de MySQL en Amazon Linux 2, ejecute el siguiente comando: ``` sudo yum install mariadb ``` Para instalar la utilidad de línea de comandos de MySQL en la mayoría de las distribuciones Linux basadas en DEB, ejecute el siguiente comando: ``` apt-get install mariadb-client ``` Para verificar la versión de la utilidad de línea de comandos de MySQL, ejecute el siguiente comando: ``` mysql --version ``` Para leer la documentación de MySQL de la versión actual del cliente, ejecute el siguiente comando: ``` man mysql ``` # Conexión desde la utilidad de línea de comandos de MySQL (sin cifrar) **importante** Utilice sólo una conexión MySQL sin cifrar cuando el cliente y el servidor están en la misma VPC y la red es de confianza. Para obtener información sobre el uso de de conexiones cifradas, consulte [Conexión a la instancia de base de datos de MySQL en Amazon RDS con SSL/TLS desde el cliente de línea de comandos de MySQL (cifrado)](USER_ConnectToInstanceSSL.CLI.md). Para conectarse a una instancia de base de datos mediante la utilidad de línea de comandos de MySQL, ingrese el siguiente comando en un símbolo del sistema. Para el parámetro -h, escriba el nombre de DNS (punto de enlace) de la instancia de base de datos. Para el parámetro -P, utilice el puerto de la instancia de base de datos. Para el parámetro -u, sustituya el nombre de usuario de un usuario de base de datos válido, como el usuario maestro. Escriba la contraseña del usuario maestro cuando se le pida. ``` mysql -h mysql–instance1.123456789012.us-east-1.rds.amazonaws.com -P 3306 -u mymasteruser -p ``` Una vez especificada la contraseña del usuario, debería ver un resultado similar al siguiente. ``` Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 9738 Server version: 8.0.28 Source distribution Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> ``` # Conexión desde MySQL Workbench **Para conectar desde MySQL Workbench** 1. Descargue e instale MySQL Workbench en [Download MySQL Workbench (Descargar MySQL Workbench)](http://dev.mysql.com/downloads/workbench/). 1. Abra MySQL Workbench. ![\[La pantalla de bienvenida de MySQL Workbench.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/mysql-workbench-main.png) 1. En **Database (Base de datos)**, elija **Manage Connections (Administrar conexiones)**. 1. En la ventana **Manage Server Connections (Administrar conexiones de servidores) **, elija **New (Nueva)**. 1. En la ventana **Connect to Database (Conectar a base de datos)**, introduzca la información siguiente: + **Stored Connection (Conexión almacenada)**: escriba un nombre para la conexión, como por ejemplo **MyDB**. + **Hostname (Nombre de host)**: escriba el punto de enlace de instancia de base de datos. + **Port (Puerto)**: escriba el puerto utilizado por la instancia de base de datos. + **Username (Nombre de usuario)**–: escriba el nombre de usuario de base de datos válido, como el usuario maestro. + **Password (Contraseña)**: opcionalmente, elija **Store in Vault (Guardar en almacén)** y escriba y guarde la contraseña del usuario. La ventana tendrá un aspecto similar al siguiente. ![\[La ventana Manage Server Connections en MySQL Workbench.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/mysql-workbench-connect.png) Puede utilizar las características de MySQL Workbench para personalizar las conexiones. Por ejemplo, puede utilizar la pestaña **SSL** para configurar las conexiones SSL/TLS. Para obtener información sobre el uso de MySQL Workbench, consulte la [documentación de MySQL Workbench](https://dev.mysql.com/doc/workbench/en/). Cifrado de conexiones de cliente con las instancias de base de datos MySQL con SSL/TLS; consulte [Cifrado de conexiones de cliente con SSL/TLS a instancias de base de datos de MySQL en Amazon RDS](mysql-ssl-connections.md). 1. Opcionalmente, elija **Test Connection (Conexión de prueba)** para confirmar que la conexión a la instancia de base de datos es correcta. 1. Elija **Close**. 1. En **Database (Base de datos)**, elija **Connect to Database (Conectar a base de datos)**. 1. En **Stored Connection (Conexión almacenada)**, elija la conexión. 1. Seleccione **OK**. # Conexión a RDS para MySQL con el controlador JDBC de AWS, el controlador Python de AWS y el controlador ODBC de AWS para MySQL Conéctese a las instancias de bases de datos de RDS para MySQL con el controlador JDBC de AWS, el controlador Python de AWS y el controlador ODBC de AWS para MySQL. Para obtener más información, consulte los siguientes temas. **Topics** + [Conexión a RDS para MySQL con el controlador JDBC de Amazon Web Services (AWS)](#MySQL.Connecting.JDBCDriver) + [Conexión a RDS para MySQL con el controlador de Python de Amazon Web Services (AWS)](#MySQL.Connecting.PythonDriver) + [Conexión a RDS para MySQL con el controlador ODBC de Amazon Web Services (AWS) para MySQL](#USER_ConnectToInstance.ODBCDriverMySQL) ## Conexión a RDS para MySQL con el controlador JDBC de Amazon Web Services (AWS) El controlador JDBC de Amazon Web Services (AWS) se ha diseñado como un contenedor JDBC avanzado. Este contenedor complementa y amplía la funcionalidad del controlador JDBC existente. El controlador se admite con el controlador Connector/J de la comunidad MySQL y el controlador Connector/J de la comunidad MariaDB. Para instalar el controlador JDBC de AWS, añada el archivo .jar del controlador JDBC de AWS (ubicado en la aplicación `CLASSPATH`) y conserve las referencias al controlador de la comunidad correspondiente. Actualice el prefijo de la URL de conexión correspondiente de la siguiente manera: + `jdbc:mysql://` De a `jdbc:aws-wrapper:mysql://` + `jdbc:mariadb://` De a `jdbc:aws-wrapper:mariadb://` Para obtener más información sobre el controlador JDBC de AWS e instrucciones completas para utilizarlo, consulte el repositorio GitHub del controlador JDBC de [Amazon Web Services (AWS)](https://github.com/awslabs/aws-advanced-jdbc-wrapper). ## Conexión a RDS para MySQL con el controlador de Python de Amazon Web Services (AWS) El controlador de Python de Amazon Web Services (AWS) se ha diseñado como un contenedor Python avanzado. Este contenedor complementa y amplía la funcionalidad del controlador de Psycopg de código abierto. El controlador de Python de AWS se admite con las versiones 3.8 y posteriores de Python. Puede instalar el paquete de `aws-advanced-python-wrapper` mediante el comando `pip`, junto con los paquetes de código abierto de `psycopg`. Para obtener más información sobre el controlador de Python de AWS e instrucciones completas para utilizarlo, consulte el repositorio GitHub del controlador de Python de [Amazon Web Services (AWS)](https://github.com/awslabs/aws-advanced-python-wrapper). ## Conexión a RDS para MySQL con el controlador ODBC de Amazon Web Services (AWS) para MySQL El controlador ODBC de AWS para MySQL es un controlador de cliente diseñado para la alta disponibilidad de RDS para MySQL. El controlador puede existir junto con el conector MySQL/controlador ODBC y es compatible con los mismos flujos de trabajo. Para obtener más información sobre el controlador ODBC de AWS para MySQL e instrucciones completas para instalarlo y utilizarlo, consulte el repositorio GitHub del [controlador ODBC de Amazon Web Services (AWS) para MySQL](https://github.com/aws/aws-mysql-odbc). # Solución de problemas de conexiones a la instancia de base de datos MySQL Hay dos causas frecuentes de errores de conexión a una nueva instancia de base de datos: + La instancia de base de datos se creó usando un grupo de seguridad que no autoriza las conexiones desde el dispositivo o la instancia Amazon EC2 en los que se está ejecutando la utilidad o la aplicación de MySQL. La instancia de base de datos debe tener un grupo de seguridad de VPC que autorice las conexiones. Para obtener más información, consulte [VPC de Amazon y Amazon RDS](USER_VPC.md). Puede añadir o editar una regla de entrada en el grupo de seguridad. Para **Source (Origen)**, elija **My IP (Mi IP)**. Esto permite el acceso a la instancia de base de datos desde la dirección IP detectada en su navegador. + La instancia de base de datos se creó con el puerto predeterminado 3306, y su compañía tiene reglas de firewall que bloquean las conexiones a ese puerto desde los dispositivos de la red de la organización. Para solucionar este error, vuelva a crear la instancia con un puerto diferente. Para obtener más información sobre problemas de conexión, consulte [No puede conectarse a la instancia de base de datos de Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).