# Conexión a la instancia de base de datos de MariaDB
Después de que Amazon RDS aprovisione una instancia de base de datos, puede usar cualquier utilidad o aplicación cliente estándar de MariaDB para conectarse a la instancia. En la cadena de conexión, especifique la dirección del sistema de nombre de dominio (DNS) del punto de enlace de la instancia de base de datos como el parámetro del host. Especifique también el número de puerto del punto de enlace de la instancia de base de datos como el parámetro del puerto.
Puede conectarse a una instancia de base de datos de Amazon RDS for MariaDB mediante herramientas como la utilidad de línea de comandos de MySQL. Para obtener más información acerca del uso de la utilidad de línea de comandos de MySQL, consulte [mysql command-line client](http://mariadb.com/kb/en/mariadb/mysql-command-line-client/) en la documentación de MariaDB. Heidi 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 HeidiSQL](http://www.heidisql.com/download.php). 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).
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
```
Para conectarse a una instancia de base de datos desde fuera de una nube virtual privada (VPC) basada en Amazon VPC, la instancia de base de datos debe ser accesible públicamente. Además, 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 SSL en las conexiones a una instancia de base de datos de MariaDB. Para obtener información, consulte [Compatibilidad con SSL/TLS para instancias de base de datos de MariaDB en Amazon RDS](MariaDB.Concepts.SSLSupport.md).
Para buscar una instancia de base de datos de RDS para MariaDB y conectarse a ella, consulte los siguientes temas.
**Topics**
+ [Búsqueda de la información de conexión para una instancia de base de datos de MariaDB](USER_ConnectToMariaDBInstance.EndpointAndPort.md)
+ [Conexión desde el cliente de línea de comandos de MySQL (sin cifrar) de RDS para MariaDB](USER_ConnectToMariaDBInstance.CLI.md)
+ [Conexión a RDS para MariaDB con el controlador JDBC de AWS y el controlador Python de AWS;](MariaDB.Connecting.Drivers.md)
+ [Solución de problemas de conexiones a la instancia de base de datos MariaDB](USER_ConnectToMariaDBInstance.Troubleshooting.md)
# Búsqueda de la información de conexión para una instancia de base de datos de MariaDB
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 MariaDB. 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 [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) de la AWS Command Line Interface (AWS CLI) 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 de MariaDB para mostrar 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 MariaDB usando la AWS CLI, ejecute el comando [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=mariadb" \
--query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```
Para Windows:
```
aws rds describe-db-instances ^
--filters "Name=engine,Values=mariadb" ^
--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.
# Conexión desde el cliente de línea de comandos de MySQL (sin cifrar) de RDS para MariaDB
**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 MariaDB en Amazon RDS con SSL/TLS desde el cliente de línea de comandos de MySQL (cifrado)](USER_ConnectToMariaDBInstanceSSL.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 en un equipo cliente. Al hacerlo, se conecta a una base de datos en una instancia de base de datos MariaDB. Sustituya el nombre DNS (punto de enlace) de la instancia de base de datos por *``* y el nombre de usuario maestro que utilizó para *``*. Proporcione la contraseña maestra que utilizó cuando se le solicite una contraseña.
```
mysql -h -P 3306 -u -p
```
Una vez especificada la contraseña del usuario, verá un resultado similar al siguiente.
```
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 31
Server version: 10.6.10-MariaDB-log Source distribution
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]>
```
# Conexión a RDS para MariaDB con el controlador JDBC de AWS y el controlador Python de AWS;
Conéctese a RDS para las instancias de base de datos de MariaDB con el controlador JDBC de AWS y el controlador Python de AWS. Para obtener más información, consulte los siguientes temas.
**Topics**
+ [Conexión a RDS para MariaDB con el controlador JDBC de Amazon Web Services (AWS)](#MariaDB.Connecting.JDBCDriver)
+ [Conexión a RDS para MariaDB con el controlador de Python de Amazon Web Services (AWS)](#MariaDB.Connecting.PythonDriver)
## Conexión a RDS para MariaDB 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 MariaDB 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 de 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).
# Solución de problemas de conexiones a la instancia de base de datos MariaDB
Hay dos causas frecuentes de errores de conexión a una instancia de base de datos nueva:
+ 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 la que se está ejecutando la utilidad o la aplicación de MariaDB. 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).