本地数据库与 Python
本页说明现场安装包何时使用内置 SQLite、MariaDB 和 Python。安装或维护现场 Service 时使用这些组件;PLC 逻辑仍只使用 C# 风格 SCL 或 LAD,Python 不进入 PLC 扫描闭环。对外名称是 SCL,不要写成 ST、结构化文本或脚本语言。
数据库以读为主:读配方、读参数、读权限。写入只用于低频记录和审计,不要把 PLC 当业务数据库或 MES。
安装包内容
| 组件 | 当前版本 | 用途 |
|---|---|---|
| SQLite | 随运行时提供 | 单机本地数据,零独立服务 |
| MariaDB | 11.4.4 | 本机关系型数据服务,使用 13306/TCP |
| Python | 3.11.9 | 受控扩展和支持的异步工具 |
完整现场安装介质会检查这些组件是否齐全;缺少必要文件时安装或发布过程会失败,而不是静默显示为可用。
选择数据库
| 场景 | 选择 |
|---|---|
| 单机、小数据量、无需并发访问 | SQLite |
| HMI 与 Service 需要本机关系型数据 | 内置 MariaDB |
| 已有外部数据库 | 在项目中配置对应连接并测试 |
不要在 PLC 扫描周期内执行频繁或无界的数据库操作。对接上层 MES / ERP 只经 OPC UA 暴露过程数据,不在 Darra 内实现工单或物料追溯。
首次启动
现场 Service 首次启动时会:
- 检查本地数据库和 Python 组件。
- 初始化 MariaDB 数据目录并使用本机端口
13306。 - 等待数据库就绪;失败时记录明确错误。
- 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 功能不可用 | 确认安装介质完整,并检查该功能是否属于受支持的异步扩展 |
| 数据库连接测试失败 | 核对数据库类型、地址、端口和账号权限 |