Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

连接到 ClickHouse Managed Postgres

Beta

查看连接详细信息

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

点击左侧边栏中的 Connect 以查看连接详细信息

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

显示凭据和连接字符串格式的连接弹窗

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

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

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

连接字符串格式

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

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

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

PgBouncer 连接池

ClickHouse Managed Postgres 内置了一个 PgBouncer 实例,用于服务器端连接池。PgBouncer 有助于改善连接管理、提升性能和资源利用率,尤其适合以下应用程序:

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

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

TLS 配置

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

快速连接 (TLS 加密)

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

psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres'

已验证的 TLS 连接 (推荐用于生产环境)

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

从 Settings 选项卡下载 CA 证书

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

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

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