全局设置用于维护可跨数据集或跨模板区域复用的资源。修改全局配置可能影响当前报表内的多个引用位置,保存前应检查数据集、检索栏和单元格表达式中的使用关系。
数据库连接配置包含“编码、名称、数据库类型、驱动、主机、端口、数据库名、用户名、密码、URL、方言和描述”。当前预置类型及默认驱动如下:
| 数据库类型 | 默认驱动 | 说明 |
|---|---|---|
| Oracle | oracle.jdbc.OracleDriver |
根据主机、端口和数据库名生成 JDBC URL |
| MySQL | com.mysql.cj.jdbc.Driver |
根据主机、端口和数据库名生成 JDBC URL |
| PostgreSQL | org.postgresql.Driver |
根据主机、端口和数据库名生成 JDBC URL |
| ClickHouse | com.clickhouse.jdbc.ClickHouseDriver |
根据当前连接信息生成 URL |
| OceanBase | 手工填写 | 需要按实际兼容模式填写驱动和 URL |
| dm | dm.jdbc.driver.DmDriver |
默认方言为 org.hibernate.dialect.DmDialect |
| 其他 | 手工填写 | 需要额外填写真实数据库类型、驱动和完整 URL |
配置步骤:
- 打开“全局设置 → 定义数据库连接”,新增连接。
- 填写只包含字母和数字的连接编码;编码创建后不可直接修改。
- 选择预置数据库类型。选择“其他”时,还必须在下方输入框填写真实数据库类型,空值不能保存。
- 核对驱动、主机、端口、数据库名和自动生成的 URL;自定义类型需要手工填写驱动和 URL。
- 填写用户名和密码,点击“连接测试”。
- 连接测试成功后点击“确定”,再回到数据库查询数据集中选择该连接。
验证方法:“连接测试成功”只证明连接参数可用;仍需在数据集中执行一条最小 SQL 并预览,才能确认账号权限、Schema 和 SQL 方言满足报表需要。
常见问题:选择“其他”后,错误提示显示在自定义数据库类型输入框下。若连接失败,优先检查完整 JDBC URL、驱动类是否部署、账号权限和网络连通性,而不是反复修改连接编码。

