Todos os produtos
Search
Central de documentação

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

Última atualização: Jul 10, 2026

Após criar uma instância ApsaraDB for RDS for MySQL e concluir as configurações necessárias (criar uma conta e configurar a lista de permissões), conecte-se a ela pela rede interna ou pela internet usando a CLI ou um cliente. Este tópico também apresenta soluções para erros comuns de conexão.

Pré-requisitos

Recomendações

  • Para obter menor latência e maior estabilidade, conecte-se à instância RDS a partir de uma instância ECS pela rede interna. A conexão via rede interna exige as seguintes condições:

    As instâncias ECS e RDS devem pertencer à mesma conta Alibaba Cloud, região e Virtual Private Cloud (VPC). Além disso, adicione o endereço IP privado da instância ECS à lista de permissões de endereços IP da instância RDS.

    Nota

    Visualize o endereço IP privado da instância ECS na página Instances.

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

  • Para conexões via rede pública, utilize o endpoint do banco de dados.

    Nota
    • Execute curl ipinfo.io/ip (recomendado) ou curl ifconfig.me para consultar o endereço IP público do cliente local.

    • O endereço IP público da instância RDS pode mudar durante atualizações ou migrações do banco de dados. Se você adicionou seu IP local à lista de permissões, mas ainda não consegue se conectar, consulte a solução fornecida.

Procedimento

Conectar via CLI

O exemplo a seguir demonstra a conexão com uma instância ApsaraDB for RDS for MySQL a partir de um sistema Linux. Primeiro, instale o MySQL:

  • No CentOS, execute sudo yum install mysql.

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

  1. Faça login no servidor usado para conectar-se à instância RDS, como uma instância ECS ou um servidor local.

    Nota

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

  2. Execute o comando a seguir para estabelecer a conexão:

    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, enquanto a minúscula p indica o prompt de senha.

    • Endpoint e porta: correspondem ao endpoint e à porta da instância RDS.

      Cenário

      Endpoint necessário

      Como obter

      Condições para conexão via rede interna atendidas.

      Endpoint interno

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

      2. Clique em View Details para visualizar o endereço e o número da 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 só é exibido após você clicar em Apply for Public Endpoint.

      • Para uma instância RDS Cluster Edition, modifique 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.

      Conexão a partir de uma instância ECS sem atender às condições para rede interna.

      Endpoint público

      Conexão a partir de um dispositivo local.

    • Nome de usuário e senha: obtenha essas informações 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

Conectar com MySQL Workbench

Também é possível utilizar outros clientes MySQL de uso geral. Os passos abaixo usam o MySQL Workbench 8.0.29 como exemplo.

  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: correspondem ao endpoint e à porta da instância RDS.

      Cenário

      Endpoint necessário

      Como obter

      Condições para conexão via rede interna atendidas.

      Endpoint interno

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

      2. Clique em View Details para visualizar o endereço e o número da 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 só é exibido após você clicar em Apply for Public Endpoint.

      • Para uma instância RDS Cluster Edition, modifique 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.

      Conexão a partir de uma instância ECS sem atender às condições para rede interna.

      Endpoint público

      Conexão a partir de um dispositivo local.

    • Username e Password: obtenha essas informações na página Accounts da instância RDS.

