跳到主要内容

本地数据库与 Python

本页说明现场安装包何时使用内置 SQLite、MariaDB 和 Python。安装或维护现场 Service 时使用这些组件;PLC 逻辑仍只使用 C# 风格 SCL 或 LAD,Python 不进入 PLC 扫描闭环。对外名称是 SCL,不要写成 ST、结构化文本或脚本语言。

数据库以读为主:读配方、读参数、读权限。写入只用于低频记录和审计,不要把 PLC 当业务数据库或 MES。

安装包内容​

组件当前版本用途
SQLite随运行时提供单机本地数据,零独立服务
MariaDB11.4.4本机关系型数据服务,使用 13306/TCP
Python3.11.9受控扩展和支持的异步工具

完整现场安装介质会检查这些组件是否齐全;缺少必要文件时安装或发布过程会失败,而不是静默显示为可用。

选择数据库​

场景选择
单机、小数据量、无需并发访问SQLite
HMI 与 Service 需要本机关系型数据内置 MariaDB
已有外部数据库在项目中配置对应连接并测试

不要在 PLC 扫描周期内执行频繁或无界的数据库操作。对接上层 MES / ERP 只经 OPC UA 暴露过程数据,不在 Darra 内实现工单或物料追溯。

首次启动​

现场 Service 首次启动时会:

  1. 检查本地数据库和 Python 组件。
  2. 初始化 MariaDB 数据目录并使用本机端口 13306。
  3. 等待数据库就绪;失败时记录明确错误。
  4. Python 仅在受支持的异步功能调用时启动。

13306 只用于内置 MariaDB,与常见的 3306 分开。不要在 IDE 中把它当作 PLC 通讯端口。IDE 主通道仍是 18821/TCP,远程诊断仍是 18443/HTTPS。

现场机资源 Profile 由安装流程按角色设置。禁止手改 Profile JSON。开发机不安装现场 Service,也不要把本机数据库当成生产数据源。

Python 使用边界​

Python 是现场安装包中的受控运行环境,只供明确支持的异步扩展使用:

  • 不作为 PLC 逻辑语言。
  • 不在扫描周期内同步等待脚本完成。
  • 不在现场机临时安装未经验证的包。
  • 视觉和 AI 模型优先使用已部署、已验证的运行组件。
  • 训练和 LLM 助手只在 IDE 端,不在现场 Service 运行。

编写 PLC 程序时,继续使用 C# 风格 SCL 或 LAD。

离线安装​

完整安装介质包含运行所需组件,现场机不需要联网下载。离线安装完成后,先检查本地数据库状态,再从工程师电脑经 18821/TCP 连接 IDE 并部署项目。不要用 RDP、SSH、Telnet 或 VNC 代替产品通道。

常见问题​

问题处理
MariaDB 未就绪查看现场 Service 诊断,确认本地 13306/TCP 未被占用
SQLite 可用但 MariaDB 不可用保持 PLC 停止,修复安装组件后重新检查
Python 功能不可用确认安装介质完整,并检查该功能是否属于受支持的异步扩展
数据库连接测试失败核对数据库类型、地址、端口和账号权限

相关内容​