TiDB 7.5.2 Release Notes

TiDB 7.5.2 Release Notes

发版日期：2024 年 6 月 13 日

TiDB 版本：7.5.2

试用链接：快速体验 | 生产部署 | 下载离线包

兼容性变更

在 TiKV 中提供 RocksDB track-and-verify-wals-in-manifest 配置，用于调查 WAL (Write Ahead Log) 可能损坏问题 #16549 @v01dstar
TiDB Lightning 使用严格格式 strict-format 或 SPLIT_FILE 导入 CSV 文件时必须设置行分隔符 #37338 @lance6716
针对 TiCDC Open Protocol，添加 sink.open.output-old-value 配置项来控制是否输出更新前的值到下游 #10916 @sdojjy
在之前的版本中，TiCDC 在处理包含 UPDATE 变更的事务时，如果事件的主键或者非空唯一索引的列值发生改变，则会将该条事件拆分为 DELETE 和 INSERT 两条事件。从 v7.5.2 开始，当使用 MySQL Sink 时，如果 UPDATE 变更所在事务的 commitTS 小于对应表开始向下游同步数据时从 PD 获取的当前时间戳 thresholdTS，TiCDC 就会将该 UPDATE 事件拆分为 DELETE 和 INSERT 两条事件，然后写入 Sorter 模块。该行为变更解决了由于 TiCDC 接收到的 UPDATE 事件顺序可能不正确，导致拆分后的 DELETE 和 INSERT 事件顺序也可能不正确，从而引发下游数据不一致的问题。更多信息，请参考用户文档。#10918 @lidezhu

改进提升

TiDB
- 优化 ANALYZE 语句卡住元数据锁的问题 #47475 @wjhuang2016
- 优化表达式默认值在 SHOW CREATE TABLE 结果中的 MySQL 兼容性 #52939 @CbcWestwolf
- 增强 TiDB 对始终为 false 的 DNF 项的处理能力，直接忽略这种过滤条件，以避免不必要的全表扫描 #40997 @hi-rustin
- 优化 EXPLAIN ANALYZE 中 TiFlash TableScan 算子执行过程的统计信息 #51727 @JinheLin
- 在 MPP 负载均衡时移除不包含任何 Region 的 Store #52313 @xzhangxian1008
- 支持从 PD 批量加载 Region，加快在对大表进行查询时，从 KV Range 到 Regions 的转换过程 #51326 @SeaRise
- 在 Resource Control 监控页面，新增 RU(Max) 面板用于展示各个资源组的最大 RU 消耗速率 #49318 @nolouch
- 改进 sync load 的性能，减少加载统计信息的延时 #52994 hawkingrei
- 提升统计信息初始化的并发度，加速启动速度 #52466 #52102 #52553 hawkingrei
TiKV
- 将 Coprocessor 遇到错误时的日志输出级别从 warn 调整为 debug，以减少集群中不必要的日志输出 #15881 @cfzjywxk
- 添加 CDC event 的等待处理时长监控指标，便于排查下游 CDC event 延迟问题 #16282 @hicqu
- 在 raftstore 线程中避免进行快照文件的 IO 操作，提高 TiKV 稳定性 #16564 @Connor1996
- 增加 peer 和 store 消息的 slow log #16600 @Connor1996
- 当 TiKV 检测到存在损坏的 SST 文件时，记录损坏的具体原因 #16308 @overvenus
- 删除非必要的 async block 以减少内存使用 #16540 @overvenus
- 加快 TiKV 停机的速度 #16680 @LykxSassinator
PD
- 升级 etcd 版本至 v3.4.30 #7904 @JmPotato
- 增加每秒 max RU (Request Unit) 的监控指标 #7908 @nolouch
TiFlash
- 降低 TiFlash 在开启 TLS 后因更新证书而导致 panic 的概率 #8535 @windtalker
Tools
- Backup & Restore (BR)
  - BR 在恢复数据过程中，会清理空的 SST 文件 #16005 @Leavrth
  - 增加 PITR 集成测试用例，覆盖对日志备份与添加索引加速功能的兼容性测试 #51987 @Leavrth
  - 提高日志备份对 Merge 的容忍度，如果遇到合理的长时间 Merge 操作，日志备份任务不容易进入 Error 状态 #16554 @YuJuncen
  - 提升了 RESTORE 语句在大数据量表场景下的建表性能 #48301 @Leavrth
  - 支持在恢复过程中提前分配好 Table ID，从而最大限度地复用 Table ID，提升恢复性能 #51736 @Leavrth
  - 移除日志备份启动时检查是否存在活动 DDL job 的无效检查 #52733 @Leavrth
  - 移除使用 Google Cloud Storage (GCS) 作为外部存储时一个过时的兼容性检查 #50533 @lance6716
  - 增加由于 DNS 错误而导致的失败的重试次数 #53029 @YuJuncen
