1.概述
1.1概念
支撑库是保存支持软件运行环境的所有配置信息的数据库,包括软件框架、报表框架、用户信息、数据源连接信息等。支撑库和数据仓库不一样,数据仓库是存放报表实际的后台数据库。软件的支撑库与数据仓库没有关系,请勿混在一起。
1.2应用场景
①新安装的BI需要更换支撑库为MySQL(版本8.0.11-8.0.37之间),或者MSSQL(SQLserver2012及以上版本)
②要使用标准版方案时必须切换支撑库为MySQL(版本8.0.11-8.0.37之间)。
③出现sqlite支撑库被锁的情况下,建议更换为MySQL类型支撑库。
④出现sqlite支撑库缺失表的情况下,建议更换为MySQL类型支撑库
1.3流程图
1.4注意事项
①确认mysql版本在8.0.11-8.0.37之间(select @@version;)
②确认mysql的加密规则为"mysql_native_password"(select user,host,plugin from user where user='root';)
如不符合要求,则会出现支撑库初始化建表不全,无法登录的情况
2.支撑库更换步骤
(1)在BI首页找到系统管理-系统配置-系统管理-支撑库设置,如下:
(2)点击sqlite,选择MySQL或者MSSQL,填写数据库信息,如下(以MySQL为例),
如选择手动建库,请参考下图配置字符集和排序规则。
(3)信息填写完后点击测试连接,如填写的是不存在的库则等待五秒左右会提示表创建成功,然后再次点击测试连接,连接成功即可保存,保存后可以看见支撑库更换进度,请耐心等待进度条达到100%,并且不要删除该窗口或关闭浏览器。
(4)进度提示百分百后,即可按下方提示点击重新登录返回登录界面
(5)更换支撑库前为免费注册更换完成后需重新注册再登录;
更换支撑库前为正式注册更换完后则在正式注册窗口填写原有产品序列号和客户识别码即可登录。
(6)如切换支撑库后BI一直无法登录,请参考下方常见问题处理。
3.常见问题
3.1查询表是否完整
进入数据库工具,使用show tables查询当前库中有多少张表,正常情况初始化完成应该有242条数据,包括240张数据表和2个视图,如遇到缺少表的情况,请参考下方步骤解决。
3.2表缺少解决方法
3.2.1回到初始sqlite支撑库状态
(1)首先双击桌面快捷方式停止BI服务。
(2)进入下图BI安装路径找到powerbiconfig.sqlite文件,将其删除。
(3)进入下图BI安装路径找到bootstrap-jdkprod.yml文件,根据图片修改路径为jdbc:sqlite:../Cross_SBI_API/powerbimeta.sqlite后保存。
(4)双击桌面快捷方式启动BI,即可回到初始sqlite支撑库状态登录BI。
(5)成功登陆BI后。到数据库工具中新建一个库并执行下方初始化脚本直接完成建表,再到系统配置中切换登录即可。也可以再次尝试按上方步骤进行切换。
注:如利用初始化脚本sql完成建表并切换支撑库,登录时弹出以下提示报错“Client does not support authentication protocol requested by server; consider upgrading MySQL client”,请在数据连接下的mysql数据库中,依次执行以下语句,再尝试登录。
①select user,host,plugin from user where user='root';
②alter user 'root'@'%' identified with mysql_native_password by 'password';
//password是自己新修改的密码,%-代表查出来的host,根据查出来的值替换。
③flush privileges;
(6)如按以上操作还是无法解决,请加QQ群609528697联系奥威技术服务人员
3.3 bi-full服务异常重启
如果更换mysql支撑库后,表已全部初始化完成,且登录页可正常访问,但登录时未提示需再次注册,下载标准方案仍报错sqlite支撑库不允许下载,参考下面处理
(1)先打开cmd窗口,输入pm2 ls回车,会返回BI各服务的状态 ,一般情况下,应该如下图,重启次数都为0。
bi-full异常情况则会返回下方结果,重启次数大于1并持续增长
(2)该情况一般为9280端口被java服务占用,最快的处理方式为重启服务器,再重启BI即可正常,如有其他程序运行不便重启服务器,继续如下操作;
(3)先双击桌面快捷方式停止BI,在cmd窗口输入netstat -ano|findstr 9280回车,可以看见是14160进程占用该端口;
(4)打开任务管理器-详细信息,找到pid为14160的进程,右击该进程结束任务。
(5)双击桌面快捷方式启动BI即可。(如按以上操作还是无法解决,请加QQ群609528697联系奥威技术服务人员)
4.有何影响
大屏报表都是存放在支撑库里面的,若原BI中设计有报表大屏,请在切换支撑库之前先将报表大屏备份导出,支撑库切换后将原来的大屏报表再导入软件,即需要将报表大屏移植到新切换的支撑库中。
报表移植操作请参考文档:移植