Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 20, 2026

Após criar e configurar uma instância ApsaraDB for RDS for MySQL, você pode se conectar a ela. Este tópico descreve como conectar à instância por uma rede interna ou pela internet usando a interface de linha de comando (CLI) ou um client, e apresenta soluções para erros de conexão comuns.

Pré-requisitos

Recomendações

  • Para menor latência e maior estabilidade, conecte sua instância RDS a partir de uma instância ECS usando a rede interna. As seguintes condições devem ser atendidas para uma conexão por rede interna:

    A instância ECS e a instância RDS devem estar na mesma conta Alibaba Cloud, na mesma região e no mesmo Virtual Private Cloud (VPC). O endereço IP privado da instância ECS deve estar added to the IP address whitelist of the RDS instance.

    Nota

    Para consultar o endereço IP privado da sua instância ECS, acesse a página Instances.

    Na coluna IP Address da lista de instâncias, um endereço IP público é marcado com "(Public)" e um endereço IP privado é marcado com "(Private)".

  • Para conexões por rede pública, conecte-se ao banco de dados usando o endpoint correspondente.

    Nota
    • Consulte o endereço IP público do client local executando curl ipinfo.io/ip (recomendado) ou curl ifconfig.me.

    • O endereço IP público da instância RDS pode ser alterado durante um upgrade ou migração do banco de dados. Se você adicionou seu endereço IP local à lista de permissões e ainda não consegue conectar, consulte a provided solution.

Procedimento

Connect with the CLI

Este exemplo demonstra como conectar a uma instância ApsaraDB for RDS for MySQL em um sistema Linux. Primeiro, instale o MySQL:

  • No CentOS, execute sudo yum install mysql.

  • No Ubuntu, execute sudo apt-get update e, em seguida, execute sudo apt install mysql-server.

  1. Faça login no servidor que você usará para conectar à instância RDS, como uma instância ECS ou um servidor local.

    Nota

    Para instruções sobre como fazer login em uma instância ECS, consulte a seção Connect to an ECS instance em ECS Quick Start.

  2. Execute o seguinte comando para conectar:

    mysql -h<endpoint> -P<port> -u<username> -p
    Nota
    • Insira a senha após executar o comando.

    • A letra maiúscula P especifica a porta, e a letra minúscula p indica o prompt de senha.

    • Endpoint e porta: o endpoint e a porta da instância RDS.

      Cenário

      Endpoint necessário

      Como obter

      As condições para conexão por rede interna são atendidas.

      Endpoint interno

      1. Faça login no console do ApsaraDB RDS e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS reside. Em seguida, localize a instância RDS e clique no ID da instância.

      2. Clique em View Details para visualizar o endereço e o número de porta da instância RDS. Na seção Basic Information, ao lado de Network Type, clique em View Connection Details.

      Nota
      • O endpoint público é exibido somente após clicar em Apply for Public Endpoint.

      • Para uma instância RDS Cluster Edition, é possível modificar o endpoint do nó primário na seção Cluster Read/Write Connection e o endpoint do nó secundário na seção Cluster Read-only Connection.

      A conexão parte de uma instância ECS, mas as condições para rede interna não são atendidas.

      Endpoint público

      A conexão parte de um dispositivo local.

    • Nome de usuário e senha: obtenha-os na página Accounts da instância 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

Connect with MySQL Workbench

Você pode usar outros clients MySQL de propósito geral para conectar a uma instância ApsaraDB for RDS for MySQL. Esta seção usa o MySQL Workbench 8.0.29 como exemplo. O procedimento é semelhante para outros clients.

  1. Instale o MySQL Workbench.

  2. Abra o MySQL Workbench e escolha Database > Connect to Database.

  3. Insira as informações de conexão e clique em OK.

    Na lista suspensa Connection Method, selecione Standard (TCP/IP).

    • Hostname e Port: o endpoint e a porta da instância RDS.

      Cenário

      Endpoint necessário

      Como obter

      As condições para conexão por rede interna são atendidas.

      Endpoint interno

      1. Faça login no console do ApsaraDB RDS e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS reside. Em seguida, localize a instância RDS e clique no ID da instância.

      2. Clique em View Details para visualizar o endereço e o número de porta da instância RDS. Na seção Basic Information, ao lado de Network Type, clique em View Connection Details.

      Nota
      • O endpoint público é exibido somente após clicar em Apply for Public Endpoint.

      • Para uma instância RDS Cluster Edition, é possível modificar o endpoint do nó primário na seção Cluster Read/Write Connection e o endpoint do nó secundário na seção Cluster Read-only Connection.

      A conexão parte de uma instância ECS, mas as condições para rede interna não são atendidas.

      Endpoint público

      A conexão parte de um dispositivo local.

    • Username e Password: obtenha-os na página Accounts da instância RDS.

