diff --git a/doc/docs/guide/datasource.md b/doc/docs/guide/datasource.md index 01ee19dd..432ac9b9 100644 --- a/doc/docs/guide/datasource.md +++ b/doc/docs/guide/datasource.md @@ -23,10 +23,26 @@ ## 扩展 -- 以kudu impala 为例,在lib文件夹下加入kudu impala相关的JDBC连接相关的包,如图在数据库中新增数据源类型,参考数据源类型(上方) +### JDBC驱动类数据源添加: -![An image](../picture/datasource/kudu-impala-lib.png) +- 第一种,在report-core/lib目录下添加
+ 按照同样的层级将驱动包放置,使用build.sh脚本进行打包,前端页面选择jdbc数据源,填上对应的驱动类即可使用。
+ **注意:** 此方式添加的jar包只能使用build.sh进行编译后才会生效。
+
+ +- 第二种,在pom.xml中添加
+ 使用build.sh脚本编译或者maven package编译都可以,前端页面选择jdbc数据源,填上对应驱动。
+ +
+ +### 非JDBC类数据源驱动添加: + +例如原生ES、Redis之类。
+ +1、在源码中编写解析代码
+2、使用页面生成数据字典
+3、添加对应驱动包
diff --git a/doc/docs/guide/question.md b/doc/docs/guide/question.md index 17952c46..761ee0f9 100644 --- a/doc/docs/guide/question.md +++ b/doc/docs/guide/question.md @@ -1,53 +1,74 @@ +## 其他 + +- 禁用flyway及切换底层数据库方案
+ [链接](https://my.oschina.net/u/4517014/blog/5269319)
+ +- 数据源数据集用法总结
+ [链接](https://my.oschina.net/u/4517014/blog/5270828)
+ - 使用Maven Install打包时报错
![img.png](../picture/qusetion/img.png)
- 请使用Maven Package进行打包
+ 使用Maven Package进行打包
-### 版本问题:[开发环境参考](https://report.anji-plus.com/report-doc/guide/quicklyDevelop.html) +
+ +## 版本问题:[开发环境参考](https://report.anji-plus.com/report-doc/guide/quicklyDevelop.html) - 底层数据库为Mysql8.0+时,flyway执行SQL报错
- Node.js是V16版本时 npm install失败
- jdk使用1.7或者11及以上时,编译打包不过
- ![img](../picture/qusetion/img_1.png)
+
+ ![img](../picture/qusetion/img_4.png)
+ +
-- MssSqlServer 2014及其上下版本数据源测试不过。以2014版本为例。
- ![img](../picture/qusetion/img_2.png)
- 将1.2.6改成1.2.0
+## 访问相关 -- 浏览器兼容性 当前未对部分浏览器做兼容性适配,推荐使用谷歌浏览器进行访问。
+- 浏览器兼容性
+ 当前未对部分浏览器做兼容性适配,推荐使用谷歌浏览器进行访问。
+ 已知:IE白屏、部分版本的火狐浏览器拖动组件出现跳转新页面及无法返回的情况
+ +
- 部署完进入系统,点击预览大屏,大屏提示:“执行sql失败“
![img](../picture/qusetion/img_3.png)
请先重置mysql数据源,将mysql数据源的账号密码修改为你当前系统的账号密码。
-- flyway执行报错1.0.10sql失败
- 错误提示:Caused by: org.flywaydb.core.api.FlywayException: Validate failed: Detected failed
- migration to version 1.0.10 (create report share)
- 请参考此 [Issue](https://gitee.com/anji-plus/report/issues/I47JNE) 解决此问题
+
-- 禁用flyway及切换底层数据库方案
- [链接](https://my.oschina.net/u/4517014/blog/5269319)
+- 页面提示“404”
+ 1、确保访问地址无误,根据部署方式的不同9095/9528 端口皆可以进入项目,如果一个不行试另一个端口
+ 2、确定前端是否启动
+ 3、确定后端是否启动 br> -- 数据源数据集用法总结
- [链接](https://my.oschina.net/u/4517014/blog/5270828)
+
-### 执行源码编译脚本(build.sh)报错 +## 执行源码编译脚本(build.sh)报错 - 提示:“*** report-ui/dist/* *** No such file or directory”
前端编译失败。
- 99%的原因是Node.js版本过高(高于14),导致前端编译失败,Nodejs在编译执行初始化时会去下载一些依赖,如果依赖下载不来,也会导致失败。
- 剩下极少数情况可能是你编译的linux系统问题。
+ 大部分原因是Node.js版本过高(高于V14),导致前端编译失败。
+ 另一部分是Nodejs在编译执行初始化时会去下载一些依赖,如果依赖下载不下来,也会导致失败。
+ +
- 提示:“report-core/target/aj-report-*.zip *** No such file or directory”
后端编译失败。
- 可能原因有:Mvn版本过低/过高,导致后端编译失败
+ 可能原因有:Maven版本过低/过高,导致后端编译失败
+ +
- 使用eclipse进行源码编译时失败
失败的提示有很多,这里建议换成IDEA
+
+ - 使用IDEA进行源码编译时提示:“*** openjdk-***”
请使用jdk1.8 -### 启动服务报错 +
+ +## 启动服务相关 - 提示“xxx The driver has not received any packets from the server”
连不上mysql。
@@ -55,11 +76,14 @@ 2、mysql版本不兼容,详细看上面关于版本兼容性
3、bootstrap.yml中配置的mysql地址ip不对
+
-- 提示“404”
- 1、确保访问地址无误,根据部署方式的不同9095/9528 端口皆可以进入项目,如果一个不行试另一个端口
- 2、确定前端是否启动
- 3、确定后端是否启动 br> +- flyway执行报错1.0.10sql失败
+ 错误提示:Caused by: org.flywaydb.core.api.FlywayException: Validate failed: Detected failed
+ migration to version 1.0.10 (create report share)
+ 请参考此 [Issue](https://gitee.com/anji-plus/report/issues/I47JNE) 解决此问题
+ +
diff --git a/doc/docs/picture/qusetion/img_4.png b/doc/docs/picture/qusetion/img_4.png new file mode 100644 index 00000000..808f4fd0 Binary files /dev/null and b/doc/docs/picture/qusetion/img_4.png differ diff --git a/doc/docs/picture/qusetion/img_5.png b/doc/docs/picture/qusetion/img_5.png new file mode 100644 index 00000000..c33db50b Binary files /dev/null and b/doc/docs/picture/qusetion/img_5.png differ