Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Step 2: Connect to an ApsaraDB RDS for MySQL instance

Última atualização: Jul 10, 2026

Conecte-se à sua instância do ApsaraDB RDS for MySQL para gerenciar dados ou implantar serviços usando o Data Management (DMS), uma interface de linha de comando (CLI) ou um cliente de terceiros.

Faturamento

  • A criação de uma instância do ApsaraDB RDS for MySQL gera taxas referentes às especificações e ao armazenamento da instância. Os valores variam conforme parâmetros como método de faturamento, série da instância, especificações, tipo de armazenamento e capacidade de armazenamento.

  • As taxas descritas neste tutorial não incluem os custos de servidores de aplicativos ou clientes de terceiros usados para conectar-se à instância do ApsaraDB RDS.

Pré-requisitos

  • Você já criou uma instância do ApsaraDB RDS for MySQL, um banco de dados e uma conta privilegiada na instância. Para mais informações, consulte Etapa 1: Criar uma instância do ApsaraDB RDS for MySQL e configurar um banco de dados.

    Importante

    Este tutorial utiliza a instância do ApsaraDB RDS for MySQL, o banco de dados, a conta e a senha que você criou e configurou no console seguindo a Etapa 1: Criar uma instância do ApsaraDB RDS for MySQL e configurar um banco de dados. Modifique-os conforme as necessidades do seu negócio.

  • Se você planeja fazer login no banco de dados usando o DMS, nenhuma preparação adicional é necessária.

  • Para conectar-se via CLI ou cliente, configure uma lista de permissões de endereços IP para a instância e obtenha o endpoint interno ou público conforme o tipo de acesso.

    Configurar uma lista de permissões de endereços IP e obter os endpoints internos e públicos

    1. Configurar uma lista de permissões de endereços IP

    Adicione seu endereço IP ou o endereço IP do servidor de aplicativos à lista de permissões de endereços IP da instância. É obrigatório configurar a lista de permissões de endereços IP antes de obter o endpoint interno ou público.

    2. Selecionar um tipo de acesso

    Para conexões remotas, utilize um endpoint interno se o ambiente atender aos requisitos; caso contrário, use um endpoint público. A tabela a seguir descreve os requisitos e como obter cada tipo de endpoint:

    Importante

    Para conectar-se a uma instância pela rede interna, os seguintes requisitos devem ser atendidos:

    • O servidor Alibaba Cloud usado para acessar a instância do ApsaraDB RDS deve estar na mesma região e Virtual Private Cloud (VPC) da instância.

    • Se tanto o servidor quanto a instância usarem o tipo de rede VPC, ambos devem residir na mesma VPC.

    Cenário

    Endpoint

    Método

    Os requisitos para conexão interna foram atendidos.

    Endpoint interno da instância do ApsaraDB RDS

    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 reside a instância do RDS. Em seguida, localize a instância do 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 do RDS. Na seção Basic Information, clique em View Connection Details ao lado de Network Type.

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

    • Para instâncias cluster, modifique o endereço do nó primário na seção Cluster Read/Write Connection e o endereço do nó secundário na seção Cluster Read-only Connection.

    Conexão a partir de uma instância ECS, mas os requisitos para conexão interna não foram atendidos.

    Endpoint público da instância do ApsaraDB RDS

    Conexão a partir de um dispositivo local.

Método 1: Fazer login usando o DMS

O Data Management (DMS) é uma plataforma unificada de gerenciamento de dados que suporta todo o ciclo de vida dos dados. Ele oferece recursos como gerenciamento global de ativos de dados, governança de dados, design e desenvolvimento de bancos de dados, integração de dados, desenvolvimento de dados e consumo de dados. O DMS foi projetado para ajudar as empresas a explorar o valor dos dados de forma eficiente e segura, acelerando a transformação digital.

