1. 概述
1.1 版本
| FineBI 版本 | JAR 包 |
|---|---|
| 5.1.8 | 2020-12-04 |
1.2 介绍
MySQL 是一种开放源代码的关系型数据库管理系统（RDBMS），使用最常用的数据库管理语言——结构化查询语言（SQL）进行数据库管理。
安装本篇介绍的「MySQL8 数据连接」插件，可以直接连接 MySQL8 数据库。
1.3 功能介绍
本文仅适用于 5.1.8 之后的 FineBI，5.1.8 之前的 FineBI 若要连接 MySQL8 数据库请参见：JDBC 连接 MySQL8.0
2. 操作步骤
2.1 安装插件
1）点击下载插件：mysql8-1.0.0.zip
2）插件安装方法请参见：插件管理
2.2 配置信息
| 驱动 | URL | 驱动下载 | 支持数据库版本 |
|---|---|---|---|
| com.mysql.cj.jdbc.Driver | jdbc:mysql://ip:端口/<数据库>?useSSL=false&serverTimezone=UTC | 插件内置 mysql-connector-java-8.0.20.jar 驱动包，无需下载 | 8.0.20 |
用户如果想要连接 MySQL8 其他小版本，可以更换驱动包进行尝试，详情请参见：3. 替换驱动包
注：增加参数「&serverTimezone=UTC」是为了防止时区导致的数据库乱码问题，其中 UTC 为世界标准时，即零时区。若用户使用的系统、报表服务器等使用的时间是北京时区也就是东八区，此时会出现在 FineBI 数据预览界面的数据时间比数据库中时间快八小时，可修改参数为 &serverTimezone=GMT%2B8 ，其中「GMT%2B8」为北京时间东八区。即可保证数据库中时间字段与 FineBI 数据预览界面时间字段一致。
2.2 连接数据库
1）管理员登录 FineBI ，点击「管理系统>数据连接>数据连接管理>新建数据连接>所有」，选择「MySQL8」如下图所示：
2）按照 2.2 节的配置信息，填写对应栏。如下图所示：
3）点击「测试连接」，若显示“连接成功”，则点击「保存」，如下图所示：
至此就连接成功啦！
3. 替换驱动包
若用户使用的是 MySQL8 的其余小版本，可以尝试更换一下驱动包。
由于 MySQL8 小版本繁多，更换驱动包后也不能全部保证连接无误，所以有条件的用户建议直接使用 MySQL 8.0.20 版本。
3.1 操作步骤
1）关闭 FineBI 工程。
2）从 MySQL官网 下载对应当前 MySQL 小版本的连接驱动包。以 MySQL 8.0.17 版本为例，下载驱动包 mysql-connector-java-8.0.17.jar
3）删除%FineBI5.1%\webapps\webroot\WEB-INF\plugins\plugin-com.fr.plugin.connection.mysql8-1.0.0下的「mysql-connector-java-8.0.20」文件，并将下载的驱动包拷贝到该路径下
3）换好驱动后，重启设计器工程，对照 2.2 节、2.3 节连接数据库即可。
