全局设置

定义数据库连接

全局设置用于维护可跨数据集或跨模板区域复用的资源。修改全局配置可能影响当前报表内的多个引用位置,保存前应检查数据集、检索栏和单元格表达式中的使用关系。

数据库连接配置包含“编码、名称、数据库类型、驱动、主机、端口、数据库名、用户名、密码、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

配置步骤:

  1. 打开“全局设置 → 定义数据库连接”,新增连接。
  2. 填写只包含字母和数字的连接编码;编码创建后不可直接修改。
  3. 选择预置数据库类型。选择“其他”时,还必须在下方输入框填写真实数据库类型,空值不能保存。
  4. 核对驱动、主机、端口、数据库名和自动生成的 URL;自定义类型需要手工填写驱动和 URL。
  5. 填写用户名和密码,点击“连接测试”。
  6. 连接测试成功后点击“确定”,再回到数据库查询数据集中选择该连接。

验证方法:“连接测试成功”只证明连接参数可用;仍需在数据集中执行一条最小 SQL 并预览,才能确认账号权限、Schema 和 SQL 方言满足报表需要。

常见问题:选择“其他”后,错误提示显示在自定义数据库类型输入框下。若连接失败,优先检查完整 JDBC URL、驱动类是否部署、账号权限和网络连通性,而不是反复修改连接编码。