配置PostgreSQL外接数据库

1.1 版本

1.2 功能简介

FineDataLink 配置外接数据库后，遇到集群环境或数据量较大情况时，可保证系统的稳定性。

用户可通过安装「PostgreSQL外置数据库」插件，在 FineDataLink 中配置 PostgreSQL 类型的外接数据库。

注：若配置了外接数据库，请勿轻易修改外接数据库的用户名和密码，否则会导致工程启动失败。

       如需修改，请参照：修改外接数据库账号密码 。

1.3 注意事项

若工程配置了虚拟目录，即：Tomcat 下通过 IP 直接访问系统，在安装插件前，需要修改服务器配置文件。

打开%tomcat_home%\conf\server.xml文件，修改reloadable=false，如下图所示：

准备将平台数据要迁移到的数据库，建议用户新建一个空的数据库（数据库大小请参考本文 2.2 节）。

注：不同 FineDataLink 工程，不可共用同一个外接数据库，否则数据可能会出现错乱。

2.1 数据库版本

外接数据库支持的类型及版本如下表所示：

2.2 硬件配置

注1：占用空间需要结合使用度进行调整，可以根据webapps/webroot/WEB-INF/embed/finedb文件夹大小配置，并根据实际大小预估未来使用大小，增大1~2倍。

注2：推荐内存为预留给工程配置库的内存。

注3：外接数据库尽量和 FineDataLink 在同一网段，避免网络波动等问题。

3.1 安装插件

点击下载插件：PostgreSQL外置数据库

插件安装方法请参照：插件管理

3.2 检查配置

若用户使用了数据管道功能，需要在配置外接数据库前暂停正在同步的任务。

3.3 外接数据库配置入口

管理员登录 FineDataLink ，点击「管理系统>系统管理>常规>外接数据库」，如下图所示：

3.3 配置外接数据库

进入到外接数据库配置界面后，选择数据库类型，输入实际数据库相应的信息即可。如下图所示：

3.3.1 设置项

各设置项说明如下表所示：

3.3.2 迁移数据至要启用的数据库

用户可根据自身需求选择是否勾选「迁移数据至要启用的数据库」按钮。具体如下：

1）勾选「迁移数据至要启用的数据库」，新外接数据库为空

点击「启用新数据库」后，会将原 finedb 数据库的平台数据迁移到新外接数据库中。

2）勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据

点击「启用新数据库」后，跳出提示「该数据库已存在平台数据，导入数据前将清空原有平台数据，确认连接该数据库？」。

点击「确定」将清空原有平台数据，将原 finedb 数据库的平台数据迁移到新外接数据库中。

3）不勾选「迁移数据至要启用的数据库」，新外接数据库为空

点击「启用新数据库」后，跳出提示「目标数据库为新数据库，将当前数据迁移至目标数据库后方能使用」。

点击「确定」，将原 finedb 数据库的平台数据迁移到新外接数据库中。

4）不勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据

点击「启用新数据库」后，5.1.15 及之后版本的 BI 工程会自动检测目标数据库中数据对应的 JAR 包版本和当前工程的 JAR 包版本是否一致。

• 若不一致，则跳出提示「无法启用！启用新数据库需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！」。无法进行外接数据库配置。

• 若 JAR 包版本一致，且原 finedb 数据库为内置数据库，则直接启用新外接数据库。

• 若 JAR 包版本一致，且原 finedb 数据库为外接数据库，迁移前将自动备份原数据库的配置信息，在webapps\webroot\WEB-INF\config目录下生成db.properties.bak文件，并直接启用新外接数据库。如下图所示：

3.3 迁移成功

等待一段时间，迁移成功后，根据迁移时的情况，可能会跳出不同的弹窗提示。

1）新外接数据库，使用了原 finedb 数据库的数据。

则提示「已成功启用目标数据库」。点击「确定」即可，迁移成功。如下图所示：

2）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为内置数据库。

则提示「已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用」。

点击「确定」后，重启报表工程，方迁移成功。如下图所示：

3）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为外接数据库。

则跳出两个提示：

• 已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用

• 原数据库配置已备份至config文件夹下，如有需要可以使用备份文件还原数据库配置
  

点击「确定」后，重启报表工程，方迁移成功。如下图所示：