Todos los productos
Search
Centro de documentos

ApsaraDB RDS:Connect to an RDS MySQL instance by CLI or client

Última actualización: Sep 20, 2026

Una vez que crea y configura una instancia de ApsaraDB for RDS for MySQL, puede conectarse a ella. En este tema se describe cómo conectarse a la instancia por red interna o por internet mediante la interfaz de línea de comandos (CLI) o un cliente. También se ofrecen soluciones para los errores de conexión más comunes.

Requisitos previos

Recomendaciones

  • Para obtener menor latencia y mayor estabilidad, conéctese a su instancia de RDS desde una instancia de ECS por red interna. Se deben cumplir las siguientes condiciones para establecer una conexión por red interna:

    La instancia de ECS y la instancia de RDS deben pertenecer a la misma cuenta de Alibaba Cloud, región y Virtual Private Cloud (VPC). La dirección IP privada de la instancia de ECS debe estar added to the IP address whitelist of the RDS instance.

    Nota

    Consulte la dirección IP privada de su instancia de ECS en la página Instances.

    En la columna IP Address de la lista de instancias, las direcciones IP públicas se identifican con "(Public)" y las privadas con "(Private)".

  • Para conectarse por red pública, utilice el endpoint de la base de datos.

    Nota
    • Consulte la dirección IP pública del cliente local con el comando curl ipinfo.io/ip (recomendado) o curl ifconfig.me.

    • La dirección IP pública de la instancia de RDS puede cambiar durante una actualización o migración de la base de datos. Si ya agregó su dirección IP local a la lista blanca pero no logra conectarse, consulte provided solution.

Procedimiento

Conexión mediante la CLI

En este ejemplo se muestra cómo conectarse a una instancia de ApsaraDB for RDS for MySQL en un sistema Linux. Primero, instale MySQL:

  • En CentOS, ejecute sudo yum install mysql.

  • En Ubuntu, ejecute sudo apt-get update y después sudo apt install mysql-server.

  1. Inicie sesión en el servidor que utilizará para conectarse a la instancia de RDS, como una instancia de ECS o un servidor local.

    Nota

    Para conocer las instrucciones sobre cómo iniciar sesión en una instancia de ECS, consulte la sección Connect to an ECS instance en ECS Quick Start.

  2. Ejecute el siguiente comando para conectarse:

    mysql -h<endpoint> -P<port> -u<username> -p
    Nota
    • Introduzca la contraseña después de ejecutar el comando.

    • La letra mayúscula P indica el puerto, mientras que la minúscula p activa la solicitud de contraseña.

    • Endpoint y puerto: corresponden al endpoint y al puerto de la instancia de RDS.

      Escenario

      Endpoint obligatorio

      Cómo obtenerlo

      Cumple con las condiciones para una conexión por red interna.

      Endpoint interno

      1. Inicie sesión en la consola de ApsaraDB RDS y vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. Luego, busque la instancia y haga clic en su ID.

      2. Haga clic en View Details para consultar la dirección y el número de puerto de la instancia de RDS. En la sección Basic Information, junto a Network Type, haga clic en View Connection Details.

      Nota
      • El endpoint público solo se muestra después de hacer clic en Apply for Public Endpoint.

      • En una instancia de RDS Cluster Edition, modifique el endpoint del nodo primario en la sección Cluster Read/Write Connection y el del nodo secundario en la sección Cluster Read-only Connection.

      Se conecta desde una instancia de ECS, pero no cumple con las condiciones para una conexión por red interna.

      Endpoint público

      Se conecta desde un dispositivo local.

    • Nombre de usuario y contraseña: obténgalos en la página Accounts de la instancia de RDS.

    root@xxx            -> mysql -hrxxx.mysql.rds.aliyuncs.com -P3306 -uxxx -p
    Enter password:
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 51325
    Server version: 8.0.18 Source distribution

Conexión con MySQL Workbench

