1. 概述
1.1 版本
| 帆软产品版本 | 功能变动 |
|---|---|
FineReport11.0.9信创版 FineBI6.0.4信创版 FineDataLink4.0.19信创版 | - |
FineReport11.0.13信创版 | 1）新增支持外接数据库类型「OceanBase-Oracle」 2）选择 OceanBase 作为外接数据库时，新增「版本」设置项，设置内容包括：MySQL 版和 Oracle 版 |
| FineReport11.0.17信创版 | OceanBase 外接数据库功能从产品中剥离，以插件形式提供 |
1.2 功能简介
FineReport、FineBI、FineDataLink系统配置外接数据库后，遇到集群环境或数据量较大情况时，可保证系统的稳定性。
用户可在「初始化时」配置外接数据库或在「平台中」配置 OceanBase 类型的外接数据库。
注：若配置了外接数据库，请勿轻易修改外接数据库的用户名和密码，否则会导致工程启动失败。
如需修改，请参照：修改外接数据库账号密码 。
1.3 注意事项
FineReport11.0.13 之前的信创版本，不支持 OceanBase-Oracle 类型的外接数据库，支持 OceanBase-MySQL 类型的外接数据库。
用户如需使用 OceanBase-MySQL 类型的外接数据库，在数据库类型中选择「oceanbase」，并参照本文 3.2.1 节中 OceanBase-MySQL 版说明进行配置即可。
2. 插件安装
FineReport11.0.17 及之后的信创版本，配置 OceanBase 外接库需要使用插件：oceanbase 外置数据库
获取插件：联系对接的销售人员
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
3. 插件注册
FineReport11.0.17 及之后版本，使用该插件需要在 FineReport 的 License 注册中购买OceanBase外接数据库功能点。详情请联系对接的销售人员。
若工程未正式注册，安装插件即可试用插件全功能。
若已注册的工程安装了该插件，且未注册OceanBase外接数据库功能点，帆软会提供 90 天的免费试用，用户可在试用期内进行功能测试和试用。
90 天试用期内，支持选择、配置OceanBase外接数据库。
试用到期后，已注册OceanBase外接数据库功能点的工程可以继续使用，未注册OceanBase外接数据库功能点的工程使用受到限制，详情请参见：外接数据库注册 。
4. 准备外接数据库
4.1 数据库版本
外接数据库支持的类型及版本如下表所示：
| 数据库类型 | 帆软产品版本 | 支持数据库版本 |
|---|---|---|
| OceanBase-MySQL | FineReport11.0.9信创版 FineBI6.0.4信创版 | V3.2.3 |
| OceanBase-Oracle | FineReport11.0.13信创版 | V2.3.0 |
4.2 硬件配置
| 配置类型 | 最低配置 | 推荐配置 |
|---|---|---|
| 内存 | 1GB | 2GB |
| CPU | 4核 | 8核 |
| 网速 | 50Mbps | 100Mbps |
| 占用空间 | 1GB | 2GB |
| 磁盘读写速度 | 50MB/s | 100MB/s |
注1：占用空间需要结合使用度进行调整，可以根据webapps/webroot/WEB-INF/embed/finedb文件夹大小配置，并根据实际大小预估未来使用大小，增大1~2倍。
注2：推荐内存为预留给工程配置库的内存。
注3：外接数据库尽量和FineReport/FineBI工程在同一网段，避免网络波动等问题。
4.3 新建数据库
新建一个数据库表空间，用于存储平台相关数据。
注：不同FineReport/FineBI工程，不可共用同一个外接数据库，否则数据可能会出现错乱。
5. 配置外接数据库
5.1 外接数据库配置入口
外接数据库的配置入口，有三种形式：
1）超级管理员第一次登录数据决策系统时，即可为系统配置外接数据库。如下图所示：
2）对于使用内置数据库的系统，管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库>待配置」，可为系统第一次配置外接数据库。如下图所示：
3）对于已启用外接数据库的系统，管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库>已配置」，可为系统迁移至新的外接数据库。如下图所示：
5.2 配置外接数据库
进入到外接数据库配置界面后，选择数据库类型和版本，输入实际数据库相应的信息即可。如下图所示：
5.2.1 设置项
各设置项说明如下表所示：
| 设置项 | oceanbase-mysql 版说明 | oceanbase-oracle 版说明 |
|---|---|---|
| 数据库类型 | 选择「oceanbase」 | 选择「oceanbase」 |
| 版本 | 选择「mysql版」 | 选择「oracle版」 |
| 驱动 | 无需手动修改 | 无需手动修改 |
| 数据库名称 | 2.3 节新建的表空间名称 禁止与其他工程共用表空间，建议新建表空间 表空间名称只允许包含数字、字母、下划线和「.」 | 2.3 节新建的表空间名称 禁止与其他工程共用表空间，建议新建表空间 表空间名称只允许包含数字、字母、下划线和「.」 |
| 用户名/主机/密码/端口 | 根据本地数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert、index 权限 | 根据本地数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert、index 权限 |
| 模式 | - | 支持下拉选择模式 正确填写完上面几项设置后，点击模式下拉框中的「点击连接数据库」，系统将自动连接该数据库并读取模式，选择即可（尽量选择和数据库用户的名字相同的模式）
|
5.2.2 迁移数据至要启用的数据库
用户可根据自身需求选择是否勾选「迁移数据至要启用的数据库」按钮。具体如下：
1）勾选「迁移数据至要启用的数据库」，新外接数据库为空
点击「启用新数据库」后，会将原 finedb 数据库的平台数据迁移到新外接数据库中。
2）勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据
点击「启用新数据库」后，跳出提示「该数据库已存在平台数据，导入数据前将清空原有平台数据，确认连接该数据库？」。
点击「确定」将清空原有平台数据，将原 finedb 数据库的平台数据迁移到新外接数据库中。
3）不勾选「迁移数据至要启用的数据库」，新外接数据库为空
点击「启用新数据库」后，跳出提示「目标数据库为新数据库，将当前数据迁移至目标数据库后方能使用」。
点击「确定」，将原 finedb 数据库的平台数据迁移到新外接数据库中。
4）不勾选「迁移数据至要启用的数据库」，新外接数据库中已存在平台数据
点击「启用新数据库」后，工程会自动检测目标数据库中数据对应的 JAR 包版本和当前工程的 JAR 包版本是否一致。
若不一致，则跳出提示「无法启用！启用新数据库需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！」。无法进行外接数据库配置。
若 JAR 包版本一致，且原 finedb 数据库为内置数据库，则直接启用新外接数据库。
若 JAR 包版本一致，且原 finedb 数据库为外接数据库，迁移前将自动备份原数据库的配置信息，在webapps\webroot\WEB-INF\config目录下生成db.properties.bak文件，并直接启用新外接数据库。如下图所示：
5.3 迁移成功
等待一段时间，迁移成功后，根据迁移时的情况，可能会跳出不同的弹窗提示。
注：请勿在迁移过程中刷新页面。
1）新外接数据库，使用了原 finedb 数据库的数据。
则提示「已成功启用目标数据库」。点击「确定」即可，迁移成功。如下图所示：
2）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为内置数据库。
则提示「已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用」。
点击「确定」后，重启报表工程，方迁移成功。如下图所示：
3）新外接数据库，使用了该数据库中原有的数据，且原 finedb 数据库为外接数据库。
则跳出两个提示：
已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用
原数据库配置已备份至config文件夹下，如有需要可以使用备份文件还原数据库配置
点击「确定」后，重启报表工程，方迁移成功。如下图所示：
