資料連結-驅動管理

1.1 版本

1.2 應用場景

在連結 FineReport 和資料庫時，可能會因為産品未內建對應版本的資料庫驅動而連結失敗。這時候使用者可使用「驅動管理」功能，上傳對應的驅動。「驅動管理」使用的是熱載入，上傳驅動後不需要重啟 FineReport 即可直接使用驅動 。

1.3 功能簡介

用戶可使用「驅動管理」功能，上傳對應的驅動。「驅動管理」使用的是熱載入，上傳驅動後不需要重啟 FineReport 即可直接使用驅動 。

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

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

• 僅載入當前方式上傳驅動：僅載入驅動管理的jar：WEB-INF/drivers/hive/**.jar。

1.4 使用需知

若使用者對工程安全性要求很高，建議您不需要上傳驅動的時候，關閉驅動管理的上傳功能，等要用的時候再開啟。

使用者可以透過參數 SystemConfig.driverUpload 允許或禁止上傳，具體操作教程可參見：管理平台應用-FINE_CONF_ENTITY視覺化配置

• 更改參數值為 true ：允許透過驅動管理上傳驅動。

• 更改參數值為 false：（預設狀態下參數值為false）禁止透過驅動管理上傳驅動。上傳時會報錯：不允許上傳驅動jar包，可以修改SystemConfig.driverUpload配置值開啟該功能。
  

進入數據決策系統，點選「管理系統」→「資料連結管理」→「驅動管理」，如下圖所示。

2.1 上傳資料庫驅動

1）點選「建立驅動」，輸入名稱方便之後與其他驅動區分。這裏我們要上傳 PostgreSQL 的驅動，可以命名為「postgresql驅動」，如下圖所示：

2）點選「上傳檔案」，將資料庫驅動上傳上去。如下圖所示：

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

3）點選「下拉」按鈕，選擇一個剛剛上傳的驅動，點選「儲存」，如下圖所示：

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

注2：若有多個驅動jar包，不清楚選擇哪個驅動，可以諮詢對應的資料庫管理者。

2.2 使用資料庫驅動

1）在「資料連結管理」介面，建立一個 Postgresql 資料連結，如下圖所示：

2）驅動選擇「自訂」，在後方下拉選擇剛剛上傳的 postgresql驅動 ，並填入其他連結資訊，詳細請參見 Postgresql資料連結 。如下圖所示：

3）點選測試連結，可以看到資料庫可以成功連結，如下圖所示：

2.3 刪除驅動

若要刪除某個已存在的資料庫驅動，可進入驅動管理介面直接點選「刪除」按鈕，如下圖所示：

11.0.1及之前版本，無驅動管理功能，使用者如需上傳驅動，可透過手動上傳的方法。

將下載好的驅動包copy到%FR_HOME%\webapps\webroot\WEB-INF\lib路徑下，重啟報表伺服器後驅動生效。如下圖所示。

注：若重啟後驅動不生效，可能是由於在該目錄下存在該驅動的其他版本，需要手動刪除其他版本，以防沖突。