資料庫連結失敗排查步驟

1.1 版本

1.2 應用場景

本文將列出在資料連結程式中，常見的問題及排查步驟。

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

• 檢查 URL 是否正確。

• 檢查雲資料庫白名單。

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

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

2.1 檢查URL是否正確

參考 資料連結支援範圍 ，找到對應資料庫正確的 URL 格式，檢查資料連結 URL 是否填寫正確。如下圖所示：

2.2 檢查防火牆

檢查資料庫是否給 BI 伺服器開啟了白名單。

2.3 資料連結自檢工具

注1：資料連結自檢工具僅提供給使用者自行判斷使用。技術支援不負責該工具的維護和使用問題解答。

注2：工具運作需 JDK 環境。

該工具可以檢查連結環境（資料庫和驅動）是否出現了問題，提供以下功能：

• 檢查資料庫功能(簡單模式)，包括：SQL 查詢、表資訊和可建立資料連結數等。

• 檢查資料庫功能(進階模式，支援外部驅動、Kerberos認證等)。

• 檢查工程依賴包/類的位置。

• 檢查資料庫網路情況，包括：遠端網路連結性檢查和本地 hostname 設定檢查。

2.3.1 安裝工具

點選下載並解壓獲得附件：fine-tester.zip

將附件中的fine-tester.jarcopy到任意目錄下(英文目錄，路徑中不要有空格等特殊字元)。如下圖所示：

2.3.2 啟動工具

啟動 cmd，進入fine-tester.jar所在目錄，執行java -jar fine-tester.jar，選擇需要檢查的功能。如下圖所示：

注：支援命令參數輸入url/使用者/密碼，如：java -jar fine-tester.jar url=jdbc:mysql://localhost:3306/test user=root password=xxx

2.3.3 檢查資料連結取數是否正常

1）輸入數字編號 1，選擇測試資料庫功能（簡單模式）後，根據提示輸入資料庫驅動代號、URL、帳號、資料庫密碼等。如下圖所示：

注：若自檢工具 fine-tester.jar 所在目錄中無資料庫驅動，需要手動輸入資料庫驅動的檔案路徑。

2）選擇「SQL 查詢和取數耗時」功能，輸入需要查詢的 SQL 語句。

若輸入 SQL 語句後，出現「SQL查詢耗時」，則表明小工具連結成功。若中途出現報錯，表明除 BI 外的資料庫連結環境有問題，需要檢查資料庫和資料庫驅動。

連結成功後，可以透過「建立連結耗時」和「SQL查詢耗時」這兩個時間對當前資料連結進行排查。如果是建立連結耗時過長，一般是網路通訊問題，如果是 SQL 查詢耗時較長就需要優化 SQL。如下圖所示：

2.3.4 檢查工程依賴包的位置

啟動工具後，輸入數字編號 3 進入「測試 java 類/包」模式，根據提示輸入資訊後，對工程依賴包的位置進行排查。如下圖所示：

2.4 檢查內建JDBC驅動版本

FineBI 包含了很多的內建驅動，這些驅動對應的 JDK 版本為 JDK1.8 。在使用程式中，必須確定驅動與 JDK 版本的一致。

若使用內建驅動，則環境 JDK 需為 1.8 版本；若不想更換環境的 JDK 版本，則需要去工程路徑%FineBI%/webapps/webroot/WEB-INF/lib下，更換與環境 JDK 一致的驅動版本。

內建驅動和匹配 JDK 版本如下表所示：

如環境 JDK 版本為 1.7 ，想要連結 SQL Server 資料庫，但是版本與內建驅動不匹配，需將 SQL Server 的驅動 sqljdbc41.jar copy至上述目錄，並刪除 sqljdbc42.jar 。

問題描述：

1）使用者新增資料連結時報錯「當前資料連結數量已達到註冊lic限制(x個)，無法新增」。如下圖所示：

2）管理者進入資料連結管理頁面時，報錯「當前資料連結數量已超過註冊lic限制（x個），所有資料連結不可用，請刪除多餘的資料連結」。如下圖所示：

3）資源遷移時，報錯“當前資料連結數量已達到註冊lic限制（x個），無法匯入”

原因分析：

工程註冊時，會對資料連結數進行限制。若達到限制值，則會出現報錯或異常狀態。

超級管理者登入數據決策系統，在當前頁下存取http://IP:埠/webroot/decision/v10/register/info/license，即可查看註冊時的限制值。

若資料連結數達到限制值，則將無法新增資料連結，新新增的資料連結不顯示。

解決方案 1：刪除系統中多餘的資料連結，不讓資料連結的數量超過註冊 lic 的限制，即可新增資料連結。

解決方案 2：如果使用者實在需要超過限制的資料連結，可以重新註冊，提高資料連結數量的限制。詳情請參見：本地機器資訊認證

問題描述：

1）資料連結異常消失：如重啟消失，註冊後消失，突然消失等。

2）建立/更新資料連結後，儲存異常，儲存不上等。

4.1 檢查是否達到註冊限制

原因分析：

工程註冊時，會對資料連結數進行限制。若達到限制值，則可能會導致系統中超限的資料連結消失。

排查步驟：

超級管理者登入數據決策系統，在當前頁下存取http://IP:埠/webroot/decision/v10/register/info/license，即可查看註冊時的限制值。

若資料連結數達到限制值，則將無法新增資料連結，新新增的資料連結不顯示。

解決方案：

1）刪除系統中已有的無用的資料連結，即可新增資料連結。

2）聯絡帆軟銷售增購資料連結數量。

4.2 檢查外接資料庫是否共用

原因分析：

多個工程共用同一個外接資料庫時，可能會導致A工程中的配置被B工程改寫，進而引起資料連結異常消失的情況。

排查步驟：

檢查是否存在其他工程使用同一個外接資料庫。

解決方案：

若確實共用，請先將當前外接資料庫備份。

將其中一個工程的外接資料庫進行遷移，詳情請參見：配置外接資料庫

問題描述：

建立資料連結時，點選「測試連結」，報錯未載入到驅動

原因分析：

工程中不存在該資料連結所使用的驅動器。

解決方案：

對於外網使用者，可直接透過提示介面中的超連結，跳轉到對應驅動下載的說明文檔。

對於內網使用者，請根據您的資料庫和驅動類型，自行選擇對應文檔，下載並放置驅動：資料連結支援範圍

驅動安裝完畢後，重新嘗試連結即可。

問題描述：

工程日誌中存在報錯資訊「NoClassFoundException」

排查思路：

工程中不存在該資料連結所使用的驅動器，或者驅動有問題

問題描述：

工程日誌中存在報錯資訊「NoClassDefFoundError」

排查思路：

工程下可能存在衝突的驅動包。

問題描述：

資料連結取數正常，但左右合併時報錯：No database selected

原因分析：

FineBI6.0.15以下版本，資料連結URL缺少資料庫表空間名稱，即使可以正常儲存資料連結，但會造成該報錯

解決方案：

1）建議升級FineBI工程至6.0.15及以上版本，可徹底解決該問題

2）如無法升級FineBI，請手動修改相關資料連結的URL，加上資料庫表空間名稱。