You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tanghe-report/doc/docs/guide/datasource.md

96 lines
3.0 KiB
Markdown

1 year ago
## 介绍
[数据源数据集用法总结](https://my.oschina.net/u/4517014/blog/5270828) <br>
- 支持多数据源内置mysql、elasticsearch、kudu等多种驱动 <br>
- 可动态扩展(见下文)
![source.png](../picture/datasource/img_1.png)
## 类型
查看已有的数据源类型。 <br>
![img2](../picture/datasource/img_2.png) <br>
![img3](../picture/datasource/img_3.png) <br>
```text
可以在此页面进行新增数据源配置,也可以去数据库中增加你需要的数据源类型。
表aj_report.gaea_dict_item字段dict_codeSOURCE_TYPE
表aj_report.gaea_dict_item, item_extend字段是下拉选择后动态表单渲染的json数据
```
## 操作
- 只有测试通过的数据源才可以保存。<br>
![An image](../picture/datasource/img.png) <br>
## 内置数据源
### JDBC数据源
适用于JDBC驱动类数据库驱动类、连接串、用户名、密码必须填写正确。<br>
![img6](../picture/datasource/img_6.png) <br>
### elasticsearch_sql数据源
目前只支持 elasticsearch 的 x-pack sql。<br>
固定写法:<br>
- 请求路径http://127.0.0.1:9200/_xpack/sql?format=json
- 请求方式POST
- 请求头:{"Content-Type":"application/json"}
- 请求体:{"query":"select 1"}
![img7](../picture/datasource/img_7.png) <br>
### HTTP数据源
针对http最好得返回结果是``List<JSONObject>``目前而言http 数据源操作上可能过于繁琐了些。<br>
支持请求路径和请求头中存在动态数据,采用 ${} 方式进行动态替换,具体操作看数据集的相关说明。<br>
![img8](../picture/datasource/img_8.png) <br>
**注:** Http数据源功能已经移动到Http数据集中原功能不变有Http接口数据请直接使用Http数据集请注意Http接口数据返回格式必须是Json。
## 扩展
### JDBC驱动类数据源添加
**发行版**
```text
1、将jar包上传到 "aj-report.xxx/lib"目录下
2、启动项目(重启项目)
3、前端页面数据源类型选择"jdbc",填上对应的驱动类、连接串、用户名密码
```
![img4](../picture/datasource/img_4.png) <br>
![img5](../picture/datasource/img_5.png) <br>
**源码**
源码推荐使用第二种方式。<br>
- 第一种在report-core/lib目录下添加 <br>
按照同样的层级将驱动包放置使用build.sh脚本进行打包前端页面数据源类型选择"jdbc"
,填上对应的驱动类、连接串、用户名密码。<br>
**注意:** 此方式添加的jar包只能使用build.sh进行编译后才会生效。<br>
<br>
- 第二种在pom.xml中添加 <br>
使用build.sh脚本编译或者maven package编译都可以前端页面数据源类型选择"jdbc"
,填上对应的驱动类、连接串、用户名密码。<br>
<br>
### 非JDBC驱动类数据源添加
例如原生ES、Redis之类。<br>
```text
1、在源码中编写解析代码(datasource)
2、生成数据字典可在数据字典页面找到"数据源类型",在"操作"栏中选择"编辑字典项"
3、添加对应驱动包
```