Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Conectar-se a uma instância do ApsaraDB RDS for PostgreSQL

Última atualização: Aug 26, 2026

Após criar uma instância do ApsaraDB RDS for PostgreSQL e concluir as configurações necessárias, como a criação de uma conta e a configuração de uma lista de permissões de endereços IP, você pode se conectar à instância RDS usando o Data Management (DMS), o cliente pgAdmin, a CLI do PostgreSQL ou um aplicativo. Este tópico descreve como se conectar a uma instância RDS utilizando esses métodos de conexão.

Pré-requisitos

  • Uma instância RDS foi criada. Para mais informações, consulte Crie uma instância do ApsaraDB RDS for PostgreSQL.

  • Um banco de dados e uma conta associada foram criados na instância RDS. Para mais informações, consulte Crie uma conta e um banco de dados.

  • Uma lista de permissões de endereços IP está configurada para a instância RDS. Isso permite a conexão a partir da instância do Elastic Compute Service (ECS) ou de um dispositivo local onde o cliente esteja implantado. Para mais informações, consulte Configure uma lista de permissões de endereços IP para uma instância do ApsaraDB RDS for PostgreSQL.

    • Para conectar uma instância ECS à instância RDS por meio de uma rede interna, garanta que ambas estejam implantadas na mesma região e residam na mesma Virtual Private Cloud (VPC), sob a mesma conta Alibaba Cloud. Além disso, o endereço IP privado da instância ECS deve constar na lista de permissões de endereços IP da instância RDS.

    • Caso deseje conectar um dispositivo local à instância RDS, certifique-se de que o endereço IP público desse dispositivo esteja adicionado à lista de permissões de endereços IP da instância RDS.

Procedimento

Usar o DMS para conectar-se à instância RDS

O DMS oferece uma solução integrada que suporta gerenciamento de dados, gerenciamento de esquemas, gerenciamento de servidores, autorização de usuários, auditoria de segurança, análise de tendências, rastreamento de dados, relatórios de business intelligence (BI) e análise e otimização de desempenho. Para mais informações, consulte What is Data Management (DMS)?

  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 em seu ID.

  2. Na página Basic Information, clique em Log On to Database.SQL queries

  3. Na caixa de diálogo Log on to Database Instance do console DMS, insira o nome de usuário e a senha da conta utilizada para login e clique em Login.

    Nota

    A conta usada para login deve ter permissões no banco de dados necessário. Caso contrário, o banco de dados não aparecerá no painel de navegação à esquerda.

    Log on to DMS

  4. Atualize a página. No painel de navegação à esquerda do console DMS, clique em Instances Connected para visualizar os bancos de dados criados na instância RDS.Visualize bancos de dados

Nota
  • Também é possível fazer login diretamente no console DMS e adicionar sua instância RDS a ele. Depois, alterne para o banco de dados específico da sua instância RDS dentro do console DMS. Para mais informações, consulte Registre uma instância de banco de dados cloud.

  • Após redefinir a senha da sua conta, faça login novamente no DMS.

Usar o pgAdmin para conectar-se à instância RDS

O pgAdmin é um cliente PostgreSQL recomendado para conexão com instâncias RDS. Ao baixar o pacote de software PostgreSQL no site oficial do PostgreSQL e instalar o PostgreSQL, o pgAdmin 4 é baixado e instalado automaticamente. A seção a seguir apresenta um exemplo de como usar o pgAdmin 4 V6.2.0 para se conectar a uma instância RDS.

Se preferir não instalar o PostgreSQL, baixe apenas o pgAdmin para realizar conexões remotas.

  1. Inicie o pgAdmin 4.

    Nota

    No primeiro acesso a versões mais recentes do pgAdmin, defina uma senha mestra para proteger as senhas salvas e outras credenciais.

  2. Clique com o botão direito em Servers e escolha Register > Server.

  3. Na aba General da caixa de diálogo Register - Server, insira o nome do servidor onde o pgAdmin está instalado.

  4. Clique na aba Connection. Em seguida, configure os parâmetros de conexão com a instância RDS.

    Parâmetro

    Descrição

    Host name/address

    Endpoint e porta utilizados para conectar-se à instância RDS.

    • Para conexões via rede interna, insira o endpoint interno e a porta interna da instância RDS.

    • Para conexões via Internet, insira o endpoint público e a porta pública da instância RDS.

    Essas informações estão disponíveis na página Database Connection da instância RDS.

    Para mais informações, consulte Visualize e altere os endpoints e números de porta de uma instância do ApsaraDB RDS for PostgreSQL.

    Port

    Username

    Nome de usuário e senha necessários para fazer login na instância RDS.

    Para saber como criar uma conta em uma instância RDS, consulte Crie uma conta e um banco de dados.

    Password

  5. Clique em Save.

    Se as informações inseridas estiverem corretas, a página mostrada na figura a seguir será exibida, indicando que a conexão com a instância RDS foi bem-sucedida.

    Importante

    O banco de dados postgres é o banco de dados padrão do sistema. Não execute operações nele.

Usar a CLI do PostgreSQL para conectar-se à instância RDS

Ao baixar o pacote de software PostgreSQL no site oficial do PostgreSQL e instalar o PostgreSQL, the PostgreSQL CLI that is named Command Line Tools é baixada e instalada automaticamente.

Execute o seguinte comando na CLI do PostgreSQL para se conectar à instância RDS:

psql -h <Endpoint> -U <Username> -p <Port> [-d <Database name>]

Log on by using psql

Parâmetro

Descrição

Endpoint

