Conectando-se ao Managed Postgres

Strings de conexão, pool de conexões do PgBouncer e configuração de TLS para o ClickHouse Managed Postgres

​

Acessando os detalhes da conexão

Para conectar seus aplicativos ao Managed Postgres, acesse a tela Connect na barra lateral esquerda da sua instância.

Ao clicar em Connect, um modal é aberto exibindo suas credenciais de conexão e strings de conexão em múltiplos formatos.

O modal de conexão exibe as seguintes informações:

• Nome de usuário: O usuário do banco de dados (padrão: postgres)
• Senha: A senha do seu banco de dados (mascarada por padrão; clique no ícone de olho para revelar)
• Servidor: O hostname da sua instância do Managed Postgres
• Porta: A porta do PostgreSQL (padrão: 5432)

O Managed Postgres concede acesso de superusuário ao seu banco de dados. Use essas credenciais para se conectar como superusuário, o que permite criar usuários adicionais e gerenciar objetos do banco de dados.

​

Formatos da string de conexão

As abas Conectar via fornecem a string de conexão em vários formatos para atender aos requisitos da sua aplicação:

Formato	Descrição
url	URL de conexão padrão no formato postgresql://<USER>:<PASSWORD>@<HOST>:<PORT>/<DATABASE>
psql	Comando pronto para uso para se conectar pela ferramenta de linha de comando psql
env	Variáveis de ambiente para clientes baseados em libpq
yaml	Configuração em formato YAML
jdbc	String de conexão JDBC para aplicações Java

Por motivos de segurança, a senha nas strings de conexão fica mascarada por padrão. Clique no ícone de cópia ao lado de qualquer campo ou string de conexão para copiá-la diretamente para a área de transferência.

​

Pool de conexões com PgBouncer

O Managed Postgres inclui uma instância integrada do PgBouncer para pool de conexões no servidor. O PgBouncer ajuda a melhorar o gerenciamento de conexões, o desempenho e a utilização de recursos, especialmente para aplicações que:

• Abrem muitas conexões simultâneas
• Criam e fecham conexões com frequência
• Usam ambientes de computação serverless ou efêmeros

Para usar o pool de conexões, clique na opção via PgBouncer na parte superior do modal de conexão. Os detalhes da conexão serão atualizados para fazer com que suas conexões passem pelo pool de conexões, em vez de irem diretamente para o PostgreSQL.

Quando usar o PgBouncer

Use o PgBouncer quando sua aplicação abrir muitas conexões de curta duração. Para conexões de longa duração ou aplicações que usam recursos do PostgreSQL incompatíveis com pool de conexões (como prepared statements entre transações), conecte-se diretamente.

Não há suporte para mover dados para o ClickHouse usando ClickPipes via PgBouncer.

​

Configuração de TLS

Todas as instâncias do Managed Postgres são protegidas por TLS. A versão mínima compatível é TLS 1.3.

​

Conexão rápida (criptografada com TLS)

Por padrão, as conexões usam criptografia TLS sem verificação do certificado:

psql 'postgresql://postgres:[e-mail]:5432/postgres'

​

Conexão TLS verificada (recomendada para produção)

Para cargas de trabalho de produção, recomendamos se conectar com TLS verificado para garantir que você esteja se comunicando com o servidor correto. Para isso, baixe o pacote de certificados da CA na aba Settings e adicione-o aos certificados confiáveis do seu cliente de banco de dados.

O certificado da CA é exclusivo da sua instância do Managed Postgres e não funcionará com outras instâncias.

Para se conectar com uma conexão TLS verificada, adicione sslmode=verify-full e o caminho para o certificado baixado:

psql 'postgresql://postgres:[e-mail]:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'