Set up docs MCPAcessando os detalhes da conexão
Para conectar seus aplicativos ao ClickHouse 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 ClickHouse Managed Postgres
- Porta: A porta do PostgreSQL (padrão:
5432)
O ClickHouse 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 ClickHouse 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.
Configuração de TLS
Todas as instâncias do ClickHouse 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:PASSWORD@your-instance.pg.clickhouse.cloud: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 ClickHouse 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:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'