MySQL 结果索引优化、清理、备份与失败边界
当前 MySQL 工具窗口的“数据清理”按钮打开统一维护窗口,结果表由 MySqlResultCleanupProvider(ID mysql-results)处理。它除表统计、保留月数和清理外,还提供手动结果关联索引优化;没有逐批次/逐行删除预览或 DatePicker,也不接受一组经预览批准的记录 ID。
索引优化会执行持久 MySQL DDL,清理会删除真实结果数据,备份会运行外部 mysqldump 并写 SQL 文件。本页不是运行授权或操作脚本。必须确认目标库、低负载或停写窗口、权限、临时空间、备份和恢复条件后再执行;不要为了验证文档调用 provider、命令或恢复接口。该 provider 不内置管理员/RBAC检查,窗口确认也不能替代现场授权;不能把方法可调用、界面可点或持有数据库凭据当成获准操作。
责任与目标表范围
provider 的 CleanupTableDefinitions 是结果清理白名单,核心分为四组:
| 表组 | 当前用途与关联 |
|---|---|
t_scgd_algorithm_result_master | 算法结果主表 |
已登记 t_scgd_algorithm_result_detail_* | 算法明细,历史清理优先按 pid → 主表.id |
t_scgd_measure_batch | 测量批次主表 |
已登记 t_scgd_measure_result_* | 测量明细,历史清理优先按 batch_id → 批次.id |
具体登记表以该数组为准,不因为新表具有相同前缀就自动允许清空。结果清理不是数据库重置;资源、模板和配置类表不在这组清理白名单中。表内图片路径也不代表其外部文件会随清理一起删除或随备份进入 SQL。
MySqlDatabaseMaintenanceService 的 SQL恢复、重置与资源保留是另一条契约,不能因名称含 Maintenance 就把它当成本页清理实现。MySqlLocalServicesManager 还留有旧 CleanupHistoryCommand / CleanupAllResultTablesCommand 实现;当前窗口按钮不绑定这些旧清理命令,不能将旧链的确认、表发现或失败行为套到新 provider。
手动优化结果关联索引
“优化结果查询索引”只在维护窗口由用户确认后调用 MySqlResultCleanupProvider.ExecuteOptimization()。它不是应用启动任务,不由 CodeFirst.InitTables 触发,也不会因为安装、升级主程序或加载 Engine 自动运行。直接调用 provider 仍会执行真实 DDL;手动入口不等于只读诊断。
优化只面向该 provider 登记的结果关系:
| 表组 | 目标关系列 | 当前边界 |
|---|---|---|
t_scgd_algorithm_result_master | batch_id | 为算法主结果按批次查询补关联索引 |
已登记 t_scgd_algorithm_result_detail_* | pid | 为明细按算法主结果查询及清理关联补索引 |
已登记 t_scgd_measure_result_* | batch_id | 为测量明细按批次查询及清理关联补索引 |
t_scgd_measure_batch | 不新增 | 不为已有父表主键关系重复创建索引;本动作也不补时间、名称或编码索引 |
执行时重新读取目标库的表、列和索引元数据。表或目标列不存在时跳过并汇总,不为缺失 schema 创建表或列;已有任意名称的等价 BTREE 索引,且目标关系列是其第一列时也跳过,因此复合索引以该列开头即可满足本次门禁。这里只判断本动作需要的首列关系,不证明已有索引选择性、统计信息或所有业务查询都最优。
provider 在同一数据库会话取得命名 advisory lock 后逐表串行执行 ALGORITHM=INPLACE, LOCK=NONE 的建索引 DDL,并在结束路径释放会话锁。advisory lock 只协调遵守同一锁名的优化调用,不暂停流程、DAO、其它客户端写入或任意外部 DDL;LOCK=NONE 允许兼容引擎在主要执行阶段继续读写,也不消除开始和结束阶段的 metadata lock、IO、CPU 与延迟波动。
语句显式要求 INPLACE 和 NONE;现场引擎、表定义或版本不支持时应失败,不会静默降级为 COPY。各条 DDL 独立隐式提交,没有跨表事务:中途失败时此前已建索引继续存在,后续目标可能尚未处理。该动作可安全重跑,因为已存在的等价首列 BTREE 会被跳过;“可重跑”不是自动回滚、自动继续或所有目标已经成功的证明,应核对汇总及现场 SHOW INDEX。
该动作不执行 DELETE / TRUNCATE,也不自动创建完整备份;维护窗口即使勾选“清理前备份”,优化入口也不会套用该选项。没有业务数据删除不等于 schema 变更无风险。应优先安排低负载时段,先确认表引擎、版本、长事务与 metadata lock,并为索引构建、在线 DDL 日志及临时排序预留空间;磁盘空间紧张时不要把 LOCK=NONE 当成可直接在生产运行的许可。
统计不是清理预览,连接也未冻结
LoadTables 从 INFORMATION_SCHEMA.TABLES 取白名单表的 data/index 大小,再逐表 Count。返回的是整表统计,不按将要使用的保留月数过滤;多个查询没有共同快照,统计行数不是将要删除的行数。清理执行会重新读取表/列信息,并非照着之前的统计逐行删除。
client 和 schema 查询都从当前 MySqlSetting.Instance.MySqlConfig 取配置;组合维护门不会冻结配置对象。不能只凭弹窗中曾显示的数据库名保证备份、删除和后续统计始终使用同一配置,应在维护期间禁止其它路径改变目标并核对实际连接。
按月历史删除
CleanupHistory(keepMonths) 进入维护门后,以执行时本地 DateTime.Now.AddMonths(-keepMonths) 为截止点。窗口先校验正整数,provider 公开方法没有同样校验;时间并非确认弹窗时冻结,也不是按日历整天或服务器时区自动对齐。比较为 < @cutoffDate,相等记录不在该条件中。
删除前先发现当前库已登记表及同前缀明细表。若有未登记的 t_scgd_algorithm_result_detail_* 或 t_scgd_measure_result_*,FindUnknownDetailTables 会拒绝本次历史清理;这个门禁不覆盖后述选表/全部截断路径。
时间列按 create_time、create_date、add_time 优先匹配。历史清理顺序是:
- 已登记算法明细:主表存在、有可识别时间列且明细有
pid时,INNER JOIN 主表,按主表日期删明细;否则尝试明细自己的时间列。 - 算法主表:有可识别时间列才按日期删除。
- 已登记测量明细:优先 INNER JOIN 批次表并按批次日期删除,否则尝试自己的时间列。
- 测量批次表:有可识别时间列才按日期删除。
缺少关联条件与可识别时间列时,该项可跳过或报告 0 行,并不阻止后续继续处理主表;走 INNER JOIN 时未关联到父行的孤儿记录不因此被清理。成功文字不证明所有过期或孤儿数据都已消失。时间值参数化,表/列标识符使用反引号转义,但并不据此构成完整 schema/业务关联验证。
此路径没有包围全部删除的 BeginTran / CommitTran / RollbackTran。按顺序先删子表只降低部分关联风险,不提供整体回滚;中途异常之前的删除可能已经生效。SummaryLines 只在正常返回时交给宿主,异常后不能用未显示汇总来判断零变更。
选表与全部截断
CleanupTables 的校验只做:非空输入、仅允许登记表名、忽略大小写去重、按依赖类别排序。CleanupAll 则传入全部登记表名。执行时重新查当前库,跳过不存在的表;“全部”是登记的结果表,不是所有数据库表。
实际顺序与按月清理不同:算法明细 → 测量明细 → 算法主表 → 测量批次;同组再按表名。代码先发 SET FOREIGN_KEY_CHECKS = 0,逐表 TRUNCATE TABLE,finally 尝试设置回 1。没有整体事务、自动备份或自动恢复,也不保存并恢复进入时的检查开关值;异常可能发生在已有表清空之后,finally 失败也不是补偿成功。
选表和全部截断不检查未知明细表,也不强制随主表选择所有关联明细。清空前须核对当前库的实际表关系与勾选范围。
维护门、完整备份与恢复的区别
MySqlLocalServicesManager.RunDatabaseMaintenance 使用进程内 SemaphoreSlim,以 AsyncLocal<int> 允许同一维护调用链嵌套。它串行化使用该入口的维护动作,不停止采集/流程,不阻止其它 DAO、浏览器、直接 SQL 或外部进程写入,也不是数据库事务。等待入口没有用户取消协议。
CreateBackup() 调用 BackupAllMysql();组合 ExecuteCleanupWithBackup 在同一维护门内先备份,再执行传入动作。普通清理是否自动备份由维护窗口策略决定。provider 自身的 CleanupHistory / CleanupTables / CleanupAll 不先备份。
索引优化不走 ExecuteCleanupWithBackup,也不读取“清理前备份”选项。它与普通清理共享“没有自动恢复、失败后先确认实际状态”的原则,但完成边界是逐表 DDL 及跳过汇总,不是删除行数或清理统计刷新。
完整 SQL 备份的实际过程是:
- 从当前库枚举
BASE TABLE,将库名和表名交给配置的mysqldump.exe;不是仅备份清理白名单,也不是 MySQL 服务器上所有库或整个项目工作区。 - 写入默认“我的文档/ColorVision/Backup”下的唯一
.sql.part,正常完成并确认非空后改名为最终.sql,再加入管理器备份列表。路径以实际BackupPath为准;失败尝试删除临时文件。 - 不试恢复、不逐表比对导出内容或验证业务数据一致性;“退出码为零 + 非空文件”不是恢复演练通过。
本入口不传 dataOnly: true;只有另一种 data-only 模式才显式添加 --single-transaction、--quick 等参数。因此不能给完整备份承诺代码显式建立了跨表一致快照;实际还受工具版本、默认选项、表引擎和并发写入影响。代码也没有显式启用存储过程/事件的备份选项。外部图片、项目 SQLite、其它库和服务配置不由这份 SQL 一起保护。
BackupMysqlResource 是另一种资源迁移备份,表清单和 --replace/依赖补充不同,不应拿它代替清理前完整结果备份。组合清理失败不自动调用恢复;MySQL provider 也没有像 Socket/Flow 包装那样把已生成备份路径追加进异常。文件可能已经生成,但宿主没有收到正常组合结果时,不保证失败弹窗列出它,需单独核对备份目录/列表。
手动SQL恢复不是撤销按钮;底层导入与桌面“导入→配置同步→注册中心重启”的完成条件不同,详见 MySQL恢复契约。恢复须独立授权,不能在清理异常后自行触发。
外部工具与错误边界
MySQL 进程使用 ProcessStartInfo.ArgumentList,不通过 shell 拼接重定向,配置 UTF-8 MB4,密码放子进程 MYSQL_PWD 环境变量而不是命令行。环境变量并非加密秘密存储;工具错误文本会进入异常,没有统一字段脱敏,分享输出前仍须检查。
导出/导入按流处理标准输入输出,等待进程和流任务;总执行预算为 2 小时。超时或流失败会尝试终止整个子进程树,并最多等待 15 秒观察收尾;终止本身可能失败并被记录。这个内部超时不等于维护窗口提供取消,更不保证终止客户端就回滚此前已执行 SQL。备份最终文件与业务恢复完成仍需分开核验。
验证范围
通过隔离演练核对实际 mysqldump/mysql、主从选择、生产表引擎、并发写入、metadata lock、索引构建临时空间、DDL 部分成功、删除后恢复、截断或断电后的恢复。
