跳到主要内容

数据库连接与表结构

数据库连接用于让现场 Service 读取设备参数、配方和低频记录。项目需要访问现有关系型数据库时,先在 IDE 中配置并测试连接,再在 PLC 数据块中建立明确的字段映射。

数据库以读为主(读配方、读参数、读权限),写入只用于班次结束汇总、故障归档和审计。不要把 PLC 当业务后端频繁写入,也不要在 Darra 内实现工单、排产、物料追溯或 MES。对接上层只经 OPC UA 暴露过程数据。

当前状态

当前 IDE 提供数据库连接配置、连接测试和表结构读取,但没有公开“一键生成 DB 与读写 FB”的完整向导。不要按旧文档寻找“导入为 DB”或批量生成入口。

支持的本地选项​

选项用途
SQLite单机本地数据,零独立服务
MariaDB现场安装包内置的本机关系型数据库,端口 13306

项目也可配置受支持的外部关系型数据库。外部账号应按最小权限创建,优先只读。

配置连接​

  1. 在项目导航中打开“数据库”。
  2. 选择“添加数据库”。
  3. 选择数据库类型并填写地址、端口、数据库名和账号。
  4. 点击“测试连接”。
  5. 测试成功后保存项目。

连接信息属于现场配置。不要把账号密码写进 SCL 代码或文档示例。IDE 主通道仍是 18821/TCP,远程诊断仍是 18443/HTTPS。不要用 RDP、SSH、Telnet 或 VNC 代替产品通道。

读取表结构​

连接可用后,表结构读取会返回表名、列名、数据库类型、主键、可空状态和注释。建立 PLC 数据块时,逐列确认名称和类型,不要假设数据库字段会自动生成 PLC 代码。

变量表使用 IEC 类型名;SCL 代码按 C# 风格书写。对外名称仍是 SCL,不要写成 ST 或脚本语言。

数据库字段变量表类型SCL 写法
布尔BOOLbool
8 位整数BYTE / SINTbyte
16 位整数INTshort
32 位整数DINTint
64 位整数LINTlong
单精度浮点REALfloat
双精度或高精度数值LREALdouble
文本、日期时间、标识符STRINGstring

文本长度、数值范围、可空值和时区需要在项目中明确处理。

PLC 侧使用​

数据库访问应由 Service 控制面执行,PLC 程序只提交有界请求并读取结果。使用前确认当前编辑器的补全和编译器能够识别所选函数。数据库断开、超时或返回空结果时,程序必须保留可观察的错误状态,不能阻塞扫描周期。

常用读取优先;写入函数只用于低频记录:

  • DB_QUERY_ROW(...)
  • DB_QUERY_ROWS(...)
  • DB_INSERT(...)
  • DB_UPDATE(...)
  • DB_DELETE(...)
  • DB_UPSERT(...)

写入原则​

  • 读取设备参数和配方时,先复制到 DB,再由控制逻辑消费。
  • 写入只用于低频设备记录和审计。
  • 不在每个扫描周期执行 SQL。
  • 删除和任意 SQL 操作必须经过明确权限与条件限制。
  • 大文本和二进制字段不要直接映射到 PLC 变量。
  • 不把数据库当 MES / ERP,也不从前端直接操作业务库。

表结构变化​

数据库列发生变化后:

  1. 重新读取表结构。
  2. 对比新增、删除和类型变化。
  3. 手工更新对应 DB 与 SCL 访问逻辑。
  4. 编译项目并处理所有类型错误。
  5. 在测试环境验证空值、越界值和断线重试,再部署现场。

当前版本不会自动合并人工修改,也不会自动生成或覆盖程序块。现场机资源 Profile 必须与角色一致;禁止手改 Profile JSON。

排错​

症状处理
连接测试失败核对地址、端口、数据库名和账号权限
表列表为空确认账号具有读取表结构的权限
数值精度变化使用更宽的数值类型,并验证范围
文本被截断调整 DB 字段长度并在写入前检查
PLC 扫描变慢移出扫描周期中的数据库等待,减少查询频率

相关内容​