ApsaraDB RDS:Connect to a PostgreSQL instance

Data Management (DMS)

O Data Management (DMS) é um serviço unificado que integra gerenciamento de dados, esquemas, autorização de usuários, auditoria de segurança, tendências, rastreamento, gráficos de BI, otimização de desempenho e administração de servidores. Para saber mais sobre o DMS, consulte O que é o 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 está localizada. Em seguida, localize a instância desejada e clique em ID da instância.

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

3. Na página Log on to database instance do DMS, selecione um Access Method e um Control Mode.

   Parâmetro	Descrição
   Access Method	Método de acesso à instância ApsaraDB RDS via DMS. Este tópico utiliza Account + Password Login como exemplo. Account + Password Login: Faça login com o nome de usuário e senha de uma conta de banco de dados que tenha permissões no banco de dados de destino. Log on with KMS credential: O DMS ativa automaticamente a hospedagem segura para a instância. Selecione manualmente a credencial RDS criada no KMS para fazer login. Nota Ao usar o método de acesso Log on with KMS credential, o DMS ativa automaticamente a hospedagem segura para a instância sem custo adicional. Também é possível clicar em One-click enable secure hosting, inserir uma conta e senha e ativar a hospedagem segura gratuitamente. Isso permite um login seguro, controlável e sem senha.
   Control Mode	O DMS oferece três modos de controle no nível da instância. Escolha aquele que melhor se adapta ao seu cenário de negócios. Flexible Management Stable Change Security Collaboration

4. Após fazer login e atualizar a página, as instâncias e seus respectivos bancos de dados aparecerão no painel Instances Connected à esquerda.

   Nota

   Se você ativou a hospedagem segura, as instâncias conectadas e seus bancos de dados ficarão visíveis no painel Password-free instances à esquerda.

   

   • No console do DMS, troque de bancos de dados apenas com um clique duplo no banco de dados desejado. O comando USE não é suportado.

   • Caso a instância exista, mas o banco de dados de destino não apareça após a expansão, verifique uma das seguintes causas:

     • A conta de login não possui permissão de acesso ao banco de dados de destino. Faça login com uma conta que tenha as permissões necessárias.

     • O catálogo não está visível devido à falta de sincronização de metadados. Para corrigir, passe o mouse sobre o nome da instância e clique em ícone à direita. Essa ação atualiza a lista de bancos de dados e exibe o banco de dados de destino.

     Para sincronizar rapidamente os esquemas de bancos de dados e tabelas, utilize o recurso de inicialização de banco de dados vazio do DMS.

Cliente pgAdmin

O cliente pgAdmin é a ferramenta oficial recomendada para conexão com bancos de dados PostgreSQL. Esta seção utiliza o pgAdmin 4 v6.2.0 como exemplo para demonstrar a conexão com uma instância ApsaraDB RDS for PostgreSQL. Ao baixar e instalar o PostgreSQL no site oficial do PostgreSQL, o cliente pgAdmin 4 é instalado automaticamente.

Caso prefira não instalar o PostgreSQL completo, baixe o cliente pgAdmin independente apenas para conexões remotas.

1. Inicie o cliente pgAdmin 4.

   Nota

   No primeiro acesso às versões recentes do cliente, defina uma Master Password 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, defina um nome para a conexão.

4. Clique em aba Connection e insira as informações de conexão da sua instância.

   Parâmetro	Descrição
   Host name/address	Endpoint e porta da instância ApsaraDB RDS for PostgreSQL. Para conexão via rede interna, insira o endpoint interno e a porta da instância. Para conexão via internet, insira o endpoint público e a porta da instância. Essas informações estão disponíveis na página Database Connection da sua instância ApsaraDB RDS for PostgreSQL. Para mais detalhes, consulte Visualizar e alterar endpoints e portas.
   Port
   Username	Nome de usuário e senha da conta da sua instância ApsaraDB RDS for PostgreSQL. Para saber como criar uma conta, consulte Criar uma conta e um banco de dados.
   Password

5. Clique em Save.

   Se as informações estiverem corretas, o servidor será adicionado com sucesso.

   Importante

   O banco de dados postgres é o banco de dados padrão do sistema da instância ApsaraDB RDS. Evite executar operações neste banco de dados.

CLI do PostgreSQL

Ao instalar o PostgreSQL a partir do site oficial do PostgreSQL, a CLI do PostgreSQL também é instalada.

psql -h <endpoint> -U <username> -p <port> [-d <database_name>]

Aplicação

1. Adicione a dependência ao arquivo pom.xml.

   <dependency>
     <groupId>postgresql</groupId>
     <artifactId>postgresql</artifactId>
     <version>8.2-504.jdbc3</version>
   </dependency>

2. O código abaixo exemplifica como conectar-se à instância:

   public class DatabaseConnection
   {
       public static void main( String[] args ){
           try {
               Class.forName("org.postgresql.Driver");
           } catch (ClassNotFoundException e) {
               e.printStackTrace();
           }
           // The endpoint of the instance.
           String hostname = "pgm-bp1i3kkq7321o9****.pg.rds.aliyuncs.com";
           // The port of the instance.
           int port = 5432;
           // The name of the database.
           String dbname = "postgres";
           // The username.
           String username = "username";
           // The 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();
               // Enter the SQL statement to be executed.
               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();
           }
       }
   }

Ferramenta de BI de terceiros

O ApsaraDB RDS for PostgreSQL suporta conexões de ferramentas de business intelligence (BI) de terceiros. Essas ferramentas permitem obter, limpar, modelar e visualizar dados para análise. Esta seção demonstra a conexão com uma instância ApsaraDB RDS for PostgreSQL usando o Microsoft Power BI como exemplo. A versão do cliente utilizada é Power BI 2.112.1161.0 64-bit.

1. Baixe e instale o cliente Power BI Desktop. Para mais informações, consulte Obter o Power BI Desktop.

2. Inicie o cliente Power BI Desktop.

3. Na aba Homepage da barra de menu superior, clique em Get data > More....

4. Na caixa de diálogo Get Data, selecione Database > PostgreSQL e clique em Connection.

5. Na caixa de diálogo PostgreSQL, especifique o Server e o Database e clique em Yes.

   Parâmetro	Descrição
   Server	Endpoint e porta da instância ApsaraDB RDS for PostgreSQL. Formato: endpoint:port Para conexão via rede interna, insira o endpoint interno e a porta da instância. Para conexão via internet, insira o endpoint público e a porta da instância. Essas informações estão disponíveis na página Database Connection da sua instância ApsaraDB RDS for PostgreSQL. Para mais detalhes, consulte Visualizar e alterar endpoints e portas.
   Database	O banco de dados postgres é o banco de dados padrão do sistema da instância ApsaraDB RDS for PostgreSQL. Não execute operações neste banco de dados. Recomendamos especificar outro banco de dados criado por você na instância. Para saber como criar e visualizar bancos de dados, consulte Criar um banco de dados.

6. Defina o Username e a Password e clique em Connection.

   Nota

   Para saber como criar uma conta, consulte Criar uma conta e um banco de dados.

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

8. Após conectar-se com sucesso, visualize as informações das tabelas do banco de dados na janela Navigator. Selecione a tabela desejada e escolha Load ou Transform Data conforme suas necessidades de negócio.

Criptografia SSL

O ApsaraDB RDS for PostgreSQL suporta criptografia SSL para proteger dados em trânsito. Para detalhes específicos de configuração, consulte Conectar-se a uma instância ApsaraDB RDS for PostgreSQL via conexão criptografada por SSL.