1)支持自动读取数据库模式,防止手动输入出错
2)迁移外接数据库,且不勾选「迁移数据至要启用的数据库」时,自动检测新老数据库对应工程版本是否一致
BI 系统配置外接数据库后,遇到集群环境或数据量较大情况时,可保证 BI 系统的稳定性。
用户可在「初始化时」配置外接数据库或在「平台中」配置 DB2 类型的外接数据库。
注:若配置了外接数据库,请勿轻易修改外接数据库的用户名和密码,否则会导致工程启动失败。
如需修改,请参照:修改外接数据库账号密码 。
外接数据库支持的类型及版本如下表所示:
9.7、8.2、11.1
注1:占用空间需要结合使用度进行调整,可以根据webapps/webroot/WEB-INF/embed/finedb文件夹大小配置,并根据实际大小预估未来使用大小,增大1~2倍。
注2:推荐内存为预留给工程配置库的内存。
注3:外接数据库尽量和 BI 工程在同一网段,避免网络波动等问题。
新建一个数据库,用于存储平台相关数据。
标准建库语句:CREATE SCHEMA FINEDB
注:不同 FineBI 工程,不可共用同一个外接数据库,否则数据可能会出现错乱。
外接数据库为 DB2 数据库时,需要注意「模式设置」和「日志空间配置」,具体介绍如下所示。
外接到 DB2 数据库的时候,会有一个模式的选项。模式一般和用户名一样。
注:DB2 迁移的时候用户名是高权限的,会有和用户名同名的模式,也可以另外新建模式。
如果 FineDB 数据量过大,而日志空间又不足,很可能在配置过程中出错(SQLCODE=-964, SQLSTATE=57011),所以需要确保日志空间足够
get db cfg for DATABASENAME
查看日志配置, 参考配置如下
修改日志文件大小:
db2 update db cfg for <DATABASENAME> using LOGFILSIZ 8192
修改主日志文件个数:
db2 update db cfg for <DATABASENAME> using LOGPRIMARY 50
修改辅助日志文件个数:
db2 update db cfg for <DATABASENAME> using LOGSECOND 20
FineBI 5.1 未内置 DB2 数据库的驱动,需要手动添加驱动。
1)关闭 BI 工程。
2)从 IBM 官网 下载对应版本的驱动包,并上传至工程webapps\webroot\WEB-INF\lib目录下。
3)重启 BI 工程。
本方法适用于第一次登录数据决策系统时配置外接数据库。
用户可在第一次进入平台时配置外接数据库,如下图所示:
点击「配置数据库」后,进入到外接数据库配置界面,选择数据库类型为 DB2,输入实际数据库相应的信息即可。如下图所示:
各设置项说明如下表所示:
无需修改,会自动配置
2.3 节新建的数据库名称
禁止与其他工程共用数据库,建议新建数据库
数据库名称只允许包含数字、字母、下划线和「.」
主机名称只允许包含数字、字母、下划线、「-」和「.」
用户需要具备 create、delete、alter、update、select、insert 权限
1)5.1.15 及之后版本的 BI 工程,仅支持下拉选择模式
正确填写完上面几项设置后,点击模式下拉框中的「点击连接数据库」,系统将自动连接该数据库并读取模式,选择即可(尽量选择和数据库用户的名字相同的模式)
注:若提示数据库连接失败,请检查上面几项设置。
2)5.1.15 之前版本的 BI 工程,仅支持手动输入模式
模式的名字和数据库用户的名字相同
等待一段时间,提示已成功启用新数据库。如下图所示:
注:请勿在迁移过程中刷新页面。
本方法适用于进入数据决策系统后,第一次配置外接数据库。
管理员登录数据决策系统,点击「管理系统>系统管理>常规>外接数据库>待配置」,如下图所示:
输入实际数据库相应的信息,配置外接数据库。如下图所示:
等待一段时间,会跳出弹窗提示:已成功启用目标数据库,点击「确定」即可。如下图所示:
注1:请勿在迁移过程中刷新页面。
注2:数据库配置成功后无需重启。
本方法适用于系统已配置外接数据库后,迁移至新的数据库。
管理员登录数据决策系统,点击「管理系统>系统管理>常规>外接数据库>已配置」,如下图所示:
「迁移数据至要启用的数据库」按钮说明:
1)勾选「迁移数据至要启用的数据库」
切换数据库时,原外接数据库的数据会导入到新数据库,工程下不生成历史数据备份文件。
若新数据库中已存在平台数据,导入数据前将清空原有平台数据。提示如下图所示:
2)不勾选「迁移数据至要启用的数据库」
若新外接数据库为空,提示必须将当前数据迁移到目标数据库。
若新外接数据库不为空
迁移前将自动备份原数据库的配置信息,在webapps\webroot\WEB-INF\config目录下生成db.properties.bak文件。如下图所示:
5.1.15 及之后版本的 BI 工程,会自动检测目标数据库中数据对应的 JAR 包版本和当前工程的 JAR 包版本是否一致。
若不一致,则跳出提示:无法启用!启用新数据库需要的工程版本:XXX。当前工程版本:XXX。请确保工程版本一致!
若 JAR 包版本一致,则直接启用新数据库,迁移成功后,提示如下图所示:
等待一段时间,会跳出弹窗提示:已成功切换至目标数据库!新旧数据库若存在数据差异可能影响系统运行,建议重启工程以确保正常使用。
点击「确定」后,重启 BI 工程,方迁移成功。如下图所示:
提示: