平凯数据库 7.1.9-0.1 Release Notes

发版日期：2026 年 6 月 16 日

平凯数据库版本：7.1.9-0.1

Open-Core 版本：8.5.6

平凯数据库 v7.1.9-0.1 是 7.1.x LTS 版本线的重要增强版本。本版本重点提升物理复制的生产可用性，增强 SQL 执行性能与 MySQL 兼容能力，并补齐数据同步迁移、运维治理和稳定性方面的多项改进。

本版本重点聚焦：

• 物理复制生产可用性增强
• SQL 执行与优化器性能提升
• MySQL 兼容性与扩展能力增强
• 数据同步与迁移能力增强
• 大规模集群运维与资源治理增强
• 稳定性与安全修复

企业版功能增强

物理复制增强

• 优化物理复制相关 Admin SQL 的执行语义。ADMIN CREATE LOG REPLICATION、ADMIN ALTER LOG REPLICATION、ADMIN SWITCHOVER ... 默认等待后台 workflow 完成后再返回成功，避免 SQL 已返回但实际操作仍在执行的问题，降低自动化运维误判风险。

  • ADMIN CREATE LOG REPLICATION 新增 DETACHED 模式，支持异步提交 workflow，并返回 WORKFLOW_ID 供用户后续查询和跟踪。该模式适用于耗时较长、需要由外部系统跟踪状态的运维任务。

• 新增备集群自提升语法：

  ADMIN SWITCHOVER AS PRIMARY;

  该语法可在 Standby 集群直接执行，将当前备集群提升为新的 Primary，无需手动指定 cluster_id，降低主备切换过程中的误操作风险。原有 ADMIN SWITCHOVER PRIMARY TO <cluster_id> 语法继续兼容。

• 在 MAXIMUM_PERFORMANCE 模式下新增 Primary 启动阶段防脑裂保护机制。当系统检测到直连 Standby 已经切换为新的 Primary 时，旧 Primary 将阻止写相关能力恢复，避免异常恢复场景下出现双主写入风险。

  • 新增配置项 primary-start-check-timeout，用于控制 Primary 启动时等待 Standby 状态检查的最长时间。若 Standby 无响应，超时后 Primary 可继续启动，避免启动流程被永久阻塞。

• 优化物理复制链路状态展示。相关系统表可更准确反映链路心跳、Failover 状态以及 Source Cluster 信息，提升容灾演练、故障切换和链路排查效率。

• 物理复制支持开启 TLS/mTLS 的安全集群场景，支持主备集群间证书互信以及 TLS 安全连接下的复制链路建立和状态检查，更好满足金融、政企等高安全要求环境。

MySQL 兼容性与扩展能力增强

• 支持 MySQL 兼容的 Loadable UDF。用户可以通过 CREATE FUNCTION ... SONAME 注册共享库函数，并从 TiDB 配置的 plugin_dir 动态加载第三方 .so 库，在 SQL 中直接调用自定义函数。

  • Loadable UDF 当前支持 INTEGER、REAL、DECIMAL 和 STRING 返回类型，适用于行业自定义函数、加密处理、编码转换、算法扩展等数据库侧计算场景。

优化器与 SQL 执行性能增强

• 优化窗口函数执行计划。对于 row_number() 等满足条件的窗口函数，当输入数据已经满足 PARTITION BY ... ORDER BY ... 所需顺序时，优化器可以直接利用索引有序性，减少额外 Sort 和物化开销。

  • 该优化适用于“分组取最新记录”等高频业务场景。例如在存在 (partition_key, order_time) 联合索引时，系统可更好利用索引顺序执行：

    row_number() over (
    partition by partition_key
    order by order_time desc
    )

• 存储过程、函数和 Trigger 内部的静态 SQL 支持复用 Prepared Plan Cache。对于满足条件的内部 SQL，系统可自动复用缓存执行计划，降低高频调用场景下的重复优化开销；不满足条件的 SQL 将自动回退到原有执行路径，不影响 SQL 语义和使用方式。

数据同步与迁移增强

• TiDB Lightning 优化视图恢复流程。在目标集群开启 sql_require_primary_key=ON 时，Lightning 恢复视图不再依赖无主键占位表，避免包含视图的数据导入任务因主键要求失败。

  • Lightning 可自动解析视图依赖关系，并按正确顺序恢复视图对象，提升包含复杂视图依赖的数据迁移稳定性。

