导读
质检结果、抓拍图像、AI 推理日志，是工厂质量追溯、工艺优化、生产统计的核心依据。将 TVA 视觉 API 采集的业务数据存入 MySQL 数据库，实现自动落库、长期存储、快速溯源，是工业视觉项目从演示版本升级为商用量产项目的标志性功能。
本文提供可直接执行的建表语句、完整入库逻辑设计、现场可用的溯源查询 SQL，整套方案经过多个量产项目验证，通用性极强。
一、数据表结构设计（主表 + 附表 工业标准分表）
采用主表 + 附表解耦设计，拆分业务字段与图片路径，避免单表数据臃肿、查询缓慢。
1. 质检结果主表tva_vision_detect
sql
CREATE TABLE `tva_vision_detect` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '自增主键', `device_id` varchar(50) NOT NULL COMMENT '视觉点位ID', `product_code` varchar(60) DEFAULT '' COMMENT '产品编码', `defect_type` varchar(30) DEFAULT 'normal' COMMENT '缺陷类型', `confidence` float DEFAULT 0 COMMENT '推理置信度', `detect_time` datetime NOT NULL COMMENT '检测时间', `infer_cost` int DEFAULT 0 COMMENT '推理耗时(ms)', `img_id` bigint DEFAULT 0 COMMENT '关联图像表ID', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_device_time` (`device_id`,`detect_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='TVA视觉质检主表';2. 图像资源附表tva_vision_image
sql
CREATE TABLE `tva_vision_image` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '自增主键', `img_path` varchar(255) NOT NULL COMMENT '图片存储路径', `img_size` int DEFAULT 0 COMMENT '图片大小(字节)', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='视觉抓拍图像表';二、API 数据自动入库逻辑
- 监听 TVA 视觉回调 API，实时接收推理报文；
- 解析报文字段，保存抓拍图片并写入图像附表；
- 质检主表关联图像 ID，完成整条数据入库；
- 全局异常捕获，记录入库失败日志，保障数据完整性。
三、全维度溯源查询 SQL（现场直接使用）
根据设备 ID + 时间范围 + 缺陷类型追溯不良品完整记录：
sql
SELECT d.*,i.img_path FROM tva_vision_detect d LEFT JOIN tva_vision_image i ON d.img_id = i.id WHERE d.device_id = 'VIS_CAM_001' AND d.detect_time BETWEEN '2026-06-01 00:00:00' AND '2026-06-12 23:59:59' AND d.defect_type != 'normal' ORDER BY d.detect_time DESC;四、数据库运维优化
- 按自然月份分表存储，防止单表数据量过大导致查询变慢；
- 定时清理过期图片文件与冷数据，释放服务器磁盘空间；
- 数据库与 TVA 视觉服务部署在同一内网网段，提升入库速度。
知识点总结
- 工业视觉数据推荐主表 + 附表分表设计，结构更合理；
- 联合索引是提升大数据量表溯源查询速度的关键；
- 数据持久化功能必须搭配异常日志，保障数据完整不丢失。
