Catalog、启动就绪与升级边界

实现基线为 v4.2.5。Catalog、运行时元数据缓存和用户可见系统表相关,但不能互相替代解释全部 DDL 行为。

DDL 与可见性

DDL 解析/绑定/权限 → 事务元数据修改 → 提交
    → Catalog/Logtail 状态传播 → CN 缓存/表定义 → 新语句绑定和执行

库表 ID、Schema、对象状态和事务时间戳共同决定可见性。同名表 DROP 后再 CREATE 不代表相同表 ID。Schema 改变还涉及已有计划、Prepared statement 和内部执行器上下文;在一个会话上执行 DDL 成功不能替代另一个 CN 的验收。

关键不变量:语句使用的表定义必须与其事务/读取状态匹配。DDL 的事务和隐式提交规则要按具体语句验证,不从 MySQL 通用经验或“DDL”分类一概推断。

启动与控制面

配置和存储 → LogService/HAKeeper bootstrap
    → TN 恢复并服务 → CN 引擎、内部执行器和 Catalog 订阅
    → 数据库服务就绪 → Proxy/客户端接入

这是依赖图,不承诺所有部署都由一个顺序脚本启动。HAKeeper 维护心跳/集群状态并产生调度命令;ClusterService、TaskService 与 Operator 分别承担不同职责。Pod Running、端口开放、Catalog 同步和可提交事务是不同检查。

Proxy 和升级

租户/标签路由、连接迁移、运行中事务与分布式查询需要分别处理。迁移涉及会话状态和连接协议;不能承诺任意时刻透明迁移所有活跃事务。滚动升级还需要检查构建兼容、物理计划/RPC、锁绑定和后台任务。

升级验收记录源/目标版本、Operator 版本、配置变化、兼容路径和回退条件;在实验集群测试活跃事务、Prepared 执行、取消、长查询、CDC/索引后台工作和恢复。数据格式/元数据升级不自动支持二进制降级。

排查

启动失败按存储/日志、HAKeeper bootstrap、TN Replay、Catalog 订阅、内部 SQL、服务 ready 分段定位。DDL 之后元数据异常记录表 ID、Schema、SQL、提交状态、CN 和构建,不以缓存清理替代根因。

参见 Operator、Proxy、隐式事务。

源码与回归入口