1. 概述
1.1 版本
报表服务器版本 | 功能变动 |
---|---|
11.0 | - |
11.0.1 | 更改上传数据库驱动包的方式:通过「驱动管理」上传,实现热加载 |
1.2 应用场景
本文将介绍如何连接 MySQL 数据库。
2. 准备工作
2.1 版本和驱动
下载驱动,并将其上传至 FineReport,如何上传可参见:驱动管理 2.1 节
支持的数据库版本 | 驱动下载链接 |
---|---|
V5.1 V5.5、V5.5.5、V5.5.46 V5.6.22、V5.6.28、V5.6.29、V5.6.31、V5.6.34、V5.6.35、V5.6.37 V5.7、V5.7.16 V6.5 V8.0 | FineReport 内置mysql-connector-java-5.1.49.jar 驱动包 其他版本驱动下载地址:MySQL驱动下载地址 官方建议: 为获得更好的取数性能,建议使用 Mysql5.5、5.6、5.7 版本的客户,更换 Mysql 数据库驱动为 5.1.37 版本为获得更好的取数性能。(5.1.37 版本的驱动不支持 V5.1、V8.0 的数据库) |
2.2 收集连接信息
在连接数据库之前,请收集以下信息:
数据库所在服务器的 IP 地址和端口号;
数据库的名称;
数据库的用户名和密码;
3. 具体连接步骤
FineReport 提供了两种数据连接方式:
方式一:在设计器中进行连接 ,具体方法请参见: [设计器]JDBC连接数据库 。
方式二:在数据决策平台进行连接。本文主要介绍此种方式。
1)以管理员身份登录数据决策系统,点击「管理系统>数据连接>数据连接管理」,点击「新建数据连接」,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接权限
2)找到 MySQL 的图标,如下图所示:
3)驱动选择「默认」(若用户重新上传了驱动,可以切换为自定义后选择自己的驱动),然后输入 2.2 节的连接信息。如下图所示:
注:若出现中文乱码或日期错乱的情况,可在「数据连接URL」后加后缀,格式为:jdbc:mysql://hostname:port/database?generateSimpleParameterMetadata=true&useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
其中
serverTimezone=Asia/Shanghai -- 设置以"上海时区"为准
characterEncoding=utf8 -- 编码转化
4)点击「测试连接」,若连接成功则「保存」该连接。如下图所示:
4. 添加数据库的表至 FineReport
详情请参见:数据集