Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Connect to a MariaDB instance

Última atualização: Jun 26, 2026

Após adquirir uma instância do ApsaraDB RDS for MariaDB e concluir as configurações necessárias — como criação de conta e configuração da lista de permissões —, conecte-se à sua instância via Data Management (DMS) ou por um client. Este tópico descreve como realizar essa conexão.

Pré-requisitos

As seguintes operações devem estar concluídas:

Procedimento

Usar o DMS para conectar-se a uma instância RDS

Nota

O DMS é uma ferramenta com interface gráfica desenvolvida pela Alibaba Cloud. Compatível com bancos de dados relacionais e NoSQL, o DMS oferece suporte a gerenciamento de dados e de schemas, autorização de usuários, auditoria de segurança, análise de tendências de dados, rastreamento de dados, relatórios de business intelligence (BI) e otimização de desempenho.

  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 em que a instância RDS reside. Em seguida, localize a instância RDS e clique em seu ID.

  2. No canto superior direito da página exibida, clique em Log On to Database.

  3. Na caixa de diálogo exibida, insira o nome de usuário e a senha da conta utilizada para fazer login na instância RDS. Em seguida, clique em Login.

    Nota

    Para obter o nome de usuário e a senha de uma conta, execute as seguintes operações:

    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 em que a instância RDS reside. Em seguida, localize a instância RDS e clique em seu ID.

    2. No painel de navegação à esquerda, clique em Accounts.

    3. Caso tenha esquecido a senha, clique em Reset Password.

  4. Após o login bem-sucedido, dê duplo clique no nome do banco de dados no painel de navegação à esquerda para alternar para esse banco de dados.

Usar um client de banco de dados para conectar-se a uma instância RDS

O ApsaraDB RDS é totalmente compatível com o MariaDB open source. É possível conectar-se à instância RDS a partir de qualquer client de banco de dados comum, seguindo um método semelhante ao usado para conectar-se a um banco de dados MariaDB open source. No exemplo a seguir, utiliza-se o client HeidiSQL.

  1. Inicie o client HeidiSQL.

  2. No canto inferior esquerdo da caixa de diálogo Session manager, clique em New.

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

    Parâmetro

    Descrição

    Network Type

    Selecione o tipo de rede da instância RDS. Por exemplo, selecione MariaDB or MySQL (TCP/IP).

    Library

    Selecione a biblioteca de vínculo dinâmico. Mantenha o valor padrão.

    Hostname / IP

    Insira o endpoint interno ou público da instância RDS. Exemplo: rm-bp1xxxxxxxxxxxxxx.mysql.rds.aliyuncs.com. Para saber como visualizar os endpoints interno e público de uma instância RDS, consulte Visualizar e alterar os endpoints interno e público e os números de porta.

    • Se o client estiver implantado em uma instância do Elastic Compute Service (ECS) que reside na mesma região e tem o mesmo tipo de rede da instância RDS, utilize o endpoint interno. Por exemplo, se as instâncias ECS e RDS estiverem ambas em uma VPC localizada na região China (Hangzhou), use o endpoint interno da instância RDS para criar uma conexão segura.

    • Nos demais cenários, insira o endpoint público da instância RDS.

    User

    Insira o nome de usuário da conta utilizada para conectar-se à instância RDS. Para saber como criar uma conta, consulte Criar um banco de dados e uma conta em uma instância do ApsaraDB RDS for MariaDB.

    Password

    A senha da conta mencionada anteriormente.

    Port

    Para conexões via rede interna, insira o número de porta interna da instância. Para conexões via Internet, insira o número de porta pública. Para mais informações, consulte Visualizar e alterar os endpoints interno e público e os números de porta.

  4. Clique em Open.

    Se os parâmetros estiverem configurados corretamente, a conexão com a instância RDS será estabelecida.

    Após a conexão, o painel de navegação à esquerda do HeidiSQL exibe uma árvore de diretórios dos seus bancos de dados. À direita, constam os detalhes do banco de dados selecionado, incluindo nomes de tabelas, contagem de linhas, tamanho, data de criação e tipo de engine.

Os seguintes erros comuns podem ocorrer:

  • Unknown MySQL server hose 'xxxxxxxxx'(11001)

    Se esse erro ocorrer, verifique se o parâmetro Hostname / IP está configurado corretamente. Se esse parâmetro estiver definido com o ID ou endereço IP da instância RDS, a conexão falhará. Defina esse parâmetro com o endpoint interno ou público da instância RDS.

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

    Verifique se o nome de usuário e a senha inseridos estão corretos. Um erro comum é utilizar as credenciais da conta Alibaba Cloud. Use as credenciais da conta de banco de dados disponíveis na página Accounts da instância.

  • A resposta está lenta e a mensagem "Can't connect to MySQL server on 'rm-bp1xxxxxxxxxxxxxx.mysql.rds.aliyuncs.com'(10060)" é retornada.

    Se esse erro ocorrer, verifique se o endereço IP público do servidor que executa o HeidiSQL foi adicionado a uma lista de permissões de endereços IP da instância RDS. Para saber como configure uma lista de permissões, consulte Configurar uma lista de permissões de endereços IP.

    Nota

    É possível adicionar temporariamente a entrada 0.0.0.0/0 a uma lista de permissões de endereços IP da instância RDS. Se a conexão for estabelecida com sucesso após essa adição, o erro ocorreu devido a uma lista de permissões configurada incorretamente. Nesse caso, obtenha o endereço IP público real do servidor que executa o HeidiSQL. Para mais informações, consulte Por que não consigo conectar minha instância do ApsaraDB RDS for MySQL ou do ApsaraDB RDS for MariaDB a partir de um servidor local via Internet?

Perguntas frequentes

Como usar o Function Compute para obter dados da minha instância RDS?

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