1. 概述
1.1 版本
| 报表服务器版本 | JAR包版本 | 功能变动 |
|---|---|---|
| 10.0.15 | 2021-04-09 | 内置驱动更新 注：升级无法更新内置驱动 |
1.2 功能简介
MySQL 是一种开放源代码的关系型数据库管理系统（RDBMS），使用最常用的数据库管理语言——结构化查询语言（SQL）进行数据库管理。
2. 操作步骤
2.1 配置信息
| 驱动 | URL | 驱动下载链接 | 支持数据库类型 |
|---|---|---|---|
| com.mysql.jdbc.Driver 或 org.gjt.mm.mysql.Driver | jdbc:mysql://localhost:端口号/<数据库名> | FineReport 内置mysql-connector-java-5.1.49.jar 驱动包，无需下载 | MySQL8.0；MySQL_5.6.31；MySQL_5.5；MySQL_5.5.5；MySQL_5.6.35；MySQL_5.7；MySQL_5.6.37；MySQL_5.5.46；MySQL_6.5；MySQL_5.7.16；MySQL_5.6.29；MySQL_5.6.22；MySQL_5.6.34；MySQL_5.6.28；MySQL_5.1； |
官方建议：
为获得更好的取数性能，建议使用 Mysql5.5、5.6、5.7 版本的客户，更换 Mysql 数据库驱动为 5.1.37 版本为获得更好的取数性能。
驱动下载：mysql-connector-java-5.1.37.jar
2.2 放置驱动包
若是 10.0.15 及之后的版本，则跳过此步骤。
因为该数据连接使用 FineReport 自带的驱动包 mysql-connector-java-5.1.49-bin.jar ，不需要单独下载驱动包。
若是 10.0.15 之前的版本连接数据库，需要替换更新驱动包：mysql-connector-java-5.1.49-bin.jar
操作步骤如下：
1）删除%FR_HOME%\webapps\webroot\WEB-INF\lib下的 MySQL 连接驱动包：mysql-connector-java-5.1.39-bin.jar或mysql-connector-java-8.0.17.jar。
2）将下载好的驱动包拷贝到%FR_HOME%\webapps\webroot\WEB-INF\lib路径下，如下图所示：
3）重启报表服务器。
2.3 选择连接方式
FineReport 提供了两种数据连接方式：
方式一：在设计器中进行连接 ，具体方法请参见： [设计器]JDBC连接数据库 。
方式二：在数据决策平台进行连接。本文主要介绍此种方式。
2.4 新建数据连接
管理员登录数据决策系统，点击管理系统>数据连接>数据连接管理，点击新建数据连接，在常用选项下选择MySQL，如下图所示：
注：如果非管理员用户想要配置数据连接，需要管理员给其分配管理系统下数据连接节点的权限，具体操作请查看 数据连接控制。
按照本文 2.1 章节的配置信息格式，输入对应的数据连接信息。其中高级设置可选填，详情请参见：[平台]数据连接 。输入信息后界面如下图所示：
注：若出现中文乱码和日期错乱(填报&预览)的情况，可以修改 URL 为：
jdbc:mysql://localhost:端口号/<数据库名>?generateSimpleParameterMetadata=true&useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
serverTimezone=Asia/Shanghai -- 设置以"上海时区"为准
characterEncoding=utf8 -- 编码转化
有关 MySQL 数据库中文乱码问题详情请参见：MySQL数据库中文乱码
2.5 测试连接
点击测试连接，若弹出「连接成功」提示框，则表示成功连接上数据库，如下图所示：
模式选择后点击右上角的保存按钮，该数据连接即添加成功。如下图所示：
3. 注意事项
优先使用本文方案，若连接不上可尝试使用插件连接：[平台]MySQL8数据连接插件