通用資料連結常見問題

1.1 版本

1.2 應用場景

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

問題描述：

範本預覽時，出現報錯介面，提示「錯誤程式碼：31300013 找不到資料連結」

排查步驟：

選中範本中的資料集，點選「編輯」。若左側資料連結表介面顯示「資料庫連結失敗」，說明資料連結存在問題。

點選「資料連結」按鈕，選擇對應資料連結，進行「測試連結」，根據報錯修改資料連結相關配置，直到連結成功。

問題描述：

範本預覽時，出現報錯介面，提示「錯誤程式碼：11300001 資料集配置錯誤」

排查步驟：

選中範本中的資料集，點選「編輯」。點選「資料集預覽」按鈕，若預覽報錯，說明SQL語句存在問題。

請根據報錯修改SQL語句，直到預覽成功。

問題描述：

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

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

原因分析：

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

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

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

解決方案：

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

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

問題描述：

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

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

5.1 檢查是否達到註冊限制

原因分析：

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

排查步驟：

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

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

解決方案：

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

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

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

原因分析：

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

排查步驟：

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

解決方案：

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

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

5.3 檢查遠端連結環境是否一致

原因分析：

一些特殊類型的資料集/資料連結，需要依賴插件實現。

遠端設計環境下，必須確定本地設計器和遠端工程都安裝了相關插件，才可以使用該資料集/資料連結。

排查步驟：

檢查是否為遠端設計環境，是否為依賴插件的資料連結類型，是否設計器和工程均安裝了插件。

解決方案：

請在設計器安裝與工程同版本插件後，再進行遠端設計。

問題描述：

填報提交時，彈窗報錯「[SQLITE_ERROR] SQL error or missing database (unrecognized token: "XXXX")」

即：發生SQL 錯誤或丟失資料庫（不可識別的字元：xxxx）

原因分析：

若確認SQL語句寫的無誤，那麼造成填報失敗的原因可能是，資料庫表欄位命名違反了資料庫的相關限制條件。

解決方案：

請檢查並修改資料庫表欄位命名。

在建立資料庫和表及欄位時，請務必嚴格按照對應資料庫指定的命名規則進行命名，否則可能會造成嚴重的後果。

本文將為大家列出一些常見的命名規則。

問題描述：
建立資料連結時，點選「測試連結」，報錯「未載入到驅動」，如下圖所示：

原因分析：

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

解決方案：

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

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

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

問題描述：

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

排查思路：

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

問題描述：

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

排查思路：

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

問題描述：

資料連結失敗，報錯：com.fr.data.operator.DataOperatorProvider.validateConnection

原因分析：

本地設計器與遠端伺服器環境不一致。

解決方案：

請參考文檔，確定本地設計器與遠端伺服器環境一致：JAR包、插件版本不匹配常見問題。