Connect to a PolarDB for PostgreSQL cluster - PolarDB: Central de Documentação do Alibaba Cloud

Conecte-se a um cluster PolarDB for PostgreSQL (Compatible with Oracle) usando DMS, pgAdmin, psql ou uma linguagem de programação.

Pré-requisitos

Antes de se conectar:

Obter o endpoint e a porta do cluster
Acesse o console do PolarDB. Clique no ID do cluster desejado na lista para abrir a página Basic Information. Verifique as informações de endpoint na seção Database Connections.
Nota

Use o Cluster Endpoint para estabelecer a conexão. A porta padrão é 1521.

Opte pelo endpoint Private ou Public de acordo com o ambiente de acesso.

Ao acessar o cluster PolarDB de uma instância ECS localizada na mesma VPC do cluster PolarDB, use o endpoint Private.

Para acessar o cluster PolarDB a partir do seu ambiente local, use o endpoint Public. Por padrão, não há endpoint público disponível — clique em Apply para solicitá-lo.

O uso de um public endpoint limita o desempenho máximo do cluster PolarDB.

Hosts virtuais e servidores leves não têm suporte para conexão a um cluster PolarDB via endpoint Private.
Criar uma conta de banco de dados

Faça login no console do PolarDB. Na lista de clusters, clique em um ID de cluster para abrir a página Basic Information. No painel de navegação à esquerda, escolha Settings and Management > Accounts para crie uma conta de banco de dados.

Nota
É possível criar uma Privileged Account ou uma Standard Account. Esses tipos de conta possuem different permissions. Crie a conta conforme suas necessidades.
Configurar uma whitelist de cluster
Faça login no console do PolarDB. Na lista de clusters, clique em um ID de cluster para abrir a página Basic Information. No painel de navegação à esquerda, selecione Settings and Management > Cluster Whitelists e adicione uma IP whitelist ou um security group.
Nota

Para acessar o cluster PolarDB a partir de uma instância ECS na mesma VPC do cluster PolarDB, adicione o endereço IP interno da instância ECS a uma whitelist ou adicione seu grupo de segurança.

Caso o acesso ao cluster PolarDB ocorra a partir de uma instância ECS em uma VPC diferente da VPC do cluster PolarDB, adicione o endereço IP público da instância ECS a uma whitelist ou adicione seu grupo de segurança.

Para acessar o cluster PolarDB do seu ambiente local, adicione seu endereço IP público a uma whitelist.

Obtenha seu endereço IP público:

Linux: Execute curl ifconfig.me.

Windows: Execute curl ip.me no Prompt de Comando.

macOS: Execute curl ifconfig.me no Terminal.

Se sua rede utilizar um proxy, o método acima pode não retornar seu endereço IP público real. Adicione temporariamente o bloco CIDR 0.0.0.0/0 a uma whitelist do cluster PolarDB. Após conectar-se, execute SELECT pid,usename,datname,client_addr,state,query FROM pg_stat_activity WHERE state = 'active'; para descobrir seu endereço IP público real e adicioná-lo à whitelist. Em seguida, remova o bloco CIDR 0.0.0.0/0.

Adicionar o bloco CIDR 0.0.0.0/0 a uma whitelist de IP permite que todas as origens acessem o cluster. Utilize esse bloco CIDR apenas quando necessário.

Agora você já pode se conectar ao cluster.

Conectar-se a um cluster

Escolha um método de conexão.

Usar o DMS para conectar-se a um cluster

O Data Management (DMS) oferece administração de banco de dados, auditoria de segurança e otimização de desempenho. Gerencie seu cluster PolarDB diretamente no DMS.

Faça login no console do PolarDB. Na lista de clusters, clique em um ID de cluster para abrir a página Basic Information. No canto superior direito, clique em Log On To Database.
Na caixa de diálogo, insira a conta e a senha do banco de dados e clique em Login.
Após o login, acesse Database Instances > Instances Connected no painel de navegação à esquerda para gerenciar o cluster .

Usar um cliente para conectar-se a um cluster

Este procedimento utiliza o pgAdmin 4 v9.0 para conectar-se a um cluster PolarDB.

Baixe e instale o cliente pgAdmin 4.
Abra o cliente pgAdmin 4, clique com o botão direito em Servers e selecione Register > Server....

Na aba General, defina o nome da conexão. Na aba Connection, configure os parâmetros de conexão e clique em Save.

Parâmetro	Descrição
Host name/address	O endpoint and port do cluster PolarDB. Para acessar o cluster PolarDB a partir de uma instância ECS, caso a instância ECS esteja na mesma VPC do cluster PolarDB, especifique o endpoint e a porta Private. Para acessar o cluster PolarDB do seu ambiente local, especifique o endpoint e a porta Public. O número da porta padrão é 1521.
Port
Username	A database account and password do cluster PolarDB.
Password	A database account and password do cluster PolarDB.

Uma conexão bem-sucedida exibe a seguinte página.

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

Usar psql para conectar-se a um cluster

Baixe o psql em PostgreSQL Downloads para conectar-se a um cluster PolarDB. Também é possível usar o psql no PolarDB-Tools para conectar-se a um cluster PolarDB.

