概述
版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0 | - |
功能简介
本文讲解FineBI6.0中数据更新相关接口。
触发全局更新
接口简介
| 接口作用 | 触发全局更新 |
| 接口URL | /v5/api/conf/update/generate |
| 请求类型 | GET |
| 注意事项 | 必须对应内容存在更新任务方可触发更新 |
响应实例
| 请求示例 | http://172.17.0.25:37799/webroot/decision/v5/api/conf/update/generate?fine_auth_token=xxx 注：使用接口时需要登录，需要传递token参数。 |
| 响应成功 | callback({ "success": true, "code": "200", "message": "success", "data": { "taskInstanceId": "6d161bcd-5070-4687-a44c-81b979eb37e3", "failBeans": [] }, "errorCode": null, "detailErrorMsg": null, "errorMsg": null }) |
| 截图示意 |  |
触发单表/文件夹更新
接口简介
| 接口作用 | 根据表转义名，进行单表/文件夹更新。 |
| 接口URL | /v5/api/conf/update/pack/table |
| 请求类型 | GET |
| 注意事项 | 必须对应内容存在更新任务方可触发更新 |
请求参数-Query参数
| 参数名 | 参数值 | 是否必填 | 描述说明 |
|---|---|---|---|
| info | {"packageId":"文件夹ID","tableName":"表转义名","fullLoad":"false"} 注：参数值格式为JSON，使用时需要进行编码 encodeURIComponent() | 是 | 1）文件夹ID： 2）表转义名： 表转义名即为在数据准备中看到的表名称 3）fullload： false：增量更新 true：全量更新 不填：默认为 true |
响应实例
| 请求示例 | 编码前参数值： {"packageId":"6fb11e7b1e6e4ff3bcb907a5747527b0","tableName":"各省招生人数表","fullLoad":"true"} 编码后参数值： %7B%22packageId%22%3A%226fb11e7b1e6e4ff3bcb907a5747527b0%22%2C%22tableName%22%3A%22%E5%90%84%E7%9C%81%E6%8B%9B%E7%94%9F%E4%BA%BA%E6%95%B0%E8%A1%A8%22%2C%22fullLoad%22%3A%22true%22%7D 链接： http://172.17.0.25:37799/webroot/decision/v5/api/conf/update/pack/table?info=%7B%22packageId%22%3A%226fb11e7b1e6e4ff3bcb907a5747527b0%22%2C%22tableName%22%3A%22%E5%90%84%E7%9C%81%E6%8B%9B%E7%94%9F%E4%BA%BA%E6%95%B0%E8%A1%A8%22%2C%22fullLoad%22%3A%22true%22%7D&fine_auth_token=xxx 注：使用接口时需要登录，需要传递token参数。 |
| 响应成功 | callback({ "success": true, "code": "200", "message": "success", "data": { "taskInstanceId": "d9e9eb1d-d88c-482a-8af1-8823d1b1cfd0", "failBeans": [] }, "errorCode": null, "detailErrorMsg": null, "errorMsg": null }) |
| 截图示意 | |
触发批量更新
接口简介
| 接口作用 | 根据文件夹ID，进行批量更新。 |
| 接口URL | /v5/api/conf/update/batch |
| 请求类型 | POST |
| 注意事项 | 必须对应内容存在更新任务方可触发更新 |
请求参数-body参数
| body | 是否必填 | 描述说明 |
|---|---|---|
[ { "packageId":"文件夹ID", "fullLoad":false } ] | 是 | 1）文件夹ID： 2）fullload： false：增量更新 true：全量更新 不填：默认为 true |
响应实例
| 请求链接 | http://172.17.0.25:37799/webroot/decision/v5/api/conf/update/batch?fine_auth_token=xxx 注：使用接口时需要登录，需要传递token参数。 |
| 请求body | [ { "packageId":"6fb11e7b1e6e4ff3bcb907a5747527b0", "fullLoad":false } ] |
| 响应成功 | callback({ "success": true, "code": "200", "message": "success", "data": { "taskInstanceId": "e193cba7-2b2c-48c7-8388-c0ff4796975c", "failBeans": [] }, "errorCode": null, "detailErrorMsg": null, "errorMsg": null }) |
| 截图示意 | |
获取此次更新实例的信息
接口简介
| 接口作用 | 根据更新任务ID，获取此次更新信息。 |
| 接口URL | /v5/api/conf/update/instance/{taskInstanceId} |
| 请求类型 | GET |
| 注意事项 | taskInstanceId为更新任务ID |
响应实例
| 请求示例 | http://172.17.0.25:37799/webroot/decision/v5/api/conf/update/instance/e193cba7-2b2c-48c7-8388-c0ff4796975c?fine_auth_token=xxx 注：使用接口时需要登录，需要传递token参数。 |
| 响应成功 | callback({ "success": true, "code": "200", "message": "success", "data": { "taskInstanceId": "e193cba7-2b2c-48c7-8388-c0ff4796975c", "taskName": "BI-Update_Api_Batch_Update", "startTime": 1669027681571, "endTime": 1669027683766, "state": 1, "waitStatus": 0, "triggerMode": 1, "triggerType": 3, "costTime": 2195, "resultType": 1, "roleName": "API", "baseTableExpect": 6, "baseTableFinish": 6, "analysisTableExpect": 0, "analysisTableFinish": 0, "relationExpect": 0, "relationFinish": 0, "auth": true, "process": 0.0, "cancel": false, "inLine": false }, "errorCode": null, "detailErrorMsg": null, "errorMsg": null }) |
| 截图示意 | |
响应参数说明
| 参数 | 值说明 |
|---|---|
| taskInstanceId | 更新任务ID |
| taskName | 更新任务名称 |
| startTime | 更新开始时间 |
| endTime | 更新结束时间 |
| state | 更新状态 1：已结束 2：正在运行中 |
| triggerType | 触发方式 1：手动 2：定时 3：内部 |
| resultType | 运行结果 1：全部成功 2：部分成功 |
