8.3 KiB
8.3 KiB
name, description, version
| name | description | version |
|---|---|---|
| tjwater-action-analytics-scada-operations-scada | analytics/scada-operations 下 scada 操作技能。 | 3.0.0 |
scada Action Skill
简介
负责 analytics/scada-operations 场景下 scada 的具体接口调用，分为设备配置（静态元数据）、时序监测数据（TimescaleDB）、实时模拟数据、方案数据和复合查询五类。
子模块索引 (渐进式引导)
- 当前为叶子节点，直接使用下方接口目录。
接口目录
SCADA 设备配置（静态元数据）
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| GET | /api/v1/getscadadeviceschema/ |
获取SCADA设备架构 | network (query) | - |
| GET | /api/v1/getscadadevice/ |
获取SCADA设备 | network (query), id (query) | - |
| GET | /api/v1/getallscadadeviceids/ |
获取所有SCADA设备ID | network (query) | - |
| GET | /api/v1/getallscadadevices/ |
获取所有SCADA设备 | network (query) | - |
| POST | /api/v1/addscadadevice/ |
添加SCADA设备 | network (query) | - |
| POST | /api/v1/setscadadevice/ |
更新SCADA设备 | network (query) | - |
| POST | /api/v1/deletescadadevice/ |
删除SCADA设备 | network (query) | - |
| POST | /api/v1/cleanscadadevice/ |
清空SCADA设备表 | network (query) | - |
| GET | /api/v1/getscadadevicedataschema/ |
获取SCADA设备数据架构 | network (query) | - |
| GET | /api/v1/getscadadevicedata/ |
获取SCADA设备数据 | network (query), device_id (query) | - |
| POST | /api/v1/addscadadevicedata/ |
添加SCADA设备数据 | network (query) | - |
| POST | /api/v1/setscadadevicedata/ |
更新SCADA设备数据 | network (query) | - |
| POST | /api/v1/deletescadadevicedata/ |
删除SCADA设备数据 | network (query) | - |
| POST | /api/v1/cleanscadadevicedata/ |
清空SCADA设备数据表 | network (query) | - |
| GET | /api/v1/getscadaelementschema/ |
获取SCADA元素架构 | network (query) | - |
| GET | /api/v1/getscadaelement/ |
获取单个SCADA元素映射 | network (query), id (query) | - |
| GET | /api/v1/getscadaelements/ |
获取所有SCADA元素映射 | network (query) | - |
| POST | /api/v1/addscadaelement/ |
添加SCADA元素映射 | network (query) | - |
| POST | /api/v1/setscadaelement/ |
更新SCADA元素映射 | network (query) | - |
| POST | /api/v1/deletescadaelement/ |
删除SCADA元素映射 | network (query) | - |
| POST | /api/v1/cleanscadaelement/ |
清空SCADA元素映射表 | network (query) | - |
| GET | /api/v1/getscadainfoschema/ |
获取SCADA信息架构 | network (query) | - |
| GET | /api/v1/getscadainfo/ |
获取SCADA信息 | network (query), id (query) | - |
| GET | /api/v1/getallscadainfo/ |
获取所有SCADA信息 | network (query) | - |
| GET | /api/v1/getscadaproperties/ |
获取SCADA属性 | network (query), scada (query) | - |
| GET | /api/v1/getallscadaproperties/ |
获取所有SCADA属性 | network (query) | - |
SCADA 时序监测数据（TimescaleDB）
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| POST | /api/v1/scada/batch |
批量插入SCADA监测数据 | data (body) | - |
| GET | /api/v1/scada/by-ids-time-range |
按设备ID和时间范围查询SCADA数据 | start_time (query), end_time (query), device_ids (query) | - |
| GET | /api/v1/scada/by-ids-field-time-range |
按设备ID、字段和时间范围查询SCADA数据 | start_time (query), end_time (query), field (query), device_ids (query) | - |
| PATCH | /api/v1/scada/{device_id}/field |
更新SCADA设备字段 | device_id (path), time (query), field (query), value (query) | - |
| DELETE | /api/v1/scada/by-id-time-range |
按设备ID和时间范围删除SCADA数据 | device_id (query), start_time (query), end_time (query) | - |
实时模拟数据（TimescaleDB - Realtime）
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| POST | /api/v1/realtime/links/batch |
批量插入实时管道数据 | data (body) | - |
| GET | /api/v1/realtime/links |
查询实时管道数据 | start_time (query), end_time (query) | link_ids (query) |
| DELETE | /api/v1/realtime/links |
删除实时管道数据 | start_time (query), end_time (query) | - |
| PATCH | /api/v1/realtime/links/{link_id}/field |
更新实时管道字段 | link_id (path), time (query), field (query), value (query) | - |
| POST | /api/v1/realtime/nodes/batch |
批量插入实时节点数据 | data (body) | - |
| GET | /api/v1/realtime/nodes |
查询实时节点数据 | start_time (query), end_time (query) | node_ids (query) |
| DELETE | /api/v1/realtime/nodes |
删除实时节点数据 | start_time (query), end_time (query) | - |
| POST | /api/v1/realtime/simulation/store |
存储实时模拟结果 | data (body) | - |
| GET | /api/v1/realtime/query/by-time-property |
按时间和属性查询实时数据 | time (query), property (query) | - |
| GET | /api/v1/realtime/query/by-id-time |
按ID和时间查询实时模拟数据 | element_id (query), time (query) | - |
方案模拟数据（TimescaleDB - Scheme）
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| POST | /api/v1/scheme/links/batch |
批量插入方案管道数据 | data (body) | - |
| GET | /api/v1/scheme/links |
查询方案管道数据 | scheme_type (query) | link_ids (query) |
| GET | /api/v1/scheme/links/{link_id}/field |
查询方案管道字段数据 | link_id (path), scheme_type (query), field (query) | - |
| PATCH | /api/v1/scheme/links/{link_id}/field |
更新方案管道字段 | link_id (path), scheme_type (query), field (query), value (query) | - |
| DELETE | /api/v1/scheme/links |
删除方案管道数据 | scheme_type (query) | - |
| POST | /api/v1/scheme/nodes/batch |
批量插入方案节点数据 | data (body) | - |
| GET | /api/v1/scheme/nodes/{node_id}/field |
查询方案节点字段数据 | node_id (path), scheme_type (query), field (query) | - |
| PATCH | /api/v1/scheme/nodes/{node_id}/field |
更新方案节点字段 | node_id (path), scheme_type (query), field (query), value (query) | - |
| DELETE | /api/v1/scheme/nodes |
删除方案节点数据 | scheme_type (query) | - |
| POST | /api/v1/scheme/simulation/store |
存储方案模拟结果 | scheme_type (query), data (body) | - |
| GET | /api/v1/scheme/query/by-id-time |
按ID和时间查询方案模拟数据 | element_id (query), scheme_type (query), time (query) | - |
复合查询（TimescaleDB - Composite）
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| GET | /api/v1/composite/scada-simulation |
获取SCADA关联的模拟数据 | network (query), start_time (query) | end_time (query) |
| GET | /api/v1/composite/element-simulation |
获取管网元素的模拟数据 | network (query), element_id (query), start_time (query) | end_time (query) |
| GET | /api/v1/composite/element-scada |
获取管网元素关联的SCADA监测数据 | element_id (query), start_time (query) | end_time (query) |
| POST | /api/v1/composite/clean-scada |
清洗SCADA监测数据 | data (body) | - |
| GET | /api/v1/composite/pipeline-health-prediction |
预测管道健康状况 | network (query), time (query) | - |
- 覆盖方法：
DELETE, GET, PATCH, POST
接口说明
| 接口 | 说明 |
|---|---|
GET /scada/by-ids-time-range |
查询多个设备在指定时间范围内的所有监测字段数据，device_ids 为逗号分隔的ID字符串 |
GET /scada/by-ids-field-time-range |
查询多个设备在指定时间范围内的特定字段数据（如只查压力或只查流量） |
POST /realtime/simulation/store |
将水力模拟结果以实时数据形式存入TimescaleDB，供前端实时展示 |
GET /realtime/query/by-time-property |
按特定时间点和属性名查询管网实时模拟结果 |
GET /composite/scada-simulation |
同时返回指定管网的SCADA监测数据和对应的水力模拟数据，便于对比分析 |
GET /composite/element-scada |
查询特定管网元素（管道或节点）关联的SCADA监测时序数据 |
GET /composite/pipeline-health-prediction |
基于历史SCADA数据和模型预测管道健康状态 |
POST /composite/clean-scada |
对指定设备的SCADA原始数据进行清洗处理（去异常值等），支持传 'all' 清洗所有设备 |