• TiCDC 支持表路由映射。用户可以将源端库表同步到不同名称的目标库表，例如将 trade.t_order 同步到 archive.t_order_history，适用于实时归档、中心库建设和数据治理场景。

  • TiCDC 表路由映射当前支持 MySQL Sink 场景下的 DML 目标表改写、DDL 元数据改写和 DDL Query Rewrite。第一阶段暂不支持多源多表汇聚到同一张目标表。

SQL 与使用体验增强

• tidb_shard() 函数支持字符串类型输入，包括 VARCHAR、CHAR 等。用户可以基于字符串主键、订单号、租户 ID、UUID 等字段进行热点打散，原有数值类型行为保持兼容。

• 当查询中引用分区表的 _tidb_rowid 时，TiDB 将追加 warning，提示 _tidb_rowid 在分区表中并非全局唯一，建议结合分区 ID 一起使用以保证行定位唯一性。该增强不改变 SQL 执行结果。

运维与资源治理增强

• tiup cluster upgrade 和 tiup cluster reload 新增可选参数：

  --skip-leader-balance-wait

  • 启用后，TiUP 在 TiKV 节点恢复正常后即可继续处理下一个节点，不再等待 Leader Balance 完成，可显著缩短大规模集群滚动升级和变更窗口时间。PD 后台调度行为保持不变，Leader Balance 会在升级完成后继续异步收敛。

性能优化

• 补齐上游已验证的 IMPORT INTO 与 checksum 相关性能优化，降低大表和高并发导入、校验场景下的 CPU 开销，提升大规模数据处理场景的执行效率。该优化不涉及 SQL 语义和用户接口变更。

缺陷修复

高可用与物理复制

• 修复物理复制备集群在极端大规模 Region 场景下追日志可能永久卡住的问题。

• 修复物理复制链路下主集群添加索引可能长时间卡住的问题。

• 修复物理复制内部动作在 TiDB 重启后可能短暂出现 TS 异常的问题。

• 修复物理复制链路变更、主备切换和链路删除场景下的多项稳定性问题，包括锁残留、元信息异常以及切换后短暂数据回退等问题。

TiKV 与 CDC 稳定性

• 修复 TiKV-CDC 在高并发大事务纯 Insert 跑批场景下可能导致 CDC Worker CPU 使用率过高的问题。

• 修复 witness 切换为 non-witness 场景下 snapshot 可能被错误取消的问题。

• 修复高并发批量写入场景下 BR log 可能卡住的问题。

集群与运维稳定性

• 修复 even-replicas 两副本部署场景下，PD 在重启、降级和 runtime rejoin 过程中的多项稳定性问题。

• 修复 LOAD DATA 在特定场景下可能长时间卡住且无法终止的问题。

• 修复查询慢日志在无过滤条件场景下结果不完整的问题。

• 修复 v7.1.9-0.0 中 TiKV 版本号展示异常的问题。

SQL 与兼容性修复

• 修复视图加别名场景下权限校验异常的问题。

• 修复 ANALYZE 长时间卡住且无法终止的问题。

• 修复反斜杠（\）转义行为与 MySQL 不一致的问题。

• 修复 DDL 变更过程中旧版本表结构引用异常的问题。

• 修复特定统计信息缺失场景下可能触发空指针错误的问题。

安全与依赖治理

• 升级 TiDB、TiKV、TiFlow、Monitoring 和 TEM 中的多项第三方依赖组件，修复已知安全漏洞并增强系统安全性。

兼容性与使用说明

• 物理复制相关 Admin SQL 默认执行语义由“后台 workflow 创建成功即返回”调整为“等待 workflow 完成后返回”。如需快速返回，可使用新增的 DETACHED 模式。

• ADMIN SWITCHOVER AS PRIMARY 仅允许在 Standby 集群执行。

• --skip-leader-balance-wait 参数默认关闭。启用后，Leader Balance 会在后台继续异步完成，升级完成后一段时间内可能存在 Leader 分布尚未完全均衡的情况。

• TiCDC 表路由映射第一阶段暂不支持多源多表汇聚到同一张目标表。

• Loadable UDF 依赖 plugin_dir 配置和 CGO 构建环境，建议在生产使用前结合安全策略和部署规范进行验证。

• 物理复制相关能力建议在生产使用前充分验证，并结合用户文档确认部署拓扑、切换流程和安全配置要求。