> ## 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.

# 连接到 Managed Postgres

> 用于 ClickHouse Managed Postgres 的连接字符串、PgBouncer 连接池和 TLS 配置

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">
  ## 查看连接详细信息
</div>

要将应用程序连接到 Managed Postgres，请前往实例左侧边栏中的 **Connect** 视图。

<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="点击左侧边栏中的 Connect 以查看连接详细信息" size="md" border width="1378" height="1148" data-path="images/managed-postgres/connect-button.png" />

点击 **Connect** 会打开一个连接弹窗，以多种格式显示连接凭据和连接字符串。

<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="显示凭据和连接字符串格式的连接弹窗" size="md" border width="1910" height="1728" data-path="images/managed-postgres/connect-modal.png" />

连接弹窗会显示以下信息：

* **用户名**：数据库用户 (默认：`postgres`)
* **密码**：数据库密码 (默认隐藏，点击眼睛图标即可显示)
* **Server**：Managed Postgres 实例的主机名
* **Port**：PostgreSQL 端口 (默认：`5432`)

Managed Postgres 为数据库提供 superuser 访问权限。请使用这些凭据以 superuser 身份连接，这样您就可以创建其他用户并管理数据库对象。

<div id="connection-string">
  ## 连接字符串格式
</div>

**连接方式**选项卡会以多种格式提供您的连接字符串，以满足应用程序的要求：

| 格式       | 说明                                                                       |
| -------- | ------------------------------------------------------------------------ |
| **url**  | 采用 `postgresql://<USER>:<PASSWORD>@<HOST>:<PORT>/<DATABASE>` 格式的标准连接 URL |
| **psql** | 可直接使用的命令，用于通过 psql 命令行工具连接                                               |
| **env**  | 适用于基于 libpq 的客户端的环境变量                                                    |
| **yaml** | YAML 格式的配置                                                               |
| **jdbc** | 适用于 Java 应用程序的 JDBC 连接字符串                                                |

出于安全考虑，连接字符串中的密码默认会被遮盖。点击任意字段或连接字符串旁边的复制图标，即可直接将其复制到剪贴板。

<div id="pgbouncer">
  ## PgBouncer 连接池
</div>

Managed Postgres 内置了一个 [PgBouncer](https://www.pgbouncer.org/) 实例，用于服务器端连接池。PgBouncer 有助于改善连接管理、提升性能和资源利用率，尤其适合以下应用程序：

* 打开大量并发连接
* 频繁创建和关闭连接
* 使用无服务器或临时性计算环境

要使用连接池，请点击连接弹窗顶部的 **通过 PgBouncer** 切换开关。连接详情将更新为通过连接池转发连接，而不是直接连接到 PostgreSQL。

<Tip>
  **何时使用 PgBouncer**

  如果你的应用程序会建立大量短生命周期连接，请使用 PgBouncer。对于长时间保持的连接，或者使用了与连接池不兼容的 PostgreSQL 功能 (例如跨事务的预处理语句) 的应用程序，请直接连接。

  不支持通过 PgBouncer 使用 ClickPipes 将数据导入 ClickHouse。
</Tip>

<div id="tls">
  ## TLS 配置
</div>

所有 Managed Postgres 实例均受 TLS 保护。支持的最低版本为 **TLS 1.3**。

<div id="quick-connection">
  ### 快速连接 (TLS 加密)
</div>

默认情况下，连接会使用 TLS 加密，但不会验证证书：

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

<div id="verified-tls">
  ### 已验证的 TLS 连接 (推荐用于生产环境)
</div>

对于生产环境中的 workloads，我们建议使用已验证的 TLS 连接，以确保你连接的是正确的 server。为此，请在 **Settings** 选项卡中下载 CA 证书包，并将其添加到数据库客户端的受信任证书中。

<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="从 Settings 选项卡下载 CA 证书" size="md" border width="3244" height="2028" data-path="images/managed-postgres/tls-ca-bundle.png" />

该 CA 证书是你的 Managed Postgres 实例 专属的，不能用于其他 实例s。

要建立已验证的 TLS 连接，请添加 `sslmode=verify-full` 以及已下载证书的 path：

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