También puede usar otros clientes genéricos de MySQL para conectarse a una instancia de ApsaraDB for RDS for MySQL. En esta sección se toma como ejemplo MySQL Workbench 8.0.29. El procedimiento es similar para otros clientes.

  1. Instale MySQL Workbench.

  2. Abra MySQL Workbench y seleccione Database > Connect to Database.

  3. Introduzca la información de conexión y haga clic en OK.

    En la lista desplegable Connection Method, seleccione Standard (TCP/IP).

    • Hostname y Port: el endpoint y el puerto de la instancia de RDS.

      Escenario

      Endpoint obligatorio

      Cómo obtenerlo

      Cumple con las condiciones para una conexión por red interna.

      Endpoint interno

      1. Inicie sesión en la consola de ApsaraDB RDS y vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. Luego, busque la instancia y haga clic en su ID.

      2. Haga clic en View Details para consultar la dirección y el número de puerto de la instancia de RDS. En la sección Basic Information, junto a Network Type, haga clic en View Connection Details.

      Nota
      • El endpoint público solo se muestra después de hacer clic en Apply for Public Endpoint.

      • En una instancia de RDS Cluster Edition, modifique el endpoint del nodo primario en la sección Cluster Read/Write Connection y el del nodo secundario en la sección Cluster Read-only Connection.

      Se conecta desde una instancia de ECS, pero no cumple con las condiciones para una conexión por red interna.

      Endpoint público

      Se conecta desde un dispositivo local.

    • Username y Password: obténgalos en la página Accounts de la instancia de RDS.

Conexión con Navicat

  1. Inicie el cliente Navicat.

  2. En la barra de herramientas, haga clic en Connection y seleccione el tipo de base de datos.

    Si su cliente Navicat está desactualizado, Alibaba Cloud no aparecerá en la lista. Seleccione un tipo de base de datos como MySQL o PostgreSQL .
  3. Introduzca los detalles de conexión de su instancia de RDS.

    Parameter

    Description

    Example

    Connection Name

    Una etiqueta personalizada para esta conexión

    my-rds-mysql

    Host

    El internal or public endpoint de la instancia de RDS

    rm-bp1xxxxxxxxx.mysql.rds.aliyuncs.com

    Port

    El internal or public port de la instancia de RDS

    3306 (predeterminado para RDS for MySQL)

    User Name

    El nombre de usuario de la cuenta utilizada para conectarse

    rds_user

    Password

    La contraseña de la cuenta utilizada para conectarse

    —

  4. Haga clic en OK.

    Si enhanced whitelist mode está habilitado y se conecta por internet, agregue la dirección IP pública de su dispositivo a la lista blanca de direcciones IP del tipo de red clásica .

Conexión desde ECS entre regiones o cuentas

  • Conexión por red pública (internet): use el endpoint público de la instancia de RDS para conectarse entre regiones o cuentas a través de internet. El tráfico de internet entrante y saliente de la instancia de RDS no tiene costo.

  • Conexión por red interna (red privada): de forma predeterminada, no es posible conectarse por red interna cuando la instancia de ECS y la de RDS residen en distintas regiones o cuentas, ya que las VPC están aisladas entre sí. Sin embargo, puede usar VPC peering o Cloud Enterprise Network (CEN) para conectar dos VPC. De este modo, la instancia de ECS accede a la instancia de RDS entre regiones o cuentas.

    • VPC peering connection: admite la interconexión de VPC entre regiones y cuentas con un costo bajo, aunque su configuración es relativamente compleja. Esta opción es adecuada para escenarios sencillos que involucran pocas VPC interconectadas.

    • CEN: permite la interconexión de VPC entre regiones y cuentas con una configuración sencilla, pero a un costo relativamente mayor. Resulta ideal para escenarios complejos con varias VPC interconectadas.

Errores de conexión comunes

mysql command not found

