驱动管理- FineDataLink帮助文档

文档创建者：Roxy

历史版本：34

最近更新：Nikozhan 于 2025-02-28

1. 概述

版本	功能變動
-	-
4.0.14	SystemConfig.driverUpload 參數預設值修改為 true
4.1.5.1	新增驅動載入順序配置項
4.1.12.3	驅動管理按鈕位置、樣式優化
4.2.3.2	驅動 JAR 包大小限制 200MB

在 FDL 中配置資料連結時，一些資料庫需要上傳驅動才能連結成功。

FDL 中提供「驅動管理」按鈕，點選該按鈕，可在跳轉後頁面中上傳需要的驅動檔案。如下圖所示：

「驅動管理」使用的是熱載入，上傳驅動後不需要重啟 FDL 即可直接使用驅動。

1）只有超級管理者才能使用「驅動管理」功能。

2）4.2.3.2 及之後版本，驅動 JAR 包大小限制 200MB，若超出限制，則提示：上傳檔案失敗，檔案過大。

需要將 FineDB 資料庫中 fine_conf_entity 表欄位 SystemConfig.driverUpload 設定為 true：

預設狀態下參數值為false

1）正式工程中，FineDB 資料庫必須配置配置外接数据库，管理者可到「管理系統>系統管理>標準」中，查看配置的外接資料庫資訊。如下圖所示：

2）找到外接資料庫後，在 FDL 工程中建立外接資料庫的資料連結，建立資料連結步驟請參見：创建并管理数据源

若未配置外接資料庫，則需要使用 FineDataLink 連結內建資料庫，詳情參見：配置Hsql資料源

3）在資料開發模組中建立一個定時任務，拖入「資料同步」節點，在「資料來源」Tab 中，查詢外接資料庫中是否有 ID=SystemConfig.driverUpload 的欄位，如下圖所示：

注：不同資料庫語句可能不同，請根據實際情況調整。

select * from fine_conf_entity
where id='SystemConfig.driverUpload'

場景一：查詢結果為空

若查詢結果為空，需要再拖入一個「SQL 腳本」節點，新增 ID 為 SystemConfig.driverUpload，VALUE 為 true 的一條欄位，僅運作「SQL 腳本」節點。如下圖所示：

注：不同資料庫語句可能不同，請根據實際情況調整。

SQL 腳本如下所示：

INSERT INTO FINE_CONF_ENTITY (ID,VALUE)
VALUES('SystemConfig.driverUpload','true')

場景二：查詢結果為 false

若查詢結果值為 false，則需要修改為 VALUE 值為 true。

定時任務中再拖入一個「SQL 腳本」節點，使用 SQL 語句更新 VALUE 值，最後僅運作「SQL 腳本」節點。

UPDATE FINE_CONF_ENTITY SET FINE_CONF_ENTITY.VALUE = 'true'
WHERE ID='SystemConfig.driverUpload'

場景三：查詢結果為 true

若該筆資料 VALUE 值為 true，不需要進行操作，參考本文第三章上傳驅動即可。

4）向 fine_conf_entity 表中修改欄位值或新增欄位後，需要重啟 FDL 工程。重啟後再次登入工程，即可透過「驅動管理」功能上傳驅動。

預設開啟，直接參考本文第三章內容即可。

1）超級管理者進入 FDL 工程，點選「管理系統>資料連結管理>驅動管理」。如下圖所示：

2）點選「建立」按鈕，輸入驅動名稱後，點選「上傳檔案」按鈕，上傳驅動檔案；驅動檔案上傳成功後，選擇需要的驅動，設定驅動載入順序，點選「儲存」按鈕即可。如下圖所示：

注：資料庫驅動可以在對應資料庫的說明文檔下載，也可以讓資料庫管理者提供。

注意事項：

1）若有多個驅動 JAR 包，不清楚選擇哪個驅動，建議諮詢對應的資料庫管理者。

2）驅動管理上傳的驅動檔案儲存位置：

3）當遇到一些驅動導緻的問題後，可以快速修改驅動載入方式進而能夠實現快速的連結。預設選優先載入當前方式上傳驅動：

優先載入當前方式上傳驅動：先載入驅動管理的 jar：WEB-INF/drivers/hive/**.jar，若無對應檔案則載入應用的 jar：WEB- INF/lib/**.jar；
僅載入當前方式上傳驅動：僅載入驅動管理的 jar：WEB-INF/drivers/hive/**.jar。