使用用户HTTP数据表
简介
http(s) 往往是最常见的请求数据的方式,用户可通过该数据源访问个人服务器接口获取数据
开始创建“用户HTTP”数据表
进入“设计器”,切换至“数据”标签,点击左侧“+ 新建”按钮启动创建数据表的流程。输入合适的数据表名称,并选择“用户HTTP”类型:
如上图所示,“用户HTTP”数据表有着如下几个可配置属性:
1. 请求地址
以 http(s)://
开头的接口链接
2. 参数
请求的Query Params,以key value形式输入
3. 请求头
请求的Headers,以key value形式输入
4. 请求方式
请求的method,目前可选择get/post
5. 请求体
请求的body,仅当请求方式选择post时可添加,以key value形式输入
6. 校验类型
目前可选择鉴权方式:无校验、账号密码、jwt
6.1 账户密码
最基础的使用账户密码形式
将会对用户名与密码进行签名,写入 header 的 Authorization 字段中。
6.2 jwt
jwt形式签名方式以HS256签名+对应密钥
将会对所有 query 及 header 及进行签名,写入 header 的 Authorization 字段中。
7. 数据更新方式
两种可选更新方式, 配合刷新周期使用
- 追加:新生成数据置于现有数据之前
- 覆盖:新数据替换现有数据
8. 刷新周期
勾选启用刷新周期
启用后输入的周期必须 >= 5s
此时基本配置完成,点击接口校验按钮,只有通过校验才能点击下一步继续操作
若校验成功则会出现下面几项,对接口返回的数据进行预处理
9. 返回消息示例
默认会直接填充接口返回数据,也可以自行修改消息示例的数据
务必使用 json 形式的数据!!
10. 查询语句
使用JSONata语法书写查询语句,将上面的返回消息示例json进行数据转换
详情请看JSONata官网文档
11. 预览结果
无法修改,仅消息示例与查询语句结合最终呈现的json对象,给用户自检是否返回正确
要求只能返回数组对象形式或一级对象形式
预览数据
当前面配置都没问题,能转换为正确数据表时,将在数据预览处看到如下数据表
当编辑项有问题时,需要返回上一步重新编辑确认后才能进行下一步
完成创建
若生成的数据符合需求,则可点击”确定“按钮,完成数据表的创建及保存。与创建 TSDB 等其他数据源类似的,创建成功后页面跳转到首页:
绑定数据
- 选择一个『折线图』拖动到画布中,再点击『数据绑定』,再选中『图表绑定』中的绑定按钮
- 在弹出的数据表中,绑定上对应的数据表,并选上对应纬度后点击确定
此时我们发现画布中的折线图就被绑定上了刚刚创建的数据源
成果预览
赶紧点击右上角运行试试吧