1. 概述
1.1 版本
| FineDataLink 版本 |
|---|
| 4.0 |
1.2 应用场景
平台中的大部分的配置项都存储在 FineDB 中的 FINE_CONF_ENTITY 表中。
部分配置项未提供前台配置界面，或无法通过 fine_conf_entity可视化配置 进行修改，只能通过修改 FINE_CONF_ENTITY 表的方式进行更改。
注1：修改 FineDB 文件，有可能造成不可修复的 BUG，因此非必要请勿修改 FineDB 文件。
注2：请优先使用前台配置界面或 fine_conf_entity可视化配置 方式修改配置项。
1.3 功能简介
本文使用一个简单的示例来演示如何修改 FINE_CONF_ENTITY 的表字段。
示例：
修改 FineDB 中 FINE_CONF_ENTITY 表中的 PluginFileValidateConfig.fileValidateOpen 字段，将字段值改为 true
步骤：
1）备份平台配置。
2）连接 FineDB 数据库，获取需要修改的 FINE_CONF_ENTITY 表。
3）查询 FINE_CONF_ENTITY 表中是否存在配置项，根据查询结果选取不同的修改方案，并进行相应修改。
4）重启工程。
2. 备份平台配置
建议在修改 FINE_CONF_ENTITY 的表字段前，通过手动或自动的方式备份平台配置项，备份方式请参考：备份还原 。
以手动备份平台配置为例，管理员登录 FineDataLink 数据平台，在「管理系统>智能运维>备份还原>平台配置」中选中手动备份。
默认备份路径为：../backup，备份文件储存在工程的 %FineDataLink%/webapps/webroot/backup文件夹下，如下图所示：
3. 新建数据连接
3.1 获取 FineDB 数据库信息
管理员登录 FineDataLink 数据平台，点击「管理系统>系统管理>常规」。
若外接数据库显示「待配置」，则内置 FineDB 数据库信息可参见：FineDB 数据连接
若外接数据库显示「已配置」，点击即可查看外接 FineDB 数据库的信息。
3.2 连接 FineDB 数据库
新建一个数据连接，数据连接名称为 FineDB，数据库相关配置信息可根据 3.1 节获取。如下图所示：
4. 修改 FINE_CONF_ENTITY
4.1 查询字段
首先使用「数据同步」节点，查询是否存在 ID = PluginFileValidateConfig.fileValidateOpen 的字段。
1）新建一个定时任务，如下图所示：
2）将一个「数据同步」节点拖到设计界面，点击该节点进行设置。
数据源类型选择「HSQL」，数据连接选择「FineDB」，填写以下 SQL 语句：
注1：不同数据库语句可能不同，请根据实际情况调整。
注2：本节以内置 HSQL 类型的 FineDB 数据库进行演示，用户若配置了外接数据库，可根据自身情况选择相应的数据源类型与数据连接。
点击数据预览，查询是否存在所需字段，如下图所示：
4.2 修改字段
4.2.1 查询结果为空
注1：本节适用于 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')
4.2.2 查询结果不为空
注：本节适用于 4.1 节查询结果不为空，即 FINE_CONF_ENTITY 表中存在所需配置项，且需要修改 VALUE 值的情况，如下图所示：
新建一个定时任务，使用「 SQL 脚本」节点，修改该条记录的 VALUE 值为 true，保存并运行任务，如下图所示：
SQL脚本如下所示：
6. 重启工程
SQL 脚本执行成功后，重启工程，修改生效。
7. 注意事项
7.1 还原平台配置
若用户在修改字段值后未出现预期效果，想要还原平台配置，可登录 FineDataLink 数据平台对本文第二节的备份文件进行还原，详情请参考：还原 。
7.2 修改后无法登录数据决策系统
注：如果用户在修改表字段前无法登录 FineDataLink 数据平台，使用以下步骤重置平台配置无效。
如果出现在修改 FINE_CONF_ENTITY 表字段前能够正常登录 FineDataLink 数据平台，修改后无法登录的情况，可参考以下步骤重置平台配置：
1）根据第二节设置的备份路径，找到备份 finedb 文件，并替换现有 finedb 文件，即可还原平台配置。
以手动备份为例，在% FineDataLink_HOME%/webapps/webroot/backup/config/manual下，根据文件夹的名字（备份时间），找到备份的内容，将备份的 config.zip 解压得到的 finedb，替换% FineDataLink_HOME%/webapps/webroot/WEB-INF/embed下的 finedb 文件。
2）重启工程。
上一篇：fine_conf_entity可视化配置