Nota

O método de conexão é o mesmo para Windows e Linux.
A documentação oficial do psql aborda o uso detalhado.

Sintaxe

psql -h <host> -p <port> -U <username> -d <dbname>

Parâmetro	Descrição
`host`	O cluster endpoint and port do cluster PolarDB. Para acessar o cluster PolarDB a partir de uma instância ECS, caso a instância ECS esteja na mesma VPC do cluster PolarDB, especifique o endpoint e a porta Private. Para acessar o cluster PolarDB do seu ambiente local, especifique o endpoint e a porta Public. O número da porta padrão é 1521
`port`
`username`	A database account do cluster PolarDB.
`dbname`	O database name.

Exemplo

psql -h pc-xxx.rwlb.rds.aliyuncs.com -p 1521 -U testusername -d postgres

Conectar-se a um cluster usando uma linguagem de programação

A conexão a um cluster PolarDB for PostgreSQL (Compatible with Oracle) é semelhante à conexão a um banco de dados PostgreSQL comum — basta atualizar o endpoint, a porta, a conta e a senha.

Java

Conecte-se a um cluster PolarDB for PostgreSQL (Compatible with Oracle) usando o driver JDBC do PostgreSQL em um projeto Java baseado em Maven.

Adicione a dependência do driver JDBC do PostgreSQL ao seu arquivo pom.xml. Código de exemplo:

<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>42.2.18</version>
</dependency>

Conecte-se ao cluster. Substitua os placeholders <HOST>, <PORT>, <USER>, <PASSWORD>, <DATABASE>, <YOUR_TABLE_NAME> e <YOUR_TABLE_COLUMN_NAME> pelos parâmetros reais de conexão do cluster.

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;

