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:埠/ | 插件內建 mysql-connector-java-8.0.20.jar 驅動包，無需下載 | 8.0.20 |
使用者如果想要連結 MySQL8 其他小版本，可以更換驅動包進行嘗試，詳情請參見：3. 更換驅動包
注：增加參數「&serverTimezone=UTC」是為了防止時區導致的資料庫亂碼問題，其中 UTC 為世界標準時，即零時區。若使用者使用的系統、報表伺服器等使用的時間是北京時區也就是東八區，此時會出現在 FineBI 資料預覽介面的資料時間比資料庫中時間快八小時，可修改參數為 &serverTimezone=GMT%2B8 ，其中「GMT%2B8」為北京時間東八區。即可保證資料庫中時間欄位與 FineBI 資料預覽介面時間欄位一致。
2.3 連結資料庫
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」檔案，並將下載的驅動包copy到該路徑下
3）換好驅動後，重啓設計器工程，對照 2.2 節、2.3 節連結資料庫即可。