Skip to content

MySQL SQL 恢复、重置与资源保留 ​

MySqlDatabaseMaintenanceService 是 Engine 的 SQL 恢复、数据库重置和服务 MySQL 配置同步实现,虽在 ColorVision.Database 命名空间,文件实际位于 Engine/ColorVision.Engine/Mysql/。本主题区分它的底层接口与桌面编排;结果清理不负责重置,WindowsServicePlugin负责服务版本到库名的选择、安装文件替换及业务账号授权。

恢复不是查看备份或撤销操作:SQL 可以修改数据库,后续还可能改服务配置、重启服务和应用。必须另行确认脚本来源、实际主机/库/账号、业务停写、可恢复副本和操作权限;文档核对不得调用这些接口、启动应用或连接用户数据库。这里没有统一 dry-run、恢复演练或全链回滚保证。

入口决定执行范围 ​

入口当前行为不包含的保证
工具窗口“加载备份”、备份项“还原”均进入 RestoreAndRestartAsync:SQL导入 → 更新流程节点 → 服务配置同步 → 重启注册中心不先自动备份/停写,不自动重启ColorVision,不代表全部服务健康
工具窗口“更新流程节点”在后台进入管理器维护门,仅更新当前库中的流程节点标识,显示数量和失败信息不导入SQL、不同步配置、不重启服务;重新加载流程后使用新标识
MySqlLocalServicesManager.RestoreMysql在管理器维护门内同步等待 SQL 导入和流程节点更新,成功返回文件完整路径不同步服务配置、不重启服务,没有桌面确认或进度协议
WindowsServicePlugin 的 RestoreDatabase业务账号导入SQL后调用共享的流程节点更新;后一步失败时日志区分SQL已经导入不执行桌面的配置同步和服务重启编排
MySqlDatabaseMaintenanceService.RestoreSqlFileAsync直接委托 ExecuteSqlFileCoreAsync,可选择是否在mysql参数中指定库自身不取得管理器维护门、不提权、不验证脚本的业务范围
ResetDatabaseFromSqlFileAsync检查源库是否存在;存在时保留源资源数据,同名源/目标都未创建时按新装初始化;然后执行安装SQL、检查目标连接并按需回写资源不推导目标版本、不保证完整迁移,也不同步配置或启停服务;跨库更新缺少源库时拒绝执行

桌面恢复在开始时克隆 MySqlSetting.Instance.MySqlConfig,SQL导入、节点更新、配置同步共用该连接快照,mysql工具使用 Config.MysqlPath,不自动切换root账号。独立更新按钮也固定点击时的目标库。重置使用调用者传入的 rootConfig,方法名和日志中的“root”不证明账号身份/权限已校验。安装插件如何构造配置和选择源/目标库,以插件专题为准。

手动恢复的阶段与完成含义 ​

RestoreAndRestartAsync 首先非阻塞尝试进入进程内维护门,已有其它维护任务时提示并返回;同调用链允许嵌套。取得门后打开进度窗口,执行SQL、更新流程节点,然后同步配置;同步返回的文件数为0时抛错,提示“数据库已导入,但已停止服务重启”。只有节点更新和配置同步阶段通过才调用 ServiceHost 重启固定的 RegistrationCenterService(服务超时60秒、请求等待90秒)。请求等待超时不代表代理动作取消,见本机权限代理。恢复编排跟踪校验、SQL导入、节点更新、配置同步和服务重启阶段:SQL尚未成功返回时显示“SQL 未完成导入,…失败”;SQL已成功返回而后续阶段失败时明确显示“SQL 已导入,但…失败”。

这个顺序没有导入前自动完整备份、停止采集/流程或停服务步骤,也没有额外“确认后再导入”的弹窗。管理器维护门只约束使用该门的进程内动作,不阻止其它 DAO、直接 SQL 或外部进程写入;门的机制与完整备份边界见结果维护。底层恢复和重置接口不会自动加入该门。

进度窗口的库名来自本次恢复的连接快照。进度百分比表示阶段,不是已导入行数或完成比例。

SQL导入、节点更新、配置写入和注册中心重启不在同一事务中。执行阶段异常被捕获、记日志并将窗口标为失败,没有恢复原数据/配置的补偿;因此方法的 Task 正常完成也可能是忙碌拒绝或界面已报告失败,不能当成业务成功返回值。SQL已导入但后续阶段失败时,先核对最后完成阶段,不自行重跑可能破坏数据的脚本。

