> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

<div id="accessing-connection-details">
  ## Acessando os detalhes da conexão
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/connect-button.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=93096ebe1a3110be10ce7614fd000114" alt="Clique em Connect na barra lateral esquerda para ver os detalhes da conexão" size="md" border width="1378" height="1148" data-path="images/managed-postgres/connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/connect-modal.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=dd99b70c6babef97cbeadc62972592b8" alt="Modal de conexão mostrando credenciais e formatos de string de conexão" size="md" border width="1910" height="1728" data-path="images/managed-postgres/connect-modal.png" />

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.

<div id="connection-string">
  ## Formatos da string de conexão
</div>

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.

<div id="pgbouncer">
  ## Pool de conexões com PgBouncer
</div>

O Managed Postgres inclui uma instância integrada do [PgBouncer](https://www.pgbouncer.org/) 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.

<Tip>
  **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.
</Tip>

<div id="tls">
  ## Configuração de TLS
</div>

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

<div id="quick-connection">
  ### Conexão rápida (criptografada com TLS)
</div>

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

```bash theme={null}
psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres'
```

<div id="verified-tls">
  ### Conexão TLS verificada (recomendada para produção)
</div>

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.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/tls-ca-bundle.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=f58b3f968ae2252da06d3c490c5512cd" alt="Baixar certificado da CA na aba Settings" size="md" border width="3244" height="2028" data-path="images/managed-postgres/tls-ca-bundle.png" />

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:

```bash theme={null}
psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'
```
