1. 概述编辑
1.1 版本
| FineBI 版本 | Mariadb外接数据库插件版本 |
|---|---|
| 10.0 | V1.0 |
1.2 功能简介
BI 系统配置外接数据库后，遇到集群环境或数据量较大情况时，可保证 BI 系统的稳定性。
用户可通过安装「MariaDB外接数据库」插件，在数据决策系统中配置 MariaDB 类型的外接数据库。
注：若配置了外接数据库，请勿轻易修改外接数据库的账号和密码，否则会导致工程启动失败。
如需修改，请参照：修改外接数据库账号密码。
1.3 注意事项
若工程配置了虚拟目录，即：Tomcat下通过IP访问非容器化工程，在安装插件前，需要修改服务器配置文件。
打开 %tomcat_home%\conf\server.xml 文件，修改 reloadable=false，如下图所示：
2. 准备外接数据库编辑
准备将平台数据迁移到的数据库，建议用户建立一个空的数据库（数据库大小请参考本文 2.2 节）。
注：不同的 FineBI 工程，不可共用同一个外接数据库，否则数据可能会出现错乱。
2.1 版本和驱动
| 支持的资料库版本 | 驱动包 |
|---|---|
| MariaDB 5.5 及以上版本，包括 MariaDB 10.x系列(如10.1、10.2、10.3、10.4、10.5、10.6、10.7、10.8、10.9.10.10、10.11等)。 | Mariadb 驱动已内置，无需手动上传 |
2.2 硬件配置
| 配置类型 | 最低配置 | 推荐配置 |
|---|---|---|
| 内存 | 1GB | 2GB |
| CPU | 4核 | 8核 |
| 网速 | 50Mbps | 100Mbps |
| finedb占用空间 | 1GB | 2GB |
| 服务器磁盘空间 | 100GB | 200GB |
| 磁盘读写速度 | 50MB/s | 100MB/s |
注1：占用空间需要结合使用度进行调整，可以根据 webapps/webroot/WEB-INF/embed/finedb 文件夹大小配置，并根据实际大小预估未来使用大小，增大 1~2 倍。
注2：推荐内存为预留给工程配置库的内存。
注3：外接数据库尽量和 BI 工程在同一网段，避免网络波动等问题。
3. 配置外接数据库编辑
3.1 安装插件
点击下载插件：Mariadb外置数据库
插件安装方法请参照：插件管理
3.2 外接数据库配置入口
管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库」，如下图所示：
3.3 配置外接数据库
进入到外接数据库配置界面后，选择数据库类型，输入实际数据库相应的信息即可。如下图所示：
3.3.1 设置项
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 数据库类型 | 选择 Mariadb |
| 驱动 | 无需修改，会自动配置 |
| 数据库名称 | 第 2 章新建的数据库名称 禁止与其他工程共用数据库，建议新建数据库 数据库名称只允许包含数字、字母、下划线和「.」 |
| 用户名/主机/密码/端口 | 根据数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert、index 权限 |
3.3.2 迁移数据至要启动的数据库
用户可根据自身需求选择是否勾选「迁移数据至要启用的数据库」按钮。具体如下：
1）勾选「迁移数据至要启用的数据库」，新外接数据库为空
点击「启用新数据库」后，会将原 finedb 数据库的平台数据迁移到新外接数据库中。
2）勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据
点击「启用新数据库」后，跳出提示「该数据库已存在平台数据，导入数据前将清空原有平台数据，确认连接该数据库？」。
点击「确定」将清空原有平台数据，将原 finedb 数据库的平台数据迁移到新外接数据库中。
3）不勾选「迁移数据至要启用的数据库」，新外接数据库为空
点击「启用新数据库」后，跳出提示「目标数据库为新数据库，将当前数据迁移至目标数据库后方能使用」。
点击「确定」，将原 finedb 数据库的平台数据迁移到新外接数据库中。
4）不勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据
点击「启用新数据库」后，工程会自动检测目标数据库中数据对应的 JAR 包版本和当前工程的 JAR 包版本是否一致。
若不一致，则跳出提示「无法启用！启用新数据库需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！」。无法进行外接数据库配置。
若 JAR 包版本一致，且原 finedb 数据库为内置数据库，则直接启用新外接数据库。
若 JAR 包版本一致，且原 finedb 数据库为外接数据库，迁移前将自动备份原数据库的配置信息，在 webapps\webroot\WEB-INF\config 目录下生成 db.properties.bak 文件，并直接启用新外接数据库。如下图所示：
3.4 迁移成功
等待一段时间，迁移成功后，根据迁移时的情况，可能会跳出不同的弹窗提示。
1）新外接数据库，使用了原 finedb 数据库的数据。
则提示「已成功启用目标数据库」。点击「确定」即可，迁移成功。如下图所示：
2）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为内置数据库。
则提示「已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用」。
点击「确定」后，重启报表工程，方迁移成功。如下图所示：
3）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为外接数据库。
则跳出两个提示：
已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用
原数据库配置已备份至 config 文件夹下，如有需要可以使用备份文件还原数据库配置
点击「确定」后，重启报表工程，方迁移成功。如下图所示：
3.5 删除内置库资料连接
「内置 FineDB 数据库」为 HSQL 数据库，使用时会建立内存数据库，数据量大时会占用大量内存。
因此配置完外接数据库后，请检查数据连接中是否存在「内置 FineDB 数据库」的数据连接。
若存在相关数据连接，请及时删除，否则会持续占用服务器内存。
