blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
652c0c01e011b3e8caa5d21540520d0283263c88
railwaysystem/docs/database-v2/08_gate_ab_validation.md
T

8.8 KiB
Raw Blame History

RailwaySystem 数据库 V2 双门禁验证报告 (Gate A / Gate B)

本文档记录 RailwaySystem 数据库 V2 测试迁移准入阶段在真实环境下的双门禁（Gate A 与 Gate B）实测验证结果。

一、验证环境与连接上下文

配置项 实际环境参数 状态
数据库版本 KingbaseES V009R003C018 正常连通
数据库实例 training 确认
当前 Schema public 确认
会话 search_path public, sys_catalog 确认
数据库模式 database_mode = mysql 确认
JDBC 驱动 com.kingbase8:kingbase8:8.6.0 (via preferQueryMode=simple) 官方原生驱动
连接安全性 脱敏隧道接入，无外部明文暴露 合规

二、Gate A: 事务回滚能力探测验证

2.1 执行目标与原则

  • 验证脚本: RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql
  • 执行目标: 探测当前 KingbaseES 实例在 database_mode = mysql 下是否支持 DDL + BEGIN / ROLLBACK 事务原子性回滚能力。
  • 约束: 仅在临时对象 public.__railway_v2_tx_probe 上执行，绝不触碰任何业务表。

2.2 验证结果矩阵

探测步骤 预期行为 实际执行结果 判定
1. 显式开启事务 BEGIN; 事务启动成功 PASS
2. 探针表建表 CREATE TABLE public.__railway_v2_tx_probe (id INTEGER); 表创建成功 PASS
3. 探针表改表 ALTER TABLE public.__railway_v2_tx_probe ADD COLUMN test_col INTEGER; 字段追加成功 PASS
4. 显式回滚事务 ROLLBACK; 事务回滚成功 PASS
5. 匿名块断言 DO $$ ... $$; 检查表是否存在并发出提示 收到 [Probe-PASS] 通知 PASS
6. 最终只读断言 SELECT count(*) FROM information_schema.tables WHERE ... 为 0 count = 0 PASS

2.3 Gate A 关键原始日志

==================================================
>>> 正在启动 Gate A: 000_tx_capability_probe.sql
>>> 目标文件: RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql
==================================================
Database: training, Schema: public
Database Mode: mysql
Version: KingbaseES V009R003C018
>>> 开始执行 000_tx_capability_probe.sql 内容 (preferQueryMode=simple)...
Statement [1] update count: 0
>>> [STMT NOTICE/WARNING] >>> [Probe-PASS] 数据库 DDL 事务原子性验证通过：Kingbase 实例支持 DDL 事务回滚，符合 V2 迁移安全前提。
Statement [2] update count: 0
Statement [3] update count: 0
Statement [4] update count: 0
Statement [5] update count: 0
>>> 000_tx_capability_probe.sql 脚本执行完成，无异常抛出。
>>> 验证探针表残留情况 (SELECT count(*) FROM information_schema.tables)...
>>> public.__railway_v2_tx_probe count = 0
==================================================
>>> [GATE A FINAL EVALUATION]: PASS
==================================================

2.4 Gate A 结论

Gate A = PASS。当前 KingbaseES 实例完全支持本次 V2 迁移所依赖的 DDL 事务原子性回滚能力，探针表完全回滚且零残留。

三、Gate B: Phase 0.5 基线强校验验证

3.1 执行目标与原则

  • 验证脚本: RuoYi-Vue/sql/train/v2/000_preflight.sql
  • 执行目标: 纯只读核验当前真实数据库精确处于 Phase 0.5 基线状态，杜绝环境漂移或非纯净基线。

3.2 验证结果矩阵

核验分类 核验项 期望值 实测值 判定
Schema 确认 会话 Schema public public PASS
业务表集合 14 张 Phase 0.5 历史表集合全等 仅这 14 张 train_* 14 张精确存在 PASS
表差异探测 MISSING_TABLE 0 0 PASS
表差异探测 UNEXPECTED_TABLE 0 0 PASS
数据行数基线 train_teacher 1 行 1 行 PASS
数据行数基线 其余 13 张旧业务表 全部 0 行 全部 0 行 PASS
V2 新增表 8 张 V2 新表存在性 全部不存在 (0) 全部不存在 (0) PASS
主键约束 14 个旧表 PK 定义 14/14 匹配 14/14 匹配 PASS
自增列 6 个旧表 Identity 主键 6/6 匹配 6/6 匹配 PASS
唯一约束 7 组旧表 UNIQUE 约束 7/7 匹配 7/7 匹配 PASS
外键约束 24 组旧表 FK 约束 (名称/源列/引用表/引用列) 24/24 匹配 24/24 匹配 PASS
触发器 9 个 update_time 触发器 9/9 匹配 9/9 匹配 PASS
旧字段特征 旧列特征检查 (c_id, t_id, lesson_start_time 等) 符合旧模型 符合旧模型 PASS
系统底座表 sys_* 基础表数据完整性 1/106/15/44/500 1/106/15/44/500 PASS