Endpoint e porta utilizados para conectar-se à instância RDS.

  • Para conexões via rede interna, insira o endpoint interno e a porta interna da instância RDS.

  • Para conexões via Internet, insira o endpoint público e a porta pública da instância RDS.

Essas informações estão disponíveis na página Database Connection da instância RDS.

Para mais informações, consulte Visualize e altere os endpoints e números de porta de uma instância do ApsaraDB RDS for PostgreSQL.

Port

Username

Conta da instância RDS.

Para saber como criar uma conta em uma instância RDS, consulte Crie uma conta e um banco de dados.

Database Name

Nome do banco de dados ao qual deseja se conectar na instância RDS. Este parâmetro é opcional. O banco de dados chamado postgres é o banco de dados padrão do sistema. Não execute operações nele. Recomendamos o uso de outro banco de dados existente na instância RDS.

Para saber como criar e visualizar um banco de dados em uma instância RDS, consulte Crie um banco de dados.

Usar um aplicativo para conectar-se à instância RDS

Nota

Nesta seção, uma conexão Java Database Connectivity (JDBC) é configurada em um projeto Maven para estabelecer ligação com a instância RDS. Os passos são semelhantes caso utilize outra linguagem de programação.

  1. Adicione dependências ao arquivo pom.xml.

    <dependency>
      <groupId>postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <version>8.2-504.jdbc3</version>
    </dependency>
  2. Utilize JDBC para conectar-se à instância RDS.

    public class DatabaseConnection
    {
        public static void main( String[] args ){
            try {
                Class.forName("org.postgresql.Driver");
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
            //Endpoint of the RDS instance
            String hostname = "pgm-bp1i3kkq7321o9****.pg.rds.aliyuncs.com";
            //Port number of the RDS instance
            int port = 5432;
            //Database name
            String dbname = "postgres";
            //Username
            String username = "username";
            //Password
            String password = "password";
    
            String dbUrl = "jdbc:postgresql://" + hostname + ":" + port + "/" + dbname + "?binaryTransfer=true";
            Connection dbConnection;
            try {
                dbConnection = DriverManager.getConnection(dbUrl, username, password);
                Statement statement = dbConnection.createStatement();
                //SQL statement that you want to execute 
                String selectSql = "SELECT * FROM information_schema.sql_features LIMIT 10";
                ResultSet resultSet = statement.executeQuery(selectSql);
                while (resultSet.next()) {
                    System.out.println(resultSet.getString("feature_name"));
                }
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }

Usar uma ferramenta de relatórios de terceiros para conectar-se à instância RDS

O ApsaraDB RDS for PostgreSQL permite utilizar ferramentas de relatórios de terceiros para obter, limpar e visualizar dados, além de criar modelos baseados neles, facilitando a análise de dados. Esta seção exemplifica como usar o Power BI Desktop da Microsoft para se conectar a uma instância RDS. Neste exemplo, utiliza-se a versão Power BI Desktop 2.112.1161.0 64-bit.

  1. Baixe e instale o Power BI Desktop. Para detalhes sobre o método de download, consulte Obter o Power BI Desktop.

  2. Inicie o Power BI Desktop.

  3. Na barra de navegação superior, clique na aba Home e escolha Get data > More.

  4. Na caixa de diálogo Get Data, escolha Database > PostgreSQL database e clique em Connect.

  5. Na caixa de diálogo PostgreSQL database, configure os parâmetros Server e Database. Na seção Data Connectivity mode, selecione Import. Em seguida, clique em OK.

    Parâmetro

    Descrição

    Server

    Endpoint e porta da instância RDS.

    O valor segue o formato Endpoint:Port number.

    • Para conexões via rede interna, insira o endpoint interno e a porta interna da instância RDS.

    • Para conexões via Internet, insira o endpoint público e a porta pública da instância RDS.

    Essas informações estão disponíveis na página Database Connection da instância RDS.

    Para mais informações, consulte Visualize e altere os endpoints e números de porta de uma instância do ApsaraDB RDS for PostgreSQL.

    Database

    Nome do banco de dados ao qual deseja se conectar na instância RDS. O banco de dados chamado postgres é o banco de dados padrão do sistema. Não execute operações nele. Recomendamos o uso de outro banco de dados existente na instância RDS.

    Para saber como criar e visualizar um banco de dados em uma instância RDS, consulte Crie um banco de dados.

  6. Configure os parâmetros User name e Password e clique em Connect. Defina esses parâmetros com o nome de usuário e a senha da instância RDS.

    Nota

    Para saber como criar uma conta em uma instância RDS, consulte Crie uma conta e um banco de dados.

  7. Na caixa de diálogo Encryption Support, clique em OK.

  8. Na janela Navigator, visualize as informações sobre as tabelas do banco de dados. Selecione a tabela desejada e clique em Load ou Transform Data conforme suas necessidades de negócio.

Conectar-se a uma instância RDS via conexões SSL

É possível configurar criptografia SSL para uma instância RDS. A criptografia SSL protege as conexões com a instância RDS e os dados transmitidos por elas. Para mais informações, consulte Conecte-se a uma instância do ApsaraDB RDS for PostgreSQL via SSL.

Perguntas frequentes

  • Como me conectar a uma instância RDS a partir de uma instância ECS implantada em uma região diferente ou pertencente a outra conta Alibaba Cloud?

    Utilize um dos seguintes métodos para conectar-se à instância RDS:

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

    Instale dependências de terceiros no Function Compute. Em seguida, use essas dependências integradas para obter dados do ApsaraDB RDS. Para mais informações, consulte Instalar dependências de terceiros.