手动修改fine_conf_entity

1.1 版本

1.2 應用場景

平台中的大部分的配置項都儲存在 FineDB 中的 fine_conf_entity 表中。

部分配置項未提供前台配置介面，或無法透過 fine_conf_entity視覺化配置 進行修改，只能透過修改 fine_conf_entity 表的方式進行更改。

注1：修改 FineDB 檔案，有可能造成不可修復的 BUG，因此非必要請勿修改 FineDB 檔案。

注2：請優先使用前台配置介面或 fine_conf_entity視覺化配置 方式修改配置項。

本文使用一個簡單的範例來示範如何修改 FINE_CONF_ENTITY 的表欄位。

提示:

範例：修改 FineDB 中 fine_conf_entity 表中的 PluginFileValidateConfig.fileValidateOpen 欄位，將欄位值改為 true（使用者根據實際需要選擇欄位進行修改）

2.1 實現思路

步驟：

1）備份平台配置。

2）連結 FineDB 資料庫，獲取需要修改的 fine_conf_entity 表。

3）查詢 fine_conf_entity表中是否存在配置項，根據查詢結果選取不同的修改方案，並進行相應修改。

4）重啟工程。

2.2 備份平台配置

建議在修改 fine_conf_entity 的表欄位前，透過手動或自動的方式備份平台配置項，備份方式請參考：備份還原 。外接資料庫一般不需要備份，如需備份請透過對應的資料庫完成備份操作。

以手動備份平台配置為例，管理者登入 FineDataLink 資料平台，在「管理系統>智慧維運>備份還原>平台配置」中選中手動備份。

預設備份路徑為：../backup，備份檔案儲存在工程的 %FineDataLink%/webapps/webroot/backup資料夾下，如下圖所示：

2.3 建立資料連結

2.3.1 獲取 FineDB 資料庫資訊

管理者登入 FineDataLink 資料平台，點選「管理系統>系統管理>標準」。

• 若外接資料庫顯示「待配置」，則內建 FineDB 資料庫資訊可參見：FineDB 資料連結

• 若外接資料庫顯示「已配置」，點選即可查看外接 FineDB 資料庫的資訊。

2.3.2 連結 FineDB 資料庫

建立一個資料連結，資料連結名稱為 FineDB，資料庫相關配置資訊可根據 2.3.1 節獲取。如下圖所示：

2.4 修改 fine_conf_entity

2.4.1 查詢欄位

首先使用「資料同步」節點，查詢是否存在 ID = XX（根據實際情況選擇欄位修改，本文範例為修改 ID=PluginFileValidateConfig.fileValidateOpen 的值） 的欄位。

1）建立一個定時任務，如下圖所示：

2）將一個「資料同步」節點拖到設計介面，點選該節點進行設定。

資料源類型選擇「HSQL」，資料連結選擇「FineDB」，填寫以下 SQL 語句：

注1：不同資料庫語句可能不同，請根據實際情況調整；根據實際情況選擇 ID 進行修改。

注2：本節以內建 HSQL 類型的 FineDB 資料庫進行示範，使用者若配置了外接資料庫，可根據自身情況選擇相應的資料源類型與資料連結。

select * from fine_conf_entity
where id='PluginFileValidateConfig.fileValidateOpen'

點選資料預覽，查詢是否存在所需欄位，如下圖所示：

2.4.2 修改欄位

若查詢結果為空：

注1：本節適用於 2.4.1 節查詢結果為空，即 fine_conf_entity 表中不存在所需配置項的情況，如下圖所示：

注2：工程 fine_conf_entity表中預設不存在部分配置項的記錄，需手動新增相關記錄並重啟工程後生效。

建立一個定時任務，使用「 SQL 腳本」節點，新增 ID 為 PluginFileValidateConfig.fileValidateOpen，VALUE 為 true 的一條欄位，儲存並運作任務，如下圖所示：

注：不同資料庫語句可能不同，請根據實際情況調整。

SQL 腳本如下所示：

INSERT INTO fine_conf_entity (ID,VALUE)
VALUES('PluginFileValidateConfig.fileValidateOpen','true')

若查詢結果不為空：

注：本節適用於 2.4.1 節查詢結果不為空，即 fine_conf_entity 表中存在所需配置項，且需要修改 VALUE 值的情況，如下圖所示：

建立一個定時任務，使用「 SQL 腳本」節點，修改該條記錄的 VALUE 值為 true，儲存並運作任務，如下圖所示：

SQL腳本如下所示：

UPDATE FINE_CONF_ENTITY SET FINE_CONF_ENTITY.VALUE = 'true'
WHERE ID='PluginFileValidateConfig.fileValidateOpen'

SQL 腳本執行成功後，重啟工程，修改生效。

4.1 還原平台配置

若使用者在修改欄位值後未出現預期效果，想要還原平台配置，可登入 FineDataLink 資料平台對本文 2.2 節的備份檔案進行還原，詳情請參考：还原 。

如果採用的是外接資料庫，可以透過連結外接資料庫的方式，恢復或移除增加的配置項。如果外接資料庫執行了備份操作，可以透過對應資料庫的備份恢復之前的配置。

4.2 修改後無法登入資料平台

注：如果使用者在修改表欄位前無法登入 FineDataLink 資料平台，使用以下步驟重置平台配置無效。

如果出現在修改 FINE_CONF_ENTITY 表欄位前能夠正常登入 FineDataLink 資料平台，修改後無法登入的情況，可參考以下步驟重置平台配置：

1）根據本文 2.2 節設定的備份路徑，找到備份 finedb 檔案，並取代現有 finedb 檔案，即可還原平台配置。

以手動備份為例，在% FineDataLink_HOME%/webapps/webroot/backup/config/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將備份的 config.zip 解壓得到的 finedb，取代% FineDataLink_HOME%/webapps/webroot/WEB-INF/embed下的 finedb 檔案。

如果採用的是外接資料庫，可以透過連結外接資料庫的方式，恢復或移除增加的配置項。如果外接資料庫執行了備份操作，可以透過對應資料庫的備份恢復之前的配置。

2）重啟工程。