3.3 14 张 Phase 0.5 业务表行数实测明细

  • train_teacher: 1 行
  • train_student: 0 行
  • train_course: 0 行
  • train_class_plan: 0 行
  • train_dormitory_info: 0 行
  • train_dorm_auth: 0 行
  • train_classroom_info: 0 行
  • train_training_site: 0 行
  • train_class_report: 0 行
  • train_electronic_board: 0 行
  • train_student_checkin: 0 行
  • train_score_info: 0 行
  • train_study_duration: 0 行
  • train_student_portrait: 0 行

3.4 8 张 V2 新增表独立只读探测

  • train_resource: 不存在 (count = 0)
  • train_course_resource: 不存在 (count = 0)
  • train_plan_course: 不存在 (count = 0)
  • train_enrollment: 不存在 (count = 0)
  • train_lesson: 不存在 (count = 0)
  • train_accommodation: 不存在 (count = 0)
  • train_score_item: 不存在 (count = 0)
  • train_student_score: 不存在 (count = 0)

3.5 Gate B 关键原始日志

==================================================
>>> 正在启动 Gate B: 000_preflight.sql
>>> 目标文件: RuoYi-Vue/sql/train/v2/000_preflight.sql
==================================================
Database: training, Schema: public
Database Mode: mysql
Version: KingbaseES V009R003C018

>>> 开始执行 000_preflight.sql 脚本 (只读强校验)...
[PREFLIGHT LOG] ==============================================================================
[PREFLIGHT LOG] >>> [Preflight-PASS] Phase 0.5 精确骨架校验全部通过！
[PREFLIGHT LOG] >>> 核验项: 14旧表 + 14 PK + 24 FK + 7 UNIQUE + 6 Identity + 9 Triggers + 行数基线
[PREFLIGHT LOG] >>> 判定结果: 当前数据库处于纯净 Phase 0.5 历史基线状态，允许执行 V2 迁移。
[PREFLIGHT LOG] ==============================================================================
>>> 000_preflight.sql 脚本执行成功，全部内部断言 PASS！

==================================================
>>> 开始收集 Phase 0.5 详细只读核验明细数据...
==================================================
Probe Table '__railway_v2_tx_probe' Count: 0

Actual train_* tables count: 14
Actual train_* tables list: [train_class_plan, train_class_report, train_classroom_info, train_course, train_dorm_auth, train_dormitory_info, train_electronic_board, train_score_info, train_student, train_student_checkin, train_student_portrait, train_study_duration, train_teacher, train_training_site]

Row count per train_* table:
  - train_class_plan: 0 行
  - train_class_report: 0 行
  - train_classroom_info: 0 行
  - train_course: 0 行
  - train_dorm_auth: 0 行
  - train_dormitory_info: 0 行
  - train_electronic_board: 0 行
  - train_score_info: 0 行
  - train_student: 0 行
  - train_student_checkin: 0 行
  - train_student_portrait: 0 行
  - train_study_duration: 0 行
  - train_teacher: 1 行
  - train_training_site: 0 行

Checking V2 new tables existence:
  - train_resource: NOT EXISTS (PASS)
  - train_course_resource: NOT EXISTS (PASS)
  - train_plan_course: NOT EXISTS (PASS)
  - train_enrollment: NOT EXISTS (PASS)
  - train_lesson: NOT EXISTS (PASS)
  - train_accommodation: NOT EXISTS (PASS)
  - train_score_item: NOT EXISTS (PASS)
  - train_student_score: NOT EXISTS (PASS)

Primary Keys count: 14 (expected: 14)
Foreign Keys count: 24 (expected: 24)
Unique constraints count: 7 (expected: 7)
Identity columns count: 6 (expected: 6)
Triggers count: 9 (expected: 9)

==================================================
>>> [GATE B FINAL EVALUATION]: PASS
==================================================

3.6 Gate B 结论

Gate B = PASS。当前数据库精确处于 Phase 0.5 迁移起点状态，无任何缺失、漂移或意外对象。

四、双门禁总体结论与状态说明

  1. 准入资格判定:

    • Gate A: PASS
    • Gate B: PASS
    • 结论: 数据库 V2 迁移正式获得 Stage 1 (001_backup_current_schema.sql) 执行准入资格。

  2. 迁移脚本执行边界声明:

    • 截至 Gate A/B 完成与报告生成时，001~010 正式数据库迁移脚本均未执行。
    • 数据库依然保持纯净 Phase 0.5 状态。
Reference in new issue View Git Blame Copy Permalink