資料庫連結失敗排查步驟

1.1 問題現象

FineBI 產品功能日益增強，適配資料庫的種類也越來越多。如何檢查這些資料庫的連結問題也變的繁瑣和頭疼，本篇文章為使用者介紹三種資料庫連結失敗時的自檢辦法。

1.2 原因分析

資料庫連結不上可能是連結資訊填寫錯誤，也可能是資料庫連結環境的問題。本文根據以上原因提供三種排查思路和方式：

• 檢查 URL 是否正確。

• 運作測試小工具，檢查除 BI 外的連結環境是否有問題，包括資料庫和資料庫驅動。

• 查看後臺報錯日誌，檢查是否是資料庫驅動與 BI 之間有 JAR 包衝突。

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 之前的版本請參考 驅動隔離插件。