数据库连接与表结构
数据库连接用于让现场 Service 读取设备参数、配方和低频记录。项目需要访问现有关系型数据库时,先在 IDE 中配置并测试连接,再在 PLC 数据块中建立明确的字段映射。
数据库以读为主(读配方、读参数、读权限),写入只用于班次结束汇总、故障归档和审计。不要把 PLC 当业务后端频繁写入,也不要在 Darra 内实现工单、排产、物料追溯或 MES。对接上层只经 OPC UA 暴露过程数据。
当前 IDE 提供数据库连接配置、连接测试和表结构读取,但没有公开“一键生成 DB 与读写 FB”的完整向导。不要按旧文档寻找“导入为 DB”或批量生成入口。
支持的本地选项
| 选项 | 用途 |
|---|---|
| SQLite | 单机本地数据,零独立服务 |
| MariaDB | 现场安装包内置的本机关系型数据库,端口 13306 |
项目也可配置受支持的外部关系型数据库。外部账号应按最小权限创建,优先只读。
配置连接
- 在项目导航中打开“数据库”。
- 选择“添加数据库”。
- 选择数据库类型并填写地址、端口、数据库名和账号。
- 点击“测试连接”。
- 测试成功后保存项目。
连接信息属于现场配置。不要把账号密码写进 SCL 代码或文档示例。IDE 主通道仍是 18821/TCP,远程诊断仍是 18443/HTTPS。不要用 RDP、SSH、Telnet 或 VNC 代替产品通道。
读取表结构
连接可用后,表结构读取会返回表名、列名、数据库类型、主键、可空状态和注释。建立 PLC 数据块时,逐列确认名称和类型,不要假设数据库字段会自动生成 PLC 代码。
变量表使用 IEC 类型名;SCL 代码按 C# 风格书写。对外名称仍是 SCL,不要写成 ST 或脚本语言。
| 数据库字段 | 变量表类型 | SCL 写法 |
|---|---|---|
| 布尔 | BOOL | bool |
| 8 位整数 | BYTE / SINT | byte |
| 16 位整数 | INT | short |
| 32 位整数 | DINT | int |
| 64 位整数 | LINT | long |
| 单精度浮点 | REAL | float |
| 双精度或高精度数值 | LREAL | double |
| 文本、日期时间、标识符 | STRING | string |
文本长度、数值范围、可空值和时区需要在项目中明确处理。
PLC 侧使用
数据库访问应由 Service 控制面执行,PLC 程序只提交有界请求并读取结果。使用前确认当前编辑器的补全和编译器能够识别所选函数。数据库断开、超时或返回空结果时,程序必须保留可观察的错误状态,不能阻塞扫描周期。
常用读取优先;写入函数只用于低频记录:
DB_QUERY_ROW(...)DB_QUERY_ROWS(...)DB_INSERT(...)DB_UPDATE(...)DB_DELETE(...)DB_UPSERT(...)
写入原则
- 读取设备参数和配方时,先复制到 DB,再由控制逻辑消费。
- 写入只用于低频设备记录和审计。
- 不在每个扫描周期执行 SQL。
- 删除和任意 SQL 操作必须经过明确权限与条件限制。
- 大文本和二进制字段不要直接映射到 PLC 变量。
- 不把数据库当 MES / ERP,也不从前端直接操作业务库。
表结构变化
数据库列发生变化后:
- 重新读取表结构。
- 对比新增、删除和类型变化。
- 手工更新对应 DB 与 SCL 访问逻辑。
- 编译项目并处理所有类型错误。
- 在测试环境验证空值、越界值和断线重试,再部署现场。
当前版本不会自动合并人工修改,也不会自动生成或覆盖程序块。现场机资源 Profile 必须与角色一致;禁止手改 Profile JSON。
排错
| 症状 | 处理 |
|---|---|
| 连接测试失败 | 核对地址、端口、数据库名和账号权限 |
| 表列表为空 | 确认账号具有读取表结构的权限 |
| 数值精度变化 | 使用更宽的数值类型,并验证范围 |
| 文本被截断 | 调整 DB 字段长度并在写入前检查 |
| PLC 扫描变慢 | 移出扫描周期中的数据库等待,减少查询频率 |