Com o DMS, é possível fazer login em uma instância do ApsaraDB RDS for MySQL sem precisar configurar uma lista de permissões de endereços IP ou selecionar um tipo de acesso.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância reside. Em seguida, clique em ID da instância.

  2. Clique em Log In para ir à página de login do DMS.

  3. Na caixa de diálogo Log On to Instance, insira as informações de login e clique em Log On.

    • Selecione o Access Mode. Este tutorial usa Account + password login como exemplo.

      Se selecionar a opção KMS Credential Logon, consulte Integrar o Data Management (DMS) com credenciais do RDS.

    • Insira a Database Account e a Database Password. Este tutorial utiliza a conta privilegiada dbuser e uma senha definida pelo usuário como exemplo.

    • Selecione o Control Mode. Este tutorial usa Flexible Management - Free Forever como exemplo.

      Nota
      • Os modos Stable Change e Security Collaboration geram taxas.

      • Em comparação ao Flexible Management (Free Forever) modo de controle, os modos Stable Change e Security Collaboration oferecem mais recursos e capacidades mais robustas de controle de banco de dados. Se você está testando ou avaliando o product RDS MySQL, recomendamos selecionar o modo Flexible Management.

  4. Visualize o banco de dados. Após fazer login com sucesso, visualize o banco de dados recém-criado em Instances Connected no lado esquerdo da página do DMS. Este tutorial usa o banco de dados db_test1 como exemplo. Também é possível clicar duas vezes em outros bancos de dados para alternar entre eles.

    Nota
    • information_schema, MySQL, performance_schema, sys e Recycle Bin são todos bancos de dados do sistema.

    • Se a instância aparecer, mas o banco de dados não for exibido ao expandi-la, verifique estas possíveis causas:

      • A conta de login não tem permissões de acesso ao banco de dados de destino: Acesse a página Accounts nos detalhes da instância do RDS para ajustar manualmente as permissões da conta.

      • Os metadados não estão sincronizados. Como resultado, o banco de dados não aparece na árvore de navegação. Passe o mouse sobre a instância que deseja gerenciar e clique em ícone image à direita do nome da instância para atualizar a lista de bancos de dados.

      Para sincronizar rapidamente o esquema do banco de dados, utilize o recurso de design de esquema do DMS.

Método 2: Conectar-se usando a CLI

Utilize a CLI do MySQL para conectar-se à sua instância do ApsaraDB RDS for MySQL a partir de uma instância ECS ou servidor local. O exemplo a seguir utiliza Linux.

Importante
  1. Faça login no servidor de aplicativos que será usado para conectar-se à instância do ApsaraDB RDS. É possível conectar-se de um servidor local ou fazer login em uma instância do Alibaba Cloud ECS.

  2. Execute o comando de conexão ao banco de dados e insira a senha para acessar a instância do ApsaraDB RDS for MySQL. No comando, -h especifica o endpoint da instância do ApsaraDB RDS, -P especifica a porta da instância do ApsaraDB RDS, -u especifica o nome de usuário e -p solicita a senha.

    # Connection command template
    mysql -h <endpoint> -P <port> -u <username> -p
    # Connection command example
    mysql -h rm-bp**************.mysql.rds.aliyuncs.com -P 3306 -u dbuser -p
    • Insira o endpoint. Verifique se os requisitos para conexão interna foram atendidos e insira o endpoint apropriado. Este tutorial usa um endpoint interno como exemplo. Para mais informações sobre como obter os endpoints internos e públicos de uma instância, consulte a seção Pré-requisitos deste tópico.

    • Insira a porta. Este tutorial usa a porta 3306 como exemplo.

    • Insira o nome de usuário. Este tutorial usa a conta privilegiada dbuser como exemplo.

    • Pressione a tecla Enter. No prompt Enter password, insira a senha da conta privilegiada e pressione Enter novamente.

  3. Quando a CLI exibir a seguinte mensagem de boas-vindas, a conexão com a instância do ApsaraDB RDS for MySQL estará estabelecida. Agora é possível executar operações no banco de dados.

    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 51325
    Server version: 8.0.18 Source distribution