Este error indica que MySQL no está instalado. Para instalarlo, use uno de los siguientes comandos:

  • En CentOS, ejecute sudo yum install mysql.

  • En Ubuntu, ejecute sudo apt-get update y después sudo apt install mysql-server.

SSL connection error: SSL is required but the server doesn't support it

En algunas versiones de MySQL Workbench, una conexión Standard TCP/IP requiere cifrado SSL. La versión de MySQL Workbench mencionada en este tema permite conexiones sin SSL.

Error 10060: Can't connect to MySQL server on 'rm-bpxxx.mysql.rds.aliyuncs.com'(10060)

  • (Causa más común) La lista blanca de direcciones IP de la instancia de RDS está configurada de forma incorrecta. Por lo general, esto significa que la dirección IP del cliente no se ha agregado a la lista blanca.

    Solución: compruebe y configure correctamente configure the IP address whitelist. Si se conecta desde un cliente local, ejecute curl ipinfo.io/ip para obtener la dirección IP pública de su cliente local y agréguela a la lista blanca.

  • En casos poco frecuentes, se utiliza una dirección de red interna para conectarse sin cumplir con internal network connection requirements.

    Solución: Apply for a public endpoint y úselo para conectarse.

Error 113: Can't connect to MySQL server on 'rm-bpxxx.mysql.rds.aliyuncs.com'(113)

Se produjo un conflicto de rutas. Para obtener más información, consulte How to resolve the issue of being unable to ping the internal endpoint of an RDS instance.

Cannot Connect to Database Server

Your connection attempt failed for user 'xx" to the MySQL server

Pinging the internal endpoint of an RDS instance returns a "Destination Host Unreachable" error.

Se produjo un conflicto de rutas. Para obtener más información, consulte How to resolve the issue of being unable to ping the internal endpoint of an RDS instance.

Access denied for user 'xxx'@'xxx'(using password:YES)

El nombre de usuario o la contraseña introducidos son incorrectos. Gestione las cuentas y contraseñas de la base de datos en la página Accounts de la instancia de RDS.

Unknown MySQL server host 'xxx'(11001)

El endpoint de la instancia de RDS introducido es incorrecto. El formato correcto es rm-xxxxxx.mysql.rds.aliyuncs.com.

Preguntas frecuentes

  • P: ¿Las instancias de ApsaraDB for RDS for MySQL admiten Elastic IP Addresses (EIP)?

    R: No, actualmente esta función no es compatible.

  • P: ¿Cómo resuelvo un error de conexión Telnet desde mi computadora local a la instancia de RDS?

    R: Si no logra conectarse a la instancia de RDS mediante Telnet, compruebe lo siguiente:

    • Compruebe que el puerto de servicio de la base de datos en la nube sea correcto y esté abierto a internet.

    • Revise las reglas del security group o del firewall de la base de datos en la nube para asegurarse de que su dirección IP local tenga permiso de conexión.

    • Verifique que los parámetros de conexión, como el nombre del host y el número de puerto, sean correctos.

    • Revise las reglas del firewall en su dispositivo local para asegurarse de que el puerto que requiere RDS no esté bloqueado.

    • Si es posible, intente conectarse a la base de datos en la nube con otras herramientas, como la CLI de mysql o una herramienta de administración de bases de datos, para descartar problemas específicos de Telnet.

  • P: ¿Cómo pueden acceder otros usuarios a mi base de datos?

    R: Siga estos pasos:

    1. Create a standard account y otórguele permisos sobre la base de datos.

    2. Apply for a public endpoint.

    3. Configure an IP address whitelist. Si el otro usuario emplea una instancia de ECS, agregue la dirección IP privada o el ID del security group de dicha instancia. Si utiliza un cliente MySQL local, agregue la dirección IP pública de su host.

    4. Comparta con el usuario el endpoint público, el nombre de la base de datos y las credenciales de la cuenta.

    5. Después, el usuario podrá connect to the database by using the CLI.

Referencias