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

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

Pré-requisitos

Antes de se conectar:

Obter o endpoint e a porta do cluster
Cluster PolarDB for PostgreSQL centralizado

Um cluster PolarDB for PostgreSQL centralizado tem a Database Edition definida como Enterprise Edition ou Standard Edition.

Faça login no console do PolarDB. Na lista de clusters, clique em um ID de cluster para abrir a página Basic Information. Visualize as informações de endpoint do cluster na seção Database Connections.

Nota

Use o Cluster Endpoint para conexão. A porta padrão é 3306.

Escolha o endpoint Private ou Public conforme o ambiente de acesso.

Para acessar o cluster PolarDB a partir de uma instância ECS na mesma VPC do cluster PolarDB, use o endpoint Private.

Para acessar o cluster PolarDB do seu ambiente local, use o endpoint Public. Não há endpoint público por padrão — clique em Apply para criar um.

O cluster PolarDB não atinge o desempenho ideal quando conectado por meio de um public endpoint.

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

Cluster PolarDB for PostgreSQL distribuído

Faça login no console do PolarDB. Na lista de clusters, clique em um ID de cluster para abrir a página Basic Information. Consulte as informações de endpoint na seção Database Connections.

Nota

Por padrão, um cluster PolarDB for PostgreSQL distribuído possui um Primary Endpoint. A porta padrão é 5432.

Selecione o endpoint Private ou Public dependendo do ambiente de acesso.

Para acessar o cluster PolarDB a partir de uma instância ECS na mesma VPC do cluster PolarDB, use o endpoint Private.

Para acessar o cluster PolarDB do seu ambiente on-premises, use o endpoint Public. Não há endpoint público por padrão — clique em Apply para criar um.

A conexão via public endpoint impede que o cluster PolarDB atinja seu desempenho máximo.

Não é possível conectar hosts virtuais e servidores leves a um cluster PolarDB usando um 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 é 5432.
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 é 5432
`port`
`username`	A database account do cluster PolarDB.
`dbname`	O database name.

Exemplo

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

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

A conexão a um cluster PolarDB for PostgreSQL é 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 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 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 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.

PolarDB:Connect to a database

Pré-requisitos

Cluster PolarDB for PostgreSQL centralizado

Cluster PolarDB for PostgreSQL distribuído

Conectar-se a um cluster

Usar o DMS para conectar-se a um cluster

Usar um cliente para conectar-se a um cluster

Usar psql para conectar-se a um cluster

Sintaxe

Exemplo

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

Java

Python

Go

FAQ

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

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

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

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

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

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

Referências

Pré-requisitos

Cluster PolarDB for PostgreSQL centralizado

Cluster PolarDB for PostgreSQL distribuído

Conectar-se a um cluster

Usar o DMS para conectar-se a um cluster

Usar um cliente para conectar-se a um cluster

Usar psql para conectar-se a um cluster

Sintaxe

Exemplo

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

Java

Python

Go

FAQ

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

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

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

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

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

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

Referências

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