183 lines
4.4 KiB
Markdown
183 lines
4.4 KiB
Markdown
# EdgeManager（SCADA系统）
|
||
|
||
- [EdgeManager（SCADA系统）](#edgemanagerscada系统)
|
||
- [API](#api)
|
||
- [class `EDataCapture`](#class-edatacapture)
|
||
- [0. HTTP POST: `set_node_data`](#0-http-post-set_node_data)
|
||
- [开发环境](#开发环境)
|
||
- [技术细节](#技术细节)
|
||
- [0. `EdgeManager\EDataCapture\EDataCapture -> set_data()`为什么是以`6710885`为大小chunked的？](#0-edgemanageredatacaptureedatacapture---set_data为什么是以6710885为大小chunked的)
|
||
|
||
## API
|
||
|
||
> API设计最大程度遵循了已有的MES规范。
|
||
|
||
### class `EDataCapture`
|
||
|
||
#### 0. HTTP POST: `set_node_data`
|
||
|
||
**请求**
|
||
|
||
> 上位机程序中请单次传入尽量多的数据使得性能最大化。
|
||
>
|
||
> 但仍需兼顾传输速率和超时时间。
|
||
>
|
||
> 无需指定数值类型，服务端会自动根据已添加的节点信息检查，若不符则会报错。
|
||
|
||
```json
|
||
{
|
||
"action": "set_node_data",
|
||
"param": {
|
||
"working_subclass": <string>,
|
||
"data": [
|
||
{
|
||
"code": <string>,
|
||
// value的类型需与type对应
|
||
"value": <string | int | float | bool>,
|
||
"device_code": [string],
|
||
"batch": [string]
|
||
},
|
||
{
|
||
"code": <string>,
|
||
"value": <string | int | float | bool>,
|
||
"device_code": [string],
|
||
"batch": [string]
|
||
},
|
||
...
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**返回**
|
||
|
||
操作成功：
|
||
|
||
```json
|
||
{
|
||
"action": "result_set_node_data",
|
||
"errcode": 0,
|
||
"errmsg": ""
|
||
}
|
||
```
|
||
|
||
操作失败（**工序单元尚未登记**）：
|
||
|
||
```json
|
||
{
|
||
"action": "result_set_node_data",
|
||
"errcode": 4002,
|
||
"errmsg": "未登记过的工序单元！"
|
||
}
|
||
```
|
||
|
||
操作失败（**数值类型错误**）：
|
||
|
||
```json
|
||
{
|
||
"action": "result_set_node_data",
|
||
"errcode": 4002,
|
||
"errmsg": "节点编码和数值类型不匹配！"
|
||
}
|
||
```
|
||
|
||
操作失败（不明原因）：
|
||
|
||
```json
|
||
{
|
||
"action": "result_set_node_data",
|
||
"errcode": 4002,
|
||
"errmsg": "ROLLBACKed: Bad data received (structure and/or values)"
|
||
}
|
||
```
|
||
|
||
|
||
|
||
## 开发环境
|
||
|
||
拉取代码：
|
||
|
||
```bash
|
||
# 建议先配置SSH key pair
|
||
git clone ssh://git@118.195.187.246:10022/ysun/EdgeManager.git
|
||
cd EdgeManager
|
||
```
|
||
|
||
一键部署PHP workerman和TimescaleDB环境：
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
进入交互式Prompt：
|
||
|
||
```bash
|
||
docker exec -it edge_manager bash
|
||
```
|
||
|
||
后端调试：
|
||
|
||
```bash
|
||
# In container
|
||
php EdgeManager.php --server_name=GPU-server-01 --user=postgres --password=big_dick start
|
||
```
|
||
|
||
前端调试：
|
||
|
||
```bash
|
||
# In host
|
||
# yarn
|
||
# yarn watch
|
||
yarn serve
|
||
```
|
||
|
||
客户端连接：
|
||
|
||
```bash
|
||
# sudo apt install postgresql-client
|
||
# 登入
|
||
psql -h localhost -U postgres
|
||
# 显示数据库列表
|
||
\l
|
||
```
|
||
|
||
## 技术细节
|
||
|
||
### 0. `EdgeManager\EDataCapture\EDataCapture -> set_data()`为什么是以`6710885`为大小chunked的？
|
||
|
||
首先明确一点，根据PostgreSQL的技术架构，条件允许的情况下，**一次性插入多条记录是效率最高的**，比如：
|
||
|
||
```sql
|
||
INSERT INTO films (code, title, did, date_prod, kind) VALUES
|
||
('B6717', 'Tampopo', 110, '1985-02-10', 'Comedy'),
|
||
('HG120', 'The Dinner Game', 140, DEFAULT, 'Comedy');
|
||
```
|
||
|
||
这其中，仅插入部分字段的值，比如：
|
||
|
||
```sql
|
||
INSERT INTO films (code, title, did, date_prod, kind)
|
||
VALUES ('T_601', 'Yojimbo', 106, '1961-06-16', 'Drama');
|
||
```
|
||
|
||
的效率又远远不如插入全部列，但使用特殊变量DEFAULT替代缺少的字段，比如：
|
||
|
||
```sql
|
||
INSERT INTO films VALUES
|
||
('UA502', 'Bananas', DEFAULT, '1971-07-13', 'Comedy', '82 minutes');
|
||
```
|
||
|
||
PostgreSQL的文档里没有提及这个话题，因为源码里为SQL语句的内存分配[指定了一个最大长度常量`MaxAllocSize`](https://github.com/postgres/postgres/blob/2373fe78dfc9d4aa2348a86fffdf8eb9d757e9d5/src/common/stringinfo.c#L28)，其大小为比1GB小1字节。这个值可以在编译前手动修改，所以理论上每个PG运行的实例都可以不一样，如果我们使用的PG并非修改过源码手动编译的，那么SQL语句的最大长度为`1024 ** 3 - 1 = 1073741823` bytes。
|
||
|
||
> 安全起见，下述计算假定working_subclass等字段的最大长度均为我们以往约定的45 bytes。
|
||
|
||
而此处我源码中的SQL语句头长度为138 bytes（注意末尾空格）：
|
||
|
||
|
||
|
||
单个语句体的长度为160 bytes：
|
||
|
||
|
||
|
||
所以其最多可以一次性插入`(1073741823 - 138) / 160`条记录，向下取整后即为`6710885`。
|