Método 3: Conectar-se usando um cliente

Utilize um cliente de banco de dados de terceiros para conectar-se à sua instância do ApsaraDB RDS for MySQL. O exemplo a seguir utiliza o MySQL Workbench 8.0.29.

Importante
  1. Abra o MySQL Workbench e escolha Database > Connect to Database.

  2. Na página Connect to Database, insira o endpoint e as informações da conta necessários.

    • Em Connection Method, selecione Standard(TCP/IP), usado como exemplo neste tutorial .

    • Hostname: Verifique se os requisitos para conexão interna foram atendidos e insira o endpoint apropriado. Este tutorial usa um endpoint interno como exemplo.

    • Port: Este tutorial usa a porta 3306 como exemplo.

    • Username: Este tutorial usa a conta privilegiada dbuser como exemplo.

    • Password: Insira sua senha personalizada.

  3. Clique em OK para conectar-se à instância do ApsaraDB RDS for MySQL. Agora é possível executar operações no banco de dados.

Erros comuns

mysql command not found

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

  • CentOS: Execute sudo yum install mysql.

  • Ubuntu: Execute sudo apt-get update e depois 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 criptografia SSL para conexões TCP/IP padrão. Baixe o MySQL Workbench 8.0.29 para estabelecer uma conexão padrão.

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

  • (Mais comum) A lista de permissões de endereços IP da instância do ApsaraDB RDS está configurada incorretamente. Para mais informações, consulte Configurar uma lista de permissões de endereços IP.

  • (Menos comum) Você está usando um endpoint interno para conectar-se, mas os requisitos para conexão interna não foram atendidos. Por exemplo, a instância ECS e a instância do ApsaraDB RDS não estão na mesma VPC. Nesse caso, obtenha e use um endpoint público.

Cannot Connect to Database Server

  • (Mais comum) A lista de permissões de endereços IP da instância do ApsaraDB RDS está configurada incorretamente. Para mais informações, consulte Configurar uma lista de permissões de endereços IP.

  • (Menos comum) Você está usando um endpoint interno para conectar-se, mas os requisitos para conexão interna não foram atendidos. Por exemplo, a instância ECS e a instância do ApsaraDB RDS não estão na mesma VPC. Nesse caso, obtenha e use um endpoint público.

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

  • (Mais comum) A lista de permissões de endereços IP da instância do ApsaraDB RDS está configurada incorretamente. Para mais informações, consulte Configurar uma lista de permissões de endereços IP.

  • (Menos comum) Você está usando um endpoint interno para conectar-se, mas os requisitos para conexão interna não foram atendidos. Por exemplo, a instância ECS e a instância do ApsaraDB RDS não estão na mesma VPC. Nesse caso, obtenha e use um endpoint público.

Erro Destination Host Unreachable ao executar ping no endpoint interno da instância do ApsaraDB RDS

Causa: Conflitos de rota. Para saber como resolver esse problema, consulte O que fazer se não conseguir executar ping no endpoint interno de uma instância do ApsaraDB RDS?.

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

A conta ou a senha está incorreta. Gerencie contas e senhas na página Accounts no console do RDS.

Unknown MySQL server host 'xxx'(11001)

O endpoint está incorreto. Certifique-se de que ele segue o formato rm-xxxxxx.mysql.rds.aliyuncs.com.

Perguntas frequentes

  • P: Uso o Function Compute (FC). Como posso recuperar dados de uma instância do ApsaraDB RDS?

    R: Instale dependências de terceiros para uma função e use módulos integrados para recuperar dados da instância do ApsaraDB RDS. Para mais informações, consulte Instalar dependências de terceiros para uma função.

  • P: Após conectar-me ao banco de dados, como importo um arquivo SQL?

    R: Se precisar importar rapidamente uma grande quantidade de dados de um arquivo (nos formatos SQL, CSV ou Excel), utilize o recurso de importação de dados do DMS.

Documentos relacionados