运行中的 MySqlRestoreProgressWindow 拒绝关闭,没有取消令牌或取消按钮;它与“关窗不取消后台动作”的数据库清理窗口不同。执行结束后可关闭;只有成功时启用“重启ColorVision”,由用户点击启动新进程 -r,创建进程成功后才关闭当前应用。窗口显示成功表示导入、节点更新阶段、配置同步和注册中心重启响应通过,不验证全部业务服务、模板/结果语义或新应用就绪。

流程节点标识更新 ​

UpdateRestoredFlowNodes 读取目标库 t_scgd_sys_resource 中 type=101 的流程资源,包括停用或软删除资源;仅更新 txt_value 中 STND v1 的模型名称与类型GUID,其它列、节点参数字节、画布位置及连接顺序保持原样。它沿用 STNodeTypeRegistry 的GUID、模型和唯一名称匹配规则,不维护额外的迁移映射表。L/BV 实现在 Engine 内,兼容模型仍固定为 FlowEngineLib.dll|FlowEngineLib.LVCameraNode;曾保存为 Engine 模型的流程会写回这一旧端可识别的模型。GUID 更新为当前类型值,旧端可继续按完整模型匹配;模型和 GUID 均已一致时保持不变,重复执行不再更新。

处理前校验Base64和STND封装。转换不实例化节点、不加载节点属性、不执行取图;已经是当前标识的数据直接保留原字符串,重复执行不会反复写库。未注册或名称有歧义的节点保留原标识,仍可更新同一流程内其它已匹配节点。无效流程保留原值并记录资源ID,空值跳过;缺少资源表时整步跳过。完成日志给出更新流程数、节点数以及未匹配节点和无效流程数,阶段完成不代表所有插件节点已可用。

写回使用参数化SQL,并以资源ID、类型和原Base64值的二进制相等条件防止覆盖并发修改;冲突或数据库异常会中止并回滚本次节点更新事务(要求表引擎支持事务),不会撤销此前SQL导入。独立按钮复用这套实现,运行时禁用自身,结果显示在工具窗口,明细写入日志。它不会替换编辑器中已加载的流程;更新后需重新加载流程,原有保存并发检查仍有效。

重置前保留什么 ​

重置不是“完整备份后安全覆盖”。MigrationBackupTableNames 当前恰为六张服务设置表与三张配置表,和结果清理白名单分离:

定义表
ServiceSettingTableNamest_scgd_algorithm_poi_template_detail/master、t_scgd_buz_product_detail/master、t_scgd_mod_param_detail/master;这里的detail/master表示各两张表
ServiceConfigurationTableNamest_scgd_camera_license、t_scgd_sys_resource、t_scgd_sys_resource_group

源码数组是准确表名的权威位置。它不含算法结果、测量批次/结果、外部图片、其它库或项目SQLite。重置先查源库 BASE TABLE 并取上述白名单交集;没有匹配表就跳过资源导出,不要求九张表全部存在,也不验证每张表有行。普通“迁移备份”按钮的 BackupMysqlResource 则直接使用完整白名单,不能把两种入口视为同一实现。

重置的私有备份使用唯一 color_vision_resources_<时间>_<GUID>.sql.part,调用 RunMysqlDumpAsync(dataOnly: true, replaceExistingRows: true):显式加 --single-transaction、--quick、--skip-triggers、--skip-lock-tables、--skip-add-locks、--no-create-info、--complete-insert、--replace。这不是schema或触发器备份,也不证明跨表引擎、跨阶段的一致快照。普通 BackupMysqlResource 没有传 dataOnly: true,不能套用这些参数。

导出后追加字典依赖再将part改名为SQL;失败尝试删除part,已完成的SQL文件不因后续重置失败而自动删除。这条私有备份链不加入管理器 Backups 列表,也没有普通 CreateMySqlBackupFile 的显式非空文件门禁;外部工具正常退出不等于内容完整或可恢复。

