PostgreSQL

在连接器的 访问内容 → 添加访问 中，在 原生资源 里选择 PostgreSQL。只填写一个数据库实例的连接信息；集群的多个节点不能在一个地址中用逗号拼接。保存后，ZAI 用 PostgreSQL 客户端或程序访问这个数据库。

服务地址

目标地址 填写数据库实例的连接 host，例如 <数据库域名>，不粘贴带密码的连接串。云数据库可以在实例的连接信息或数据库连接页面查看地址；自建数据库向数据库管理员获取。

端口 默认为 5432；数据库监听其他端口时填写实际值。内网地址需要所属连接器指定网络隧道，或匹配可用的内网路由。

账号与密码

向数据库管理员获取专用于此用途的数据库账号与密码，或者由有管理权限的人创建账号，并授予需要的数据库、schema 和表权限。用户名是数据库账号，不是 Z Tag 控制台的登录账号。

只读用途应使用数据库侧的只读权限。连接器不会把高权限数据库账号自动变成只读账号。密码只由平台使用，不会交给 ZAI。

官方说明：PostgreSQL 账号管理。

数据库名

填写账号需要访问的数据库名称，例如 <数据库名>。它不是实例显示名称，也不是表名。PostgreSQL 的 schema 属于数据库内部对象，应通过 SQL 的 schema 限定或 search_path 使用。ZAI 只能连接这里填写的数据库；需要访问另一个数据库时，另建一份凭证。

TLS

默认 验证服务器证书，连接地址应与证书中的主机名一致。仅在服务器明确不支持 TLS 且网络条件允许时选择 不使用 TLS；此时到数据库的连接不加密，CA 证书字段会隐藏，填过的 CA 也不会提交。

CA 证书

服务器使用公有受信任 CA 时通常可以留空。自建 CA 或云数据库专用 CA，从数据库管理员或该数据库服务的官方控制台取得，填写 PEM 格式的 CA 证书链。证书链只保留 BEGIN CERTIFICATE / END CERTIFICATE 证书块，证书之间只留换行，块外的说明文字会导致保存失败。这里不填写数据库密码、客户端私钥或 SSH 主机公钥。

验证

保存后，请 ZAI 先对这个数据库执行 SELECT 1，再查询一张已授权的业务表。只能连接但不能查询时，检查数据库权限；证书验证失败时，检查地址、证书有效期与 CA。其余排查见验证与排错。

编辑地址、数据库名和 TLS 配置会保留原密码，替换凭证 用于更新密码。保存成功不代表连接可用，请按上面的步骤验证。