Skip to content

PostgreSQL

接入 PostgreSQL 数据库,或任何使用 PostgreSQL 线协议的引擎,进行联邦分析。表被挂载进查询引擎,可与其他连接器的 数据集联接。

适用场景

  • 生产型或分析型 PostgreSQL 数据库。
  • PostgreSQL 协议兼容引擎:ClickHouse(通过其 PostgreSQL 协议端口)与 CockroachDB 均可通过本连接器接入—— 将其指向 PostgreSQL 协议端点即可。

分析量大时建议使用只读副本,以免长查询与生产流量争抢资源。

准备工作

准备一个数据库角色,具备:

  • 只读权限:对数据库的 CONNECT、对目标 schema 的 USAGE、对目标表的 SELECT
  • 从 Datyo 到数据库的网络连通性。若位于私有网络中,请放通来自服务的入站访问,或提供可访问的副本。

连接配置

字段必填说明
Host数据库主机名或地址,如 db.example.com
Port默认 5432
User角色名。建议使用只读角色。
Password加密存储,保存后不再显示。
Database要连接的数据库。从可访问的 schema 读取表。

测试与保存

选择类型、填写字段,点击测试连接。成功后数据集保存,状态经历「同步中 → 已连接」;失败会给出具体原因。连接后 选择要导入的表。

能力与限制

  • 执行模型: 联邦。PostgreSQL 表可与其他连接器的数据集联接。
  • 访问: 只读,写语句被拒绝。
  • Schema: 角色可访问的各 schema 下的表均可导入。

常见排错

  • 测试连接失败——检查主机与端口、角色与密码,以及数据库是否存在。
  • 缺少某个 schema 或表——为该 schema 授予 USAGE、为该表授予 SELECT;角色能看到对象才会被列出。
  • SSL 要求——若服务器强制 SSL,请确认账号被允许通过 SSL 连接。

提升回答准确度

  • 为业务字段补充列描述
  • 表结构变更后重新同步。

相关

Datyo · Agent 原生的智能数据分析底座