public class PolarDBConnection {
    public static void main(String[] args) {
        // Database URL, username, and password.
        String url = "jdbc:postgresql://<HOST>:<PORT>/<DATABASE>";
        String user = "<USER>";
        String password = "<PASSWORD>";

        try {
            // Load the PostgreSQL JDBC driver.
            Class.forName("org.postgresql.Driver");
            
            // Establish the connection.
            Connection conn = DriverManager.getConnection(url, user, password);
            
            // Create a Statement object.
            Statement stmt = conn.createStatement();
            
            // Execute an SQL query.
            ResultSet rs = stmt.executeQuery("SELECT * FROM <YOUR_TABLE_NAME>");
            
            // Process the result set.
            while (rs.next()) {
                System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>"));
            }
            
            // Close resources.
            rs.close();
            stmt.close();
            conn.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Python

Conecte-se a um cluster PolarDB for PostgreSQL (Compatible with Oracle) usando a biblioteca psycopg2 no Python 3.

Instale a biblioteca psycopg2.
```
pip3 install psycopg2-binary
```

Conecte-se ao cluster. Substitua os placeholders <HOST>, <PORT>, <USER>, <PASSWORD>, <DATABASE> e <YOUR_TABLE_NAME> pelos parâmetros reais de conexão do cluster.

import psycopg2

try:
    # Connection parameters
    conn = psycopg2.connect(
        host="<HOST>",  # The cluster endpoint.
        database="<DATABASE>",  # The database name.
        user="<USER>",  # The username.
        password="<PASSWORD>",  # The password.
        port="<PORT>"  # The port number.
    )

    # Create a cursor object.
    cursor = conn.cursor()

    # Execute a query.
    cursor.execute("SELECT * FROM <YOUR_TABLE_NAME>")

    # Get all results.
    records = cursor.fetchall()
    for record in records:
        print(record)
        
except Exception as e:
    print("Error:", e)
finally:
    # Close the connection.
    if 'cursor' in locals():
        cursor.close()
    if 'conn' in locals():
        conn.close()

Go

Conecte-se a um cluster PolarDB for PostgreSQL (Compatible with Oracle) usando o pacote database/sql e o driver lib/pq no Go 1.23.0.

Instale o driver lib/pq.
```
go get -u github.com/lib/pq
```

Conecte-se ao cluster. Substitua os placeholders <HOST>, <PORT>, <USER>, <PASSWORD>, <DATABASE> e <YOUR_TABLE_NAME> pelos parâmetros reais de conexão do cluster.

package main

import (
    "database/sql"
    "fmt"
    "log"

    _ "github.com/lib/pq" // Initialize the PostgreSQL driver.
)

func main() {
    // The connection string format.
    connStr := "user=<USER> password=<PASSWORD> dbname=<DATABASE> host=<HOST> port=<PORT> sslmode=disable"

    // Open a database connection.
    db, err := sql.Open("postgres", connStr)
    if err != nil {
        log.Fatal(err)
    }
    defer db.Close() // Close the connection when the program exits.

    // Test the connection.
    err = db.Ping()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("Connected to PostgreSQL!")

    // Execute a query.
    rows, err := db.Query("SELECT * FROM <YOUR_TABLE_NAME>")
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()
}

FAQ

Por que não consigo conectar uma instância ECS a um cluster PolarDB?

Realize a solução de problemas da seguinte forma:

Verifique se o cluster PolarDB está no estado Running.
Confirme o endpoint do banco de dados, a porta, a conta e a senha. Obtain the database endpoint and port.
Teste a conectividade de rede a partir da instância ECS usando ping ou telnet.
1. Se estiver usando um endpoint Private:
  1. Verifique se a instância ECS e o cluster PolarDB estão na mesma VPC. Caso contrário, o endpoint Private estará indisponível. Use um dos métodos a seguir para conectar a instância ECS e o cluster PolarDB:
    - Altere a VPC da instância ECS.
    - Use a Cloud Enterprise Network (CEN) para connect VPCs in the same region.
  2. Verifique se o endereço IP privado, o bloco CIDR ou o grupo de segurança da instância ECS está na whitelist do cluster PolarDB. Configure a cluster whitelist.
2. Se estiver usando um endpoint Public, verifique se o endereço IP público ou o grupo de segurança da instância ECS está na whitelist do cluster PolarDB. Configure a cluster whitelist.

Nota

Hosts virtuais e servidores leves não podem se conectar a um cluster PolarDB por meio de um endpoint Private.

Por que não consigo me conectar ao cluster PolarDB do meu ambiente local?

Realize a solução de problemas da seguinte forma:

Verifique se o cluster PolarDB está no estado Running.
Confirme o endpoint do banco de dados, a porta, a conta e a senha. Obtain the database endpoint and port.
Nota
É obrigatório usar um endpoint Public. Se você estiver usando uma instância ECS que reside na mesma VPC do cluster PolarDB, poderá usar um endpoint Private.
Teste a conectividade de rede do seu ambiente local usando ping ou telnet.
Verifique se o endereço IP público ou o bloco CIDR do seu ambiente local está na whitelist do cluster PolarDB. Configure a whitelist
Obtenha seu endereço IP público:
- Linux: Execute curl ifconfig.me.
- Windows: Execute curl ip.me no Prompt de Comando.
- macOS: Execute curl ifconfig.me no Terminal.
Se sua rede utilizar um proxy, o método acima pode não retornar seu endereço IP público real. Adicione temporariamente o bloco CIDR 0.0.0.0/0 a uma whitelist do cluster PolarDB. Após conectar-se, execute SELECT pid,usename,datname,client_addr,state,query FROM pg_stat_activity WHERE state = 'active'; para descobrir seu endereço IP público real e adicioná-lo à whitelist. Em seguida, remova o bloco CIDR 0.0.0.0/0.

Não consigo me conectar ao cluster PolarDB. O seguinte erro é retornado: password authentication failed for user

A conta ou a senha do banco de dados está incorreta. Verifique suas credenciais. Faça login no console do PolarDB e acesse Settings and Management > Accounts para gerenciar a conta e a senha do banco de dados.

Não consigo me conectar ao cluster PolarDB. O seguinte erro é retornado: name or service not known

O endpoint do cluster está incorreto. O formato correto é pc-xxx.xxx.rds.aliyuncs.com. Faça login no console do PolarDB e acesse Basic Information > Database Connections para gerenciar os endpoints do seu cluster.

Não consigo me conectar ao cluster PolarDB. O seguinte erro é retornado: connection timed out

O endereço IP público ou o bloco CIDR do ambiente atual não está na whitelist do cluster PolarDB, ou o valor adicionado está incorreto.

Obtenha seu endereço IP público:

Linux: Execute curl ifconfig.me.
Windows: Execute curl ip.me no Prompt de Comando.
macOS: Execute curl ifconfig.me no Terminal.

Se sua rede utilizar um proxy, o método acima pode não retornar seu endereço IP público real. Adicione temporariamente o bloco CIDR 0.0.0.0/0 a uma whitelist do cluster PolarDB. Após conectar-se, execute SELECT pid,usename,datname,client_addr,state,query FROM pg_stat_activity WHERE state = 'active'; para descobrir seu endereço IP público real e adicioná-lo à whitelist. Em seguida, remova o bloco CIDR 0.0.0.0/0.

Como altero o método de conexão de um cluster PolarDB usando o DMS do endpoint primário para o endpoint do cluster?

Se você usar o DMS para se conectar a um cluster, o sistema usa o Primary Endpoint para se conectar ao cluster por padrão. Se for necessário usar o Cluster Endpoint para se conectar ao cluster PolarDB, execute as etapas a seguir:

Após conectar-se ao cluster usando o DMS, acesse Database Instances > Instances Connected no painel de navegação à esquerda. Localize o cluster, clique com o botão direito nele e selecione Edit.
Na caixa de diálogo Edit, acesse a seção Basic Information. Altere o parâmetro Connection Method para Connection String Address, insira o cluster endpoint e clique em Save.

Importante

Depois de alterar a string de conexão para acessar um cluster PolarDB, feche a janela SQL original e abra uma nova para garantir que as configurações atualizadas tenham efeito.

Referências

Visualize ou solicite um endpoint
Modifique ou exclua um endpoint
Private domain names
Compatibilidade de sintaxe Oracle 2.0: Clients e Drivers
Compatibilidade de sintaxe Oracle 1.0: Clients and Drivers Overview