1. 概述
1.1 問題現象
FineBI 產品功能日益增強,適配資料庫的種類也越來越多。如何檢查這些資料庫的連結問題也變的繁瑣和頭疼,本篇文章為使用者介紹三種資料庫連結失敗時的自檢辦法。
1.2 原因分析
資料庫連結不上可能是連結資訊填寫錯誤,也可能是資料庫連結環境的問題。本文根據以上原因提供三種排查思路和方式:
檢查 URL 是否正確。
運作測試小工具,檢查除 BI 外的連結環境是否有問題,包括資料庫和資料庫驅動。
查看後臺報錯日誌,檢查是否是資料庫驅動與 BI 之間有 JAR 包衝突。
2. 解決方案
2.1 檢查URL是否正確
資料庫連結失敗有一種可能是連結資訊填寫錯誤。參考 資料庫連結支援範圍 ,找到對應資料庫正確的 URL 格式,檢查 URL 是否填寫正確。如下圖所示:
2.2 檢查防火牆
檢查資料庫是否有給 BI 伺服器開啓白名單。
2.3 資料連結自檢工具
該工具可以檢查連結環境(資料庫和驅動)是否出現了問題。
2.3.1 安裝工具
下載附件 测试连接.rar
將附件裏的 bootstrap.jar、fine-test.jarcopy到任意目錄下(英文目錄,路徑中不要有空格等特殊字元),然後將對應的資料庫驅動也copy到這個目錄下。如下圖所示:
2.3.2 啟動工具
1)啟動 cmd,在此 JAR 包所在目錄下執行java -jar bootstrap.jar,並根據提示輸入 1,如下圖所示:
2)根據提示輸入資料庫驅動代號、URL、帳號、資料庫密碼等,如下圖所示:
2.3.3 自檢排查
若輸入要查詢的 SQL 語句後,出現「sql查詢耗時」,則表明小工具連結成功。若中途出現報錯,表明除 BI 外的資料庫連結環境有問題,需要檢查資料庫和資料庫驅動。
2.4 驅動隔離插件
查看 FineBI 的系統報錯日誌(報錯日誌路徑:%FineBI%/logs/fanruan.log)。若日誌中有以下三種報錯之一:NoClassFoundException、NoClassDefFoundError、NoSuchMethodError,那麼資料庫驅動的 JAR 包和 FineBI 自帶的 JAR 包之間可能有衝突,需要安裝驅動隔離插件。
2.4.1 如何安裝驅動隔離插件
2020-01-15 發佈的 5.1 版本請參考 2020-01-15 版本驅動隔離插件。
2020-01-15 之前的版本請參考 驅動隔離插件。