BuildMigrationDictionaryDependencyStatements 为普通模板补充实际引用的字典主档和明细,使用 INSERT IGNORE 并排除 mod_type=5 的传感器分类。SensorTemplateMigrationSqlBuilder 将原属标准分类的模板绑定到目标库已有的 50 / Sensor.Default,并按指令 symbol 恢复分类下的明细引用。旧的第二组及识别出的历史传感器模板保留 ID、名称、指令和读写参数,将 mm_id 和指令的 cc_pid 置空,防止旧数字 ID 指向新库占用该 ID 的其他类型。迁移 SQL 只查询标准传感器分类,模板内容和设备配置来自原资源备份。

依赖 SQL 在 dump 后另行查询,两者使用独立事务。服务升级备份包含模板主档及明细时,传感器依赖构建失败会在执行重置 SQL 前中止。普通字典依赖和普通迁移备份仍记录相应异常。标准组命令缺少旧字典明细时,引用指向目标库现有的 defaultcommand,无可用定义时将引用置空,指令内容由资源备份恢复。

重置执行与失败位置 ​

ResetDatabaseFromSqlFileAsync 的顺序是:

  1. 拒绝空源/目标库名及不存在的脚本。rootConfig 空值、路径解析等发生在内部try之前,不能承诺所有错误都返回false。
  2. 使用不指定业务库的服务器连接查询 INFORMATION_SCHEMA.SCHEMATA,区分“源库不存在”和服务器/凭据连接失败。查询本身失败由外层捕获并返回false,不会被当成新装初始化。
  3. 源库存在时备份实际存在的资源表。备份同时包含模板主档和明细时须成功生成传感器依赖 SQL。同名源库和目标库都未创建时按新安装执行脚本,跨库更新缺少源库或备份失败时在重置前返回 false。
  4. 调用底层导入,selectDatabase: false,不把源库作为mysql的默认数据库参数;实际创建、删除或选库由脚本内容决定,并非helper自动替换脚本中的库名。
  5. 脚本执行后,对传入目标库执行连接/SELECT 1 检查。失败返回false,不撤销已经执行的脚本;检查通过只说明能连接,甚至不证明该库由本次脚本新建或schema正确。
  6. 有保留SQL时以 selectDatabase: true 回写目标库,再更新回写流程的节点标识;没有保留SQL或属于新安装初始化则直接返回true。导入或节点更新过程异常返回false,可能已有部分写入,没有整体事务、自动重试或回滚。

true 表示这条代码路径的检查通过,不证明所有源数据、表关系、业务账号权限或模板可用。源与目标的主机/凭据由传入配置克隆,方法不支持通过两个独立连接配置声明跨服务器迁移。

服务配置同步的实际保证 ​

SynchronizeInstalledServiceConfigs 从 ServiceConfig.Instance 取注册中心、x64主服务、dev主服务的路径,按顺序定位各自 cfg/MySql.config。未配置路径或文件不存在只记录并跳过,不创建文件;已有文件解析/写入异常向上传播,之前写过的文件不回滚。返回列表只统计本次调用了 UpdateConfigFile 并正常返回的路径,不是三个服务配置齐全的证明。

UpdateConfigFile 要求已有 configuration/appSettings,仅更新已存在的、大小写精确为 Host、Port、User、Password、Database 的add项,其它项保留。它不补缺失键;空appSettings、缺部分键也可以保存并算一次更新。保存直接写原文件,没有临时文件替换或自动备份。不能从“更新1个文件”推出连接参数完整、所有服务已切库或写入失败时原文件完整。

这里同步的是服务XML配置,不是模板迁移,也不负责保存应用设置或重载数据库连接。实际内容含凭据,不要把原文件或未经脱敏的日志写入文档/诊断回答。插件的其它MQTT/WinService配置同步仍归插件专题,不由本接口覆盖。

SQL执行与验证范围 ​

底层导入只检查路径、.sql扩展名、存在和非空,按流输入 mysql.exe;默认库参数不会限制脚本中的 USE、DDL或跨库语句。成功返回脚本完整路径,不返回业务行数校验结果;进程非零/流失败可能发生在部分SQL已经执行之后。字符集、密码传递、两小时预算及尝试终止子进程树的规则见外部工具边界,终止客户端不构成数据库回滚。

在获授权的隔离环境演练真实 dump/import,核对依赖、配置缺键及部分写失败,验证并发切配置或服务重启失败后的恢复。

基于 MIT License 发布。