- TiCDC
  - 提升使用 redo log 恢复数据过程中的内存稳定性，减少 OOM 的概率 #10900 @CharlesCheung96
  - 显著提升事务冲突场景中的数据同步的稳定性，性能最高提升可达 10 倍 #10896 @CharlesCheung96
  - 开启 PD client 转发功能，提升 TiCDC 和 PD leader 之间存在网络隔离时 TiCDC 的稳定性 #10849 @asddongmen
  - 提升同步任务初始化速度 #11124 @asddongmen
  - 采用异步方式初始化同步任务，减少 Processor 和 Owner 的初始化时间 #10845 @sdojjy
  - 自动探测 Kafka 集群版本，提升与 Kafka 的兼容性 #10852 @wk989898

错误修复

TiDB
- 修复添加唯一索引时并发 DML 导致数据索引不一致的问题 #52914 @wjhuang2016
- 修复在分区表上使用 multi-schema change 添加索引导致数据索引不一致的问题 #52080 @tangenta
- 修复添加多值索引导致数据索引不一致的问题 #51162 @ywqzzy
- 修复网络问题导致 DDL 卡住的问题 #47060 @wjhuang2016
- 修复 TiDB 启动加载统计信息时可能因为 GC 推进报错的问题 #53592 @you06
- 修复 TiDB 可能向未准备就绪的 TiKV 发起请求的问题 #50758 @zyguan
- 修复滚动重启 TiKV 后可能导致 Stale Read 不命中的问题 #52193 @zyguan
- 修复 KV request 重试时可能存在数据竞争并导致 TiDB panic 的问题 #51921 @zyguan
- 修复解析索引数据时可能发生 panic 的问题 #47115 @zyguan
- 修复 JOIN 条件包含隐式类型转换时 TiDB 可能 panic 的问题 #46556 @qw4990
- 修复 YEAR 类型的列与超出范围的无符号整数进行比较导致错误结果的问题 #50235 @qw4990
- 修复 UPDATE List 中包含子查询可能会导致 TiDB panic 的问题 #52687 @winoros
- 修复 Longlong 类型在谓词中溢出的问题 #45783 @hawkingrei
- 修复在聚簇索引作为谓词时 SELECT INTO OUTFILE 不生效的问题 #42093 @qw4990
- 修复 TopN 算子可能被错误地下推的问题 #37986 @qw4990
- 修复空 Projection 导致 TiDB panic 的问题 #49109 @winoros
- 修复当索引计划保持有序时，索引合并错误地下推部分限制条件的问题 #52947 @AilinKid
- 修复在递归 CTE 中无法使用视图的问题 #49721 @hawkingrei
- 修复 UPDATE 语句可能因为列的唯一 ID 不稳定导致查询报错的问题 #53236 @winoros
- 修复执行谓词总是为 true 的 SHOW ERRORS 语句导致 TiDB panic 的问题 #46962 @elsa0520
- 修复 Massively Parallel Processing (MPP) 中 final AggMode 和 non-final AggMode 无法共存的问题 #51362 @AilinKid
- 修复错误的 TableDual 计划导致查询结果为空的问题 #50051 @onlyacat
- 修复同时启用 lite-init-stats 和 concurrently-init-stats 后，初始化统计信息时 TiDB 可能 panic 的问题 #52223 @hawkingrei
- 修复 NO_JOIN 相关的 Hint 无法与 CREATE BINDING 一起使用的问题 #52813 @qw4990
- 修复 ALL 函数中包含子查询时可能会出现错误结果的问题 #52755 @hawkingrei
- 修复 VAR_SAMP() 无法作为窗口函数的问题 #52933 @hi-rustin
- 修复列裁剪未对数组进行浅拷贝可能导致 TiDB panic 的问题 #52768 @winoros
- 修复添加唯一索引可能导致 TiDB panic 的问题 #52312 @wjhuang2016
- 修复 TiDB Server 在初始化完成之前就标记为 Health 的问题 #51596 @shenqidebaozi
- 修复 IFNULL 函数返回的类型和 MySQL 不一致的问题 #51765 @YangKeao
- 修复并行 Apply 在表为聚簇索引时可能导致结果错误的问题 #51372 @guo-shaoge
- 修复当子查询中的 HAVING 子句包含关联列时，查询结果可能出错的问题 #51107 @hawkingrei
- 修复查询 TIDB_HOT_REGIONS 表时结果返回内存表的问题 #50810 @Defined2014
- 修复 TiDB 在统计信息初始化完成前就开始自动收集的问题 #52346 @hi-rustin
- 修复在 AUTO_ID_CACHE=1 时，AutoID Leader 发生变更可能造成自增列的值减少的问题 #52600 @tiancaiamao
- 修复当使用 CTE（公共表达式）访问缺少统计信息的分区表时，查询结果可能出错的问题 #51873 @qw4990
- 修复 TiDB Dashboard 监控页面中连接数 (Connection Count) 的计算和显示错误 #51889 @YangKeao
- 修复在恢复含有外键的表时 DDL 卡住的问题 #51838 @YangKeao
- 修复当列的默认值被删除时，获取该列的默认值会报错的问题 #50043 #51324 @crazycs520
- 修复在配置 force-init-stats 的情况下，TiDB 没有监听对应端口的问题 #51473 @hawkingrei
- 修复 IN() 谓词中包含 NULL 时，查询结果错误的问题 #51560 @winoros
- 修复 TiDB 统计信息同步加载机制无限重试加载空统计信息并打印 fail to get stats version for this histogram 日志的问题 #52657 @hawkingrei
- 修复 EXCHANGE PARTITION 在处理外键时判断错误的问题 #51807 @YangKeao
- 修复 LIMIT 可能无法推入到 OR 类型的 Index Merge 的问题 #48588 @AilinKid
- 修复关联子查询中 TopN 算子结果不正确的问题 #52777 @yibin87
- 修复 CPS by type 监控项显示错误的问题 #52605 @nolouch
- 修复当某些列的统计信息没有完全加载时，EXPLAIN 语句的结果中可能会显示错误的列 ID 的问题 #52207 @time-and-fate
- 修复关闭新排序规则框架时，涉及不同排序规则的表达式可能导致查询 panic 的问题 #52772 @wjhuang2016
- 修复当 SQL 语句涉及包含多值索引的表时，执行可能报错 Can't find a proper physical plan for this query 的问题 #49438 @qw4990
- 修复 TiDB 无法正确转换表达式中系统变量类型的问题 #43527 @hi-rustin
- 修复执行 INSERT IGNORE 可能出现唯一索引和数据不一致的问题 #51784 @wjhuang2016
- 修复自动统计信息收集在 OOM 后卡住的问题 #51993 @hi-rustin
- 修复启用 tidb_mem_quota_analyze 时，更新统计信息使用的内存超过限制可能导致 TiDB crash 的问题 #52601 @hawkingrei
- 修复 max_execute_time 多层设置相互影响的问题 #50914 @jiyfhust
- 修复使用单个 SQL 语句添加多个索引导致的索引不一致问题 #51746 @tangenta
- 修复窗口函数中有某些子查询时可能会 panic 的问题 #42734 @hi-rustin
- 修复 shuffleExec 意外退出导致 TiDB 崩溃的问题 #48230 @wshwsh12
- 修复回滚改写分区 DDL 任务时，状态卡住的问题 #51090 @jiyfhust
- 修复一些情况下查询 BINARY 类型的 JSON 可能会报错的问题 #51547 @YangKeao
- 修复开启分布式执行框架后为大数据量的表添加索引不成功的问题 #52640 @tangenta
- 修复 TTL 功能在某些情况下因为没有正确切分数据范围而造成数据热点的问题 #51527 @lcwangchao
- 修复主键类型是 VARCHAR 时，执行 ALTER TABLE ... COMPACT TIFLASH REPLICA 可能会错误地提前结束的问题 #51810 @breezewish
- 修复添加索引期间升级集群导致数据索引不一致的问题 #52411 @tangenta
- 修复关闭 TableDual 的 Predicate 下推后，出现性能回退的问题 #50614 @time-and-fate
- 修复 TiDB Server 通过 HTTP 接口添加 label 返回成功但不生效的问题 #51427 @you06
- 修复 ingest 模式添加索引时，在某些特殊情况下导致数据索引不一致的问题 #51954 @lance6716
- 修复 init-stats 流程可能导致 TiDB panic 以及 load stats 流程直接退出的问题 #51581 @hawkingrei
- 修复当配置文件中出现不合规的配置项时，配置文件不生效的问题 #51399 @Defined2014
- 修复当 SQL 语句中包含 JOIN 且 SELECT 列表只包含常量时，使用 MPP 执行查询可能导致查询结果出错的问题 #50358 @yibin87
- 修复在 determinate 模式下 (tidb_opt_objective='determinate')，如果查询不包含谓词，可能无法加载统计信息的问题 #48257 @time-and-fate
- 修复某些情况下 SHOW CREATE PLACEMENT POLICY 语句不显示 SURVIVAL_PREFERENCES 属性的问题 #51699 @lcwangchao
- 修复 IndexJoin 在 Left Outer Anti Semi 类型下计算哈希值时产生重复行的问题 #52902 @yibin87
- 修复 TIMESTAMPADD() 函数结果错误的问题 #41052 @xzhangxian1008
- 修复将数据从 FLOAT 类型转换为 UNSIGNED 类型时结果错误的问题 #41736 @guo-shaoge
- 修复 TRUNCATE() 函数的第二个参数为大负数时结果错误的问题 #52978 @yibin87
- 修复 Grafana 中重复的面板 ID 可能导致展示异常的问题 #51556 @D3Hunter
- 修复打印 gRPC 错误日志时 TiDB 意外重启的问题 #51301 @guo-shaoge
- 修复 TiDB 启动时由于加载统计信息可能导致 TiDB OOM 的问题 #52219 @hawkingrei
- 修复删除表之后该表的 TTL 任务不会停止的问题 #51540 @YangKeao
TiKV
- 修复 TiKV 日志中 thread_id 值错误地显示为 0x5 的问题 #16398 @overvenus
- 修复测试用例不稳定的问题，确保每次测试都使用独立的临时目录，从而避免在线配置更改影响其他测试用例 #16871 @glorv
- 修复 Binary 转 JSON 过程中 TiKV 可能 panic 的问题 #16616 @YangKeao
- 修复 tikv-ctl 的 raft region 命令的输出中未包含 Region 状态信息的问题 #17037 @glorv
- 修复某个 TiKV 节点 check-leader 慢导致其他 TiKV 节点 resolved-ts 无法正常推进的问题 #15999 @crazycs520
- 修复 Peer 销毁过程被 apply snapshot 操作中断后，没有在 apply snapshot 完成后继续执行销毁操作的问题 #16561 @tonyxuqqi
- 修复 DECIMAL 类型的小数部分在某些情况下不正确的问题 #16913 @gengliqi
- 修复查询中 CONV() 函数在进行数制转换时可能 overflow 导致 TiKV panic 的问题 #16969 @gengliqi
- 修复巴西和埃及时区转换错误的问题 #16220 @overvenus
- 修复监控指标 tikv_unified_read_pool_thread_count 有时没有数据的问题 #16629 @YuJuncen
- 修复 RocksDB 中非活跃的 WAL (Write Ahead Log) 可能损毁数据的问题 #16705 @Connor1996
- 修复由于过时的 Region peer 忽略 GC 消息导致 resolve-ts 被阻塞的问题 #16504 @crazycs520
- 修复乐观事务在执行期间被其它事务发起 resolve lock 时，如果事务的 primary key 上之前有通过异步提交 (Async Commit) 或一阶段提交 (1PC) 模式提交的数据，事务的原子性可能有小概率被破坏问题 #16620 @MyonKeminta
PD
- 修复 TiDB 网络分区故障恢复后可能导致连接 panic 的问题 #7926 @CabinfeverB
- 修复执行在线数据恢复后，调度可能被错误暂停的问题 #8095 @JmPotato
- 修复开启资源组后，CPS By Type 监控类型显示错误的问题 #52605 @nolouch
- 修复通过配置文件更改日志级别不生效的问题 #8117 @rleungx
- 修复取消资源组查询导致大量重试的问题 #8217 @nolouch
- 修复 ALTER PLACEMENT POLICY 无法修改 placement policy 的问题 #52257 #51712 @jiyfhust
- 修复使用 placement policy 的情况下，down peer 可能无法恢复的问题 #7808 @rleungx
- 修复手动切换 PD leader 可能失败的问题 #8225 @HuSharp
- 修复写热点调度可能会违反放置策略 (placement policy) 约束的问题 #7848 @lhy1024
- 修复资源组 (Resource Group) 客户端中未完全删除的 slot 导致分配 token 低于给定值的问题 #7346 @guo-shaoge
- 修复扩缩容进度显示不准确的问题 #7726 @CabinfeverB
- 修复两数据中心部署切换时 Leader 无法迁移的问题 #7992 @TonsnakeLin
- 修复 PD 的 Filter target 监控指标未提供 scatter range 信息的问题 #8125 @HuSharp
- 修复 SHOW CONFIG 的查询结果包含已废弃的 trace-region-flow 配置项的问题 #7917 @rleungx
TiFlash
- 修复在存算分离架构下，DDL 新增带有 not null 属性的列后，查询可能返回错误的 null 值的问题 #9084 @Lloyd-Pottiger
- 修复在含空分区的分区表上执行查询时，可能会超时的问题 #9024 @JinheLin
- 修复存算分离架构下，TiFlash 计算节点进程停止时可能出现 panic 的问题 #8860 @guo-shaoge
- 修复查询生成列出错的问题 #8787 @guo-shaoge
- 修复从低于 v6.5.0 的集群升级到 v6.5.0 及以上版本后，可能出现 TiFlash 元数据损坏以及进程 panic 的问题 #9039 @JaySon-Huang
- 修复 ENUM 列在 chunk encode 时可能会导致 TiFlash crash 的问题 #8674 @yibin87
- 修复日志中 local_region_num 数值错误的问题 #8895 @JaySon-Huang
- 修复存算分离架构下，TiFlash 关闭过程中可能 panic 的问题 #8837 @JaySon-Huang
- 修复 TiFlash 在高并发读的情况下，可能返回瞬时不正确结果的问题 #8845 @JinheLin
- 修复存算分离架构下，修改 TiFlash 计算节点 storage.remote.cache.capacity 配置项的值后，Grafana 中硬盘使用量监控指标 used_size 显示不正确的问题 #8920 @JinheLin
- 修复存算分离架构下，出现网络隔离后查询可能会被永久阻塞的问题 #8806 @JinheLin
- 修复在非严格 sql_mode 下插入数据到带有异常默认值的列可能导致 TiFlash panic 的问题 #8803 @Lloyd-Pottiger
Tools
- Backup & Restore (BR)
  - 修复在小概率情况下，由于特殊的事件时序导致日志备份数据丢失的问题 #16739 @YuJuncen
  - 修复全量备份失败时打印过多日志的问题 #51572 @Leavrth
  - 修复 PD 连接失败导致日志备份 advancer owner 所在的 TiDB 可能崩溃的问题 #52597 @YuJuncen
  - 修复因 TiKV 重启，日志备份的 global checkpoint 推进提前于实际备份文件写入点，可能导致少量备份数据丢失的问题 #16809 @YuJuncen
  - 修复恢复暂停的日志备份任务时，如果与 PD 的网络连接不稳定可能导致 TiKV panic 的问题 #17020 @YuJuncen
  - 修复一个不稳定的测试用例 #52547 @Leavrth
  - 修复在 BR 恢复数据或 TiDB Lightning 物理导入模式下导入数据时，从 PD 获取到的 Region 没有 Leader 的问题 #51124 #50501 @Leavrth
  - 修复在某些极端情况下，全量备份因找不到 peer 导致 TiKV panic 的问题 #16394 @Leavrth
  - 修复在日志备份任务被暂停后，移除任务无法立即恢复 GC safepoint 的问题 #52082 @3pointer
  - 修复不稳定测试用例 TestClearCache #50743 @3pointer
  - 修复由于 EndKey 为空导致恢复事务 KV 集群失败的问题 #52574 @3pointer
  - 修复 PD leader 发生迁移可能导致恢复数据时 panic 的问题 #53724 @Leavrth
  - 修复在包含 AUTO_RANDOM 列的联合聚簇索引中，BR 无法备份 AUTO_RANDOM ID 分配进度的问题 #52255 @Leavrth