Conectar com Navicat

  1. Inicie o cliente Navicat.

  2. No canto superior esquerdo, clique em Connection e selecione o tipo de banco de dados.

    Nota

    Se você usar uma versão anterior do Navicat e o menu Alibaba Cloud não estiver disponível, selecione diretamente um tipo de banco de dados, como MySQL ou PostgreSQL.

    Na barra de ferramentas do Navicat, clique em Connection, selecione Alibaba Cloud no menu suspenso e escolha o tipo de banco de dados desejado no submenu, como Alibaba Cloud ApsaraDB for RDS (MySQL)..., Alibaba Cloud ApsaraDB for RDS (PostgreSQL)... ou Alibaba Cloud ApsaraDB for RDS (SQL Server)....

  3. Insira as informações de conexão da instância RDS. A tabela a seguir descreve os parâmetros.

    Parâmetro

    Descrição

    Connection Name

    Nome personalizado para a conexão.

    Host

    O endpoint interno ou endpoint público da instância RDS.

    • Utilize o endpoint interno se o cliente estiver em uma instância ECS na mesma conta, região e VPC da instância RDS.

    • Nos demais casos, utilize o endpoint público.

    Port

    A porta interna ou porta pública da instância RDS. Por exemplo, a porta padrão para MySQL é 3306.

    User Name

    Nome de usuário da conta que acessa a instância RDS. Essa informação está disponível na página Accounts da instância.

    Password

    Senha correspondente ao nome de usuário especificado.

  4. Clique em OK.

    Nota

    Se o modo de lista de permissões aprimorado estiver ativado e você desejar se conectar à instância pela internet, adicione o endereço IP público do cliente ao classic network group.

    Após conectar-se com sucesso usando um cliente como o Navicat, se você visualizar bancos de dados como busudab, information_schema e mysql na árvore de conexão, a conexão foi estabelecida corretamente.

Conectar-se a partir de ECS entre regiões ou contas

  • Conexão via rede pública (Internet): utilize o endpoint público da instância RDS para conectar-se entre regiões ou contas. O tráfego de entrada e saída pela internet para a instância RDS é gratuito.

  • Conexão via rede interna (rede privada): por padrão, conexões de rede interna entre regiões ou contas não são suportadas, pois as VPCs são isoladas entre si. Use VPC peering ou Cloud Enterprise Network (CEN) para interconectar VPCs e permitir que instâncias ECS acessem instâncias RDS em outras regiões ou contas.

    • Conexão VPC peering: oferece interconexão de VPCs entre regiões e contas com baixo custo, porém com configuração relativamente complexa. Mais indicado para cenários simples que envolvem poucas VPCs interconectadas.

    • CEN: permite interconexão de VPCs entre regiões e contas com configuração simplificada, mas a um custo relativamente maior. Recomendado para cenários complexos que envolvem múltiplas VPCs interconectadas.

Erros comuns de conexão

mysql command not found

O MySQL não está instalado. Execute um dos comandos a seguir para instalá-lo:

  • No CentOS, execute sudo yum install mysql.

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

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

Algumas versões do MySQL Workbench exigem SSL para conexões Standard TCP/IP. O MySQL Workbench 8.0.29 suporta 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, o que geralmente significa que o endereço IP do cliente não foi adicionado à lista.

    Solução: verifique e configure corretamente a lista de permissões de endereços IP. Se estiver se conectando a partir de um cliente local, execute curl ipinfo.io/ip para obter o endereço IP público do cliente local e adicione-o à lista de permissões.

  • Em casos raros, você pode estar usando um endereço de rede interna para se conectar sem atender aos requisitos de conexão via rede interna.

    Solução: solicite um endpoint público e utilize-o para se 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 Como resolver o problema de impossibilidade de pingar o endpoint interno de uma instância RDS.

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 Como resolver o problema de impossibilidade de pingar o endpoint interno de uma instância RDS.

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

O nome de usuário ou a senha está incorreto. 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 está incorreto. O formato correto é rm-xxxxxx.mysql.rds.aliyuncs.com.

Perguntas frequentes

  • P: As instâncias ApsaraDB for RDS for MySQL suportam Elastic IP Addresses (EIPs)?

    R: Não, esse recurso não é suportado atualmente.

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

    R: Se não conseguir se conectar à instância RDS via Telnet, verifique os seguintes itens:

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

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

    • Confirme se os parâmetros de conexão, como nome do host e número da porta, estão corretos.

    • Verifique as regras de firewall no seu dispositivo local para assegurar que a porta necessária pelo RDS não esteja bloqueada.

    • Se possível, tente se 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. Crie uma conta padrão e conceda a ela permissões no banco de dados.

    2. Solicite um endpoint público.

    3. Configure uma lista de permissões de endereços IP. Se o outro usuário estiver utilizando 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 cliente 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 conectar-se ao banco de dados usando a CLI.

Referências