PolarDB MySQL / PolarDB PostgreSQL 数据源配置指南
概述
在 Lakehouse Studio 中，PolarDB 数据源分为两个独立的数据源类型：
- PolarDB MySQL
- PolarDB PostgreSQL
创建数据源时，需要根据源端实例实际使用的数据库引擎选择对应类型。虽然两者都属于 PolarDB 产品族，但连接协议、默认数据库语义和部分参数习惯并不相同，不能混用。
选择哪一种 PolarDB 数据源
如果你的 PolarDB 实例兼容 MySQL，请选择 PolarDB MySQL；如果实例兼容 PostgreSQL，请选择 PolarDB PostgreSQL。
在数据同步任务页面中，这两个数据源类型也会分别展示。例如，多表离线同步、多表实时同步中的可选源端会分别列出 PolarDB MySQL 和 PolarDB PostgreSQL。
参数配置
PolarDB MySQL 和 PolarDB PostgreSQL 的参数有细微差异，以下分别列出。
PolarDB MySQL
- 数据源名称：建议在名称中体现业务系统与环境信息，便于识别。
- JDBC 连接地址：示例
。jdbc:mysql://host:3306/database - 用户名：用于访问 PolarDB 实例的账号。
- 密码：对应账号的登录密码。
- 允许使用配置信息连接所有数据库/Schema：启用后，可在任务中复用当前连接信息访问更多数据库或 Schema；如需严格控制访问范围，建议关闭。
- 通过 SSH Tunnel 连接：（可选）当源端位于受限网络时启用。需补充 SSH 服务地址、端口、用户名和认证信息。
- 数据库时区：选择源端数据库使用的时区，确保同步时的时间字段对齐。
- 数据源描述（可选）：补充用途、来源系统或维护说明。
- 可用工作空间：设置该数据源授权给哪些工作空间使用。可以指定工作空间，也可以授权给全部工作空间。
PolarDB PostgreSQL
- 数据源名称：建议在名称中体现业务系统与环境信息，便于识别。
- JDBC 连接地址：示例
。jdbc:postgresql://host:5432/database - 用户名：用于访问 PolarDB 实例的账号。
- 密码：对应账号的登录密码。
- Schema：指定默认访问的 Schema 名称。
- 允许使用配置信息连接所有数据库/Schema：启用后，可在任务中复用当前连接信息访问更多数据库或 Schema；如需严格控制访问范围，建议关闭。
- 通过 SSH Tunnel 连接：（可选）当源端位于受限网络时启用。需补充 SSH 服务地址、端口、用户名和认证信息。
- 数据库时区：选择源端数据库使用的时区，确保同步时的时间字段对齐。
- 数据源描述（可选）：补充用途、来源系统或维护说明。
- 可用工作空间：设置该数据源授权给哪些工作空间使用。可以指定工作空间，也可以授权给全部工作空间。
配置建议
- 按引擎建连接：不要把 PolarDB MySQL 和 PolarDB PostgreSQL 当成同一种数据源复用。
- 先确认默认访问范围：如果任务只访问单个库或固定 Schema，建议将连接范围收敛到最小。
- 环境分开管理：生产与测试环境建议分别创建数据源，避免任务误连。
测试与使用
保存前，建议先执行连接测试，确认网络、账号和默认访问范围配置正确。保存成功后，即可在支持的同步任务中选择对应的 PolarDB MySQL 或 PolarDB PostgreSQL 数据源。
具体任务支持范围请参考数据源支持范围。
相关文档
联系我们