Connect with Navicat

  1. Inicie o client Navicat.

  2. Na barra de ferramentas, clique em Connection e selecione o tipo de banco de dados.

    Se o seu client Navicat estiver desatualizado, Alibaba Cloud não será exibido. Selecione um tipo de banco de dados como MySQL ou PostgreSQL .
  3. Insira os detalhes de conexão da sua instância RDS.

    Parâmetro

    Descrição

    Exemplo

    Connection Name

    Rótulo personalizado para esta conexão

    my-rds-mysql

    Host

    O internal or public endpoint da instância RDS

    rm-bp1xxxxxxxxx.mysql.rds.aliyuncs.com

    Port

    A internal or public port da instância RDS

    3306 (padrão para RDS for MySQL)

    User Name

    O nome de usuário da conta usada para conectar

    rds_user

    Password

    A senha da conta usada para conectar

  4. Clique em OK.

    Se o enhanced whitelist mode estiver ativo e você estiver conectando pela internet, adicione o endereço IP público do seu dispositivo à IP address whitelist of the classic network type .

Conectar a partir do ECS entre regiões ou contas

  • Conexão por rede pública (internet): Use o endpoint público da instância RDS para conectar entre regiões ou contas pela internet. O tráfego de entrada e saída pela internet na instância RDS não tem custo adicional.

  • Conexão por rede interna (rede privada): Por padrão, não é possível conectar por rede interna quando a instância ECS e a instância RDS estão em regiões ou contas diferentes, pois os VPCs são isolados entre si. No entanto, é possível usar VPC peering ou Cloud Enterprise Network (CEN) para interligar dois VPCs, permitindo que a instância ECS acesse a instância RDS entre regiões ou contas.

    • VPC peering connection: Oferece suporte à interconexão de VPC entre regiões e contas a baixo custo, mas exige configuração relativamente complexa. Mais indicado para cenários simples com um número reduzido de VPCs interconectados.

    • CEN: Oferece suporte à interconexão de VPC entre regiões e contas com configuração simplificada, porém com custo relativamente mais elevado. Indicado para cenários complexos que envolvem múltiplos VPCs interconectados.

Erros de conexão comuns

mysql command not found

Este erro indica que o MySQL não está instalado. Para instalá-lo, use um dos seguintes comandos:

  • No CentOS, execute sudo yum install mysql.

  • No Ubuntu, execute sudo apt-get update e, em seguida, execute sudo apt install mysql-server.

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

Ao usar algumas versões do MySQL Workbench, uma conexão TCP/IP padrão requer criptografia SSL. A versão do MySQL Workbench mencionada neste tópico permite conexões sem SSL.

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

  • (Causa mais comum) A lista de permissões de endereços IP da instância RDS está configurada incorretamente. Em geral, isso significa que o endereço IP do client não foi adicionado à lista de permissões.

    Solução: Verifique e corrija a configure the IP address whitelist. Ao conectar a partir de um client local, execute curl ipinfo.io/ip para obter o endereço IP público do client e adicione-o à lista de permissões.

  • Em casos raros, você usa um endereço de rede interna sem atender aos internal network connection requirements.

    Solução: Apply for a public endpoint e use-o para conectar.

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

Ocorreu um conflito de rotas. Para mais informações, 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.

Ocorreu um conflito de rotas. Para mais informações, 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)

O nome de usuário ou a senha informados estão incorretos. Gerencie as contas e senhas do banco de dados na página Accounts da instância RDS.

Unknown MySQL server host 'xxx'(11001)

O endpoint da instância RDS informado está incorreto. O formato correto é rm-xxxxxx.mysql.rds.aliyuncs.com.

Perguntas frequentes

  • P: As instâncias ApsaraDB for RDS for MySQL são compatíveis com Elastic IP Addresses (EIPs)?

    R: Não, esse recurso não é compatível no momento.

  • P: Como resolver uma falha de conexão via Telnet do computador local para a instância RDS?

    R: Se não for possível conectar à instância RDS usando Telnet, verifique os seguintes pontos:

    • Confirme se a porta de service do banco de dados em cloud está correta e aberta para a internet.

    • Confira as regras do grupo de segurança ou do firewall do banco de dados em cloud para garantir que seu endereço IP local tenha permissão de conexão.

    • Verifique se os parâmetros de conexão, como hostname e número de porta, estão corretos.

    • Confira as regras de firewall do seu dispositivo local para garantir que a porta exigida pelo RDS não esteja bloqueada.

    • Se possível, tente conectar ao banco de dados em cloud usando outras ferramentas, como a CLI mysql ou uma ferramenta de gerenciamento de banco de dados, para descartar problemas específicos do Telnet.

  • P: Como outros usuários podem acessar meu banco de dados?

    R: Siga estas etapas:

    1. Create a standard account e conceda permissões no banco de dados.

    2. Apply for a public endpoint.

    3. Configure an IP address whitelist. Se o outro usuário estiver usando uma instância ECS, adicione o endereço IP privado ou o ID do grupo de segurança da instância ECS. Se o usuário estiver usando um client MySQL local, adicione o endereço IP público do dispositivo host.

    4. Compartilhe o endpoint público, o nome do banco de dados e as credenciais da conta com o usuário.

    5. O usuário poderá então connect to the database by using the CLI.

Referências