- TiCDC
  - 修复 PD 磁盘 IO 延迟较大导致 TiCDC 同步大幅延迟的问题 #9054 @asddongmen
  - 修复调用驱逐 TiCDC owner 节点的 API (/api/v2/owner/resign) 导致 TiCDC 任务意外重启的问题 #10781 @sdojjy
  - 修复在频繁执行 DDL 的场景中，由于错误的 BarrierTS 导致数据被写入到错误的 CSV 文件的问题 #10668 @lidezhu
  - 修复 TiCDC 在开启单行数据正确性校验后由于时区不匹配导致 TIMESTAMP 类型 checksum 验证失败的问题 #10573 @3AceShowHand
  - 修复当对象存储遇到暂时故障时，启用了最终一致性功能的 changefeed 可能直接失败的问题 #10710 @CharlesCheung96
  - 修复没有正确同步 DROP PRIMARY KEY 和 DROP UNIQUE KEY 的问题 #10890 @asddongmen
  - 修复在调度表的同步任务时 TiCDC panic 的问题 #10613 @CharlesCheung96
  - 修复当下游 Pulsar 下线后，移除 changefeed 会导致 TiCDC 正常流程卡住，从而引起其他 changefeed 进度卡住的问题 #10629 @asddongmen
  - 修复重启 PD 可能导致 TiCDC 节点报错重启的问题 #10799 @3AceShowHand
  - 修复 open-protocol 的 old value 部分错误地按照 STRING 类型而非真正类型输出默认值的问题 #10803 @3AceShowHand
  - 修复 TIMEZONE 类型的值没有按照正确的时区设置默认值的问题 #10931 @3AceShowHand
  - 修复上游写入 Exchange Partition ... With Validation DDL 后，TiCDC 向下游执行该 DDL 时失败，导致 changefeed 卡住的问题 #10859 @hongyunyan
  - 修复 KV Client 数据争用导致 TiCDC panic 的问题 #10718 @asddongmen
  - 修复上游更新主键或唯一键可能导致上下游数据不一致的问题 #10918 @lidezhu
- TiDB Data Migration (DM)
  - 升级 go-mysql 以修复连接阻塞的问题 #11041 @D3Hunter
  - 修复上游为 binary 类型主键时丢失数据的问题 #10672 @GMHDBJD
- TiDB Lightning
  - 修复 EBS BR 运行时 TiDB Lightning 可能导入失败的问题 #49517 @mittalrishabh
  - 修复 TiDB Lightning 导入数据时，因源文件存在不兼容的 SQL 语句而报 no database selected 的问题 #51800 @lance6716
  - 修复 TiDB Lightning 导入数据时，kill PD Leader 会导致 invalid store ID 0 报错的问题 #50501 @Leavrth
  - 修复导入 Parquet 格式的空表时，TiDB Lightning panic 的问题 #52518 @kennytm