TiDB 7.5.0 Release Notes

发版日期:2023 年 12 月 1 日

TiDB 版本:7.5.0

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

TiDB 7.5.0 为长期支持版本 (Long-Term Support Release, LTS)。

相比于前一个 LTS(即 7.1.0 版本),7.5.0 版本包含 7.2.0-DMR7.3.0-DMR7.4.0-DMR 中已发布的新功能、提升改进和错误修复。当你从 7.1.x 升级到 7.5.0 时,可以下载 TiDB Release Notes PDF 查看两个 LTS 版本之间的所有 release notes。下表列出了从 7.2.0 到 7.5.0 的一些关键特性:

分类功能描述
可扩展性与性能支持并行运行多个 ADD INDEX 语句通过该功能,为同一个表添加多个索引的任务可以变为并发运行。以前同时运行 2 个添加索引语句 X 和 Y 需要花费 X 的时间 + Y 的时间,现在在一个 SQL 语句中同时添加索引 X 和 Y,并发运行后,添加索引总耗时显著减少了。尤其是在宽表的场景,内部测试数据显示同时添加多个索引的性能最高可提升 94%。
稳定性与高可用优化全局排序(实验特性,从 v7.4.0 开始引入)TiDB v7.1.0 中引入了分布式执行框架。在 v7.4.0 中,TiDB 以该框架为基础,引入全局排序,消除了数据 reorg 任务期间临时无序数据导致的不必要的 I/O、CPU 和内存峰值。全局排序利用外部对象存储(目前为 Amazon S3)来存储系统作业期间的中间文件,提高灵活性并降低成本。ADD INDEXIMPORT INTO 等操作将更快速灵活、稳定可靠,且运行成本较低。
资源管控支持自动管理后台任务(实验特性,从 v7.4.0 开始引入)从 v7.1.0 开始,资源管控成为正式功能,该特性有助于缓解不同工作负载间的资源与存储访问干扰。TiDB v7.4.0 将此资源控制应用于后台任务的优先级。资源管控可以识别和管理后台任务执行的优先级,例如自动收集统计信息、备份和恢复、TiDB Lightning 批量数据导入以及在线 DDL。未来,所有后台任务都将纳入资源管控。
资源管控支持管理资源消耗超出预期的查询(实验特性,从 v7.2.0 开始引入)资源管控是一个通过资源组 (Resource Group) 对工作负载进行资源隔离的框架,但它并不对每个资源组内的查询产生影响。TiDB v7.2.0 引入了运行超出预期的查询 (Runaway Queries) 时的资源控制功能,你可以控制 TiDB 如何识别和处理每个资源组的查询。根据需要,长时间运行的查询可能会被终止或节流,你可以通过准确的 SQL 文本、SQL Digest 或 Plan Digest 来识别查询。在 TiDB v7.3.0,你可以主动监视已知的不良查询,类似于数据库级别的 SQL Blocklist。
SQLMySQL 8.0 兼容性(从 v7.4.0 开始引入)MySQL 8.0 的默认字符集为 utf8mb4,其默认排序规则是 utf8mb4_0900_ai_ci。TiDB v7.4.0 增强了与 MySQL 8.0 的兼容性。现在你可以更轻松地将在 MySQL 8.0 中使用默认排序规则创建的数据库迁移或复制到 TiDB。
数据库管理与可观测性IMPORT INTO 语句集成 TiDB Lightning 物理导入模式的能力 (GA)在 v7.2.0 之前,如需基于文件系统进行数据导入,你需要安装 TiDB Lightning 并使用其物理导入模式。目前,该功能已集成到 IMPORT INTO 语句中,你可以使用此语句快速导入数据,而无需安装任何额外的工具。该语句还支持分布式执行框架,可分布式执行导入任务,提升了大规模数据导入时的效率。
选择适用的 TiDB 节点分布式执行 ADD INDEXIMPORT INTO SQL 语句 (GA)你可以灵活选择在现有 TiDB 节点或新增 TiDB 节点执行 ADD INDEXIMPORT INTO SQL 语句。该方法可以实现与其他 TiDB 节点的资源隔离,确保在执行上述语句时的最佳性能,并避免对已有业务造成性能影响。在 v7.5.0 中,该功能正式 GA。
DDL 任务支持暂停和恢复操作 (GA)添加索引可能会消耗大量资源并影响在线流量。即使在资源组中进行了限制,或对标记的节点进行了隔离,你仍然可能需要在紧急情况下暂停这些任务。从 v7.2.0 开始,TiDB 原生支持同时暂停任意数量的后台任务,释放所需的资源,无需取消或重启任务。
TiDB Dashboard 性能分析支持 TiKV 堆内存分析在之前版本中调查 TiKV OOM 或内存使用高的问题时,往往需要在实例环境下手动运行 jeprof 生成 Heap Profile。从 v7.5.0 开始,TiKV 支持远程处理 Heap Profile,你可以通过 TiDB Dashboard 直接获取 Heap Profile 的火焰图和调用图。该功能提供了与 Go 堆内存分析同等的简单易用体验。

功能详情

可扩展性

  • 支持设置 TiDB 节点的服务范围,用于选择适用的 TiDB 节点分布式执行 ADD INDEXIMPORT INTO 任务 (GA) #46258 @ywqzzy

    在资源密集型集群中,并行执行 ADD INDEXIMPORT INTO 任务可能占用大量 TiDB 节点的资源,从而导致集群性能下降。为了避免对已有业务造成性能影响,v7.4.0 以实验特性引入了变量 tidb_service_scope,用于控制 TiDB 分布式执行框架下各 TiDB 节点的服务范围。你可以从现有 TiDB 节点中选择几个节点,或者对新增 TiDB 节点设置服务范围,所有分布式执行的 ADD INDEXIMPORT INTO 的任务只会运行在这些节点。在 v7.5.0 中,该功能正式 GA。

    更多信息,请参考用户文档

性能

  • TiDB 分布式执行框架成为正式功能 (GA),提升并行执行的 ADD INDEXIMPORT INTO 任务的性能和稳定性 #45719 @wjhuang2016

    在 v7.1.0 中引入的 TiDB 分布式执行框架成为正式功能 (GA)。TiDB v7.1.0 之前的版本中,在同一时间只有一个 TiDB 节点能够执行 DDL 任务。从 v7.1.0 开始,在分布式并行执行框架下,多个 TiDB 节点可以并行执行同一项 DDL 任务。从 v7.2.0 开始,分布式并行执行框架支持多个 TiDB 节点并行执行同一个 IMPORT INTO 任务,从而更好地利用 TiDB 集群的资源,大幅提升 DDL 和 IMPORT INTO 任务的性能。此外,你还可以通过增加 TiDB 节点来线性提升 DDL 和 IMPORT INTO 任务的性能。

    如果要使用分布式并行执行框架,只需将 tidb_enable_dist_task 的值设置为 ON

    SET GLOBAL tidb_enable_dist_task = ON;

    更多信息,请参考用户文档

  • 提升了在一个 SQL 语句中同时添加多个索引的性能 #41602 @tangenta

    在 v7.5.0 之前,用户在一个 SQL 语句里添加多个索引 (ADD INDEX) 时,其性能与使用多个独立的 SQL 语句添加多个索引的性能接近。从 v7.5.0 起,在一个 SQL 语句中添加多个索引的性能有了显著的变化,尤其是在宽表的场景,内部测试数据显示最高性能可提升 94%。

数据库管理

  • DDL 任务支持暂停和恢复操作成为正式功能 (GA) #18015 @godouxm

    在 v7.2.0 中引入的 DDL 任务的暂停和恢复功能成为正式功能 (GA)。该功能允许临时暂停资源密集型的 DDL 操作(如创建索引),以节省资源并最小化对在线流量的影响。当资源允许时,你可以无缝恢复 DDL 任务,而无需取消和重新开始。DDL 任务的暂停和恢复功能提高了资源利用率,改善了用户体验,并简化了 schema 变更过程。

    你可以通过如下 ADMIN PAUSE DDL JOBSADMIN RESUME DDL JOBS 语句暂停或者恢复多个 DDL 任务:

    ADMIN PAUSE DDL JOBS 1,2; ADMIN RESUME DDL JOBS 1,2;

    更多信息,请参考用户文档

  • BR 支持备份和恢复统计信息 #48008 @Leavrth

    从 TiDB v7.5.0 开始,BR 备份工具支持备份和恢复数据库统计信息,在备份命令中引入了参数 --ignore-stats。当指定该参数值为 false 时,BR 备份工具支持备份和恢复数据库的列、索引、和表级别的统计信息。因此,从备份中恢复的 TiDB 数据库不再需要手动运行统计信息收集任务,也无需等待自动收集任务的完成,从而简化了数据库维护工作,并提升了查询性能。

    更多信息,请参考用户文档

可观测性

  • TiDB Dashboard 性能分析支持 TiKV 堆内存分析 #15927 @Connor1996

    在之前版本中调查 TiKV OOM 或内存使用高的问题时,往往需要在实例环境下手动运行 jeprof 生成 Heap Profile。从 v7.5.0 开始,TiKV 支持远程处理 Heap Profile,你可以通过 TiDB Dashboard 直接获取 Heap Profile 的火焰图和调用图。该功能提供了与 Go 堆内存分析同等的简单易用体验。

    更多信息,请参考用户文档

数据迁移

  • IMPORT INTO SQL 语句成为正式功能 (GA) #46704 @D3Hunter

    在 v7.5.0 中,IMPORT INTO SQL 语句正式 GA。该语句集成了 TiDB Lightning 物理导入模式的能力,可以将 CSV、SQL 和 PARQUET 等格式的数据快速导入到 TiDB 的一张空表中。这种导入方式无需单独部署和管理 TiDB Lightning,在降低了数据导入难度的同时,大幅提升了数据导入效率。

    更多信息,请参考用户文档

  • Data Migration (DM) 支持拦截不兼容(破坏数据一致性)的 DDL 变更 #9692 @GMHDBJD

    在 v7.5.0 之前,使用 DM 的 Binlog Filter 功能只能迁移或过滤指定的 Event,且颗粒度比较粗,例如只能过滤 ALTER 这种大颗粒度的 DDL Event。这种方式在某些业务场景会受限,如业务允许 ADD COLUMN,但是不允许 DROP COLUMN,但之前的 DM 版本都会被 ALTER Event 过滤。

    因此,v7.5.0 细化了 DDL Event 的处理粒度,如支持过滤 MODIFY COLUMN(修改列数据类型)、DROP COLUMN 等会导致数据丢失、数据被截断、精度损失等问题的细粒度 DDL Event。你可以按需配置。同时还支持拦截不兼容的 DDL 变更,并报错提示,你可以及时介入手工处理,避免对下游的业务数据产生影响。

    更多信息,请参考用户文档

  • 支持实时更新增量数据校验的 checkpoint #8463 @lichunzhu

    在 v7.5.0 之前,你可以使用增量数据校验功能来判断 DM 同步到下游的数据是否与上游一致,并以此作为业务流量从上游数据库割接到 TiDB 的依据。然而,由于增量校验 checkpoint 受到较多限制,如同步延迟、不一致的数据等待重新校验等因素,需要每隔几分钟刷新一次校验后的 checkpoint。对于某些只有几十秒割接时间的业务场景来说,这是无法接受的。

    v7.5.0 引入实时更新增量数据校验的 checkpoint 后,你可以传入上游数据库指定的 binlog 位置。一旦增量校验程序在内存里校验到该 binlog 位置,会立即刷新 checkpoint,而不是每隔几分钟刷新 checkpoint。因此,你可以根据该立即返回的 checkpoint 快速进行割接操作。

    更多信息,请参考用户文档

兼容性变更

系统变量

变量名修改类型描述
tidb_enable_fast_analyze废弃用于控制是否启用统计信息快速分析功能。自 v7.5.0 起,统计信息快速分析功能被废弃。
tidb_analyze_partition_concurrency修改经进一步的测试后,默认值由 1 改为 2
tidb_build_stats_concurrency修改经进一步的测试后,默认值由 4 改为 2
tidb_merge_partition_stats_concurrency修改该变量从 v7.5.0 开始生效,用于设置 TiDB analyze 分区表时,对分区表统计信息进行合并时的并发度。
tidb_build_sampling_stats_concurrency新增设置 ANALYZE 过程中的采样并发度。
tidb_enable_async_merge_global_stats新增设置 TiDB 使用异步方式合并统计信息,以避免 OOM 问题。
tidb_gogc_tuner_max_value新增控制 GOGC Tuner 可调节 GOGC 的最大值。
tidb_gogc_tuner_min_value新增控制 GOGC Tuner 可调节 GOGC 的最小值。

配置文件参数

配置文件配置项修改类型描述
TiDBtikv-client.copr-req-timeout新增设置单个 Coprocessor request 的超时时间。
TiKVraftstore.inspect-interval修改经过算法调优后,默认值由 500ms 调整为 100ms,以提升慢节点检测的灵敏度。
TiKVraftstore.region-compact-min-redundant-rows修改触发 RocksDB compaction 需要的冗余的 MVCC 数据行数。从 v7.5.0 开始,该配置项对 "raft-kv" 存储引擎生效。
TiKVraftstore.region-compact-redundant-rows-percent修改触发 RocksDB compaction 需要的冗余的 MVCC 数据行所占比例。从 v7.5.0 开始,该配置项对 "raft-kv" 存储引擎生效。
TiKVraftstore.evict-cache-on-memory-ratio新增当 TiKV 的内存使用超过系统可用内存的 90%,并且 Raft 缓存条目占用的内存超过已使用内存的 evict-cache-on-memory-ratio 比例时,TiKV 会逐出 Raft 缓存条目。
TiKVmemory.enable-heap-profiling新增控制是否开启 TiKV 堆内存分析功能,以跟踪 TiKV 的内存使用情况。
TiKVmemory.profiling-sample-per-bytes新增设置 TiKV 堆内存分析每次采样的数据量,以 2 的指数次幂向上取整。
BR--ignore-stats新增用于备份和恢复数据库统计信息。当指定该参数值为 false 时,BR 备份工具支持备份和恢复数据库的列、索引、和表级别的统计信息。
TiCDCcase-sensitive修改经进一步的测试后,默认值由 true 改为 false,即默认情况下 TiCDC 配置文件中涉及的表名、库名大小写不敏感。
TiCDCsink.dispatchers.partition修改控制增量数据的 Kafka Partition 分发策略,可选值新增 columns 选项,即使用明确指定的列值计算 partition 编号。
TiCDCchangefeed-error-stuck-duration新增控制 changefeed 发生内部错误和异常时允许自动重试的时间。
TiCDCencoding-worker-num新增控制 redo 模块中编解码 worker 的数量。
TiCDCflush-worker-num新增控制 redo 模块中上传文件 worker 的数量。
TiCDCsink.column-selectors新增控制 TiCDC 将增量数据分发到 Kafka 时,只发送指定的列的数据变更事件。
TiCDCsql-mode新增设置 TiCDC 解析 DDL 时使用的 SQL 模式,默认值和 TiDB 的默认 SQL 模式一致。
TiDB Lightning--importer删除该配置项用于指定 TiKV-importer 的地址。从 v7.5.0 起,TiKV-importer 组件被废弃。

离线包变更

从 v7.5.0 开始,TiDB-community-toolkit 二进制软件包中移除了以下内容:

  • tikv-importer-{version}-linux-{arch}.tar.gz
  • mydumper
  • spark-{version}-any-any.tar.gz
  • tispark-{version}-any-any.tar.gz

废弃功能

  • Mydumper 在 v7.5.0 中废弃,其绝大部分功能已经被 Dumpling 取代,强烈建议切换到 Dumpling。

  • TiKV-importer 组件在 v7.5.0 中废弃,建议使用 TiDB Lightning 物理导入模式作为替代方案。

  • 从 v7.5.0 开始,不再提供 TiDB Binlog 数据同步功能的技术支持,强烈建议使用 TiCDC 实现高效稳定的数据同步。尽管 TiDB Binlog 在 v7.5.0 仍支持 Point-in-Time Recovery (PITR) 场景,但是该组件在未来 LTS 版本中将被完全废弃,推荐使用 PITR 替代。

  • 统计信息的快速分析(实验特性)在 v7.5.0 中废弃。

  • 统计信息的增量收集(实验特性)在 v7.5.0 中废弃。

改进提升

  • TiDB

    • 优化合并 GlobalStats 的并发模型:引入 tidb_enable_async_merge_global_stats 实现同时加载统计信息并进行合并,从而加速分区表场景下 GlobalStats 的生成。同时优化合并 GlobalStats 的内存使用,以避免 OOM 并减少内存分配 #47219 @hawkingrei
    • 优化 ANALYZE 流程:引入 tidb_build_sampling_stats_concurrency 精细化控制 ANALYZE 并发度,减少资源消耗。同时优化 ANALYZE 的内存使用,通过复用部分中间结果,减少内存分配,避免频繁 GC #47275 @hawkingrei
    • 改进 Placement Policy 的使用:增加对全局范围的策略配置,完善常用场景的语法支持 #45384 @nolouch
    • 提升启用索引加速功能 tidb_ddl_enable_fast_reorg 后添加索引的性能,在内部测试中 v7.5.0 相比 v6.5.0 性能最高提升 62.5% #47757 @tangenta
  • TiKV

    • 避免写 Titan manifest 文件时持有锁导致影响其他线程 #15351 @Connor1996
  • PD

  • Tools

    • Backup & Restore (BR)

      • 快照备份新增表间备份参数 table-concurrency,用于控制统计信息备份、数据校验等元信息的表间并发度 #48571 @3pointer
      • 快照备份恢复在遇到某些网络错误时会进行重试 #48528 @Leavrth

错误修复

  • TiDB

    • 禁止非整型聚簇索引进行 split table 操作 #47350 @tangenta
    • 修复使用错误的时区信息对时间字段进行编码的问题 #46033 @tangenta
    • 修复 Sort 算子在落盘过程中可能导致 TiDB 崩溃的问题 #47538 @windtalker
    • 修复查询使用 GROUP_CONCAT 时报错 Can't find column 的问题 #41957 @AilinKid
    • 修复 client-gobatch-client panic 的问题 #47691 @crazycs520
    • 修复 INDEX_LOOKUP_HASH_JOIN 内存使用量估算错误的问题 #47788 @SeaRise
    • 修复长时间下线的 TiFlash 节点重新加入集群后造成的负载不均衡的问题 #35418 @windtalker
    • 修复 HashJoin 算子 Probe 时无法复用 chunk 的问题 #48082 @wshwsh12
    • 修复 COALESCE() 函数对于 DATE 类型参数返回结果类型不正确的问题 #46475 @xzhangxian1008
    • 修复带子查询的 UPDATE 语句被错误地转成 PointGet 的问题 #48171 @hi-rustin
    • 修复当被缓存的执行计划包含日期类型和 unix_timestamp 的比较时,结果出现错误的问题 #48165 @qw4990
    • 修复默认内联且带聚合函数或窗口函数的公共表表达式 (CTE) 被递归的 CTE 引用时会报错的问题 #47881 @elsa0520
    • 修复优化器为减少窗口函数引入的 sort 而错误地选择了 IndexFullScan 的问题 #46177 @qw4990
    • 修复当 CTE 被多次引用时,条件下推 CTE 导致结果错误的问题 #47881 @winoros
    • 修复了 MySQL 压缩协议无法处理超大负载数据 (>= 16M) 的问题 #47152 #47157 #47161 @dveeden
    • 修复 TiDB 在通过 systemd 启动时无法读取 cgroup 资源限制的问题 #47442 @hawkingrei
  • TiKV

    • 修复悲观事务中 prewrite 请求重试在极少数情况下影响数据一致性的风险 #11187 @MyonKeminta
  • PD

    • 修复 evict-leader-scheduler 丢失配置的问题 #6897 @HuSharp
    • 修复 store 下线后对应的统计数据监控指标未删除的问题 #7180 @rleungx
    • 修复采用自适应同步部署模式 (DR Auto-Sync) 的集群在 Placement Rule 的配置较复杂时,canSynchasMajority 可能计算错误的问题 #7201 @disksing
    • 修复 rule checker 未按照设定的 Placement Rule 添加 Learner 的问题 #7185 @nolouch
    • 修复 TiDB Dashboard 不能正常读取 PD trace 数据的问题 #7253 @nolouch
    • 修复 PD 内部获取的 Region 可能为空导致 PD Panic 的问题 #7261 @lhy1024
    • 修复采用自适应同步部署模式 (DR Auto-Sync) 的集群 available_stores 计算错误的问题 #7221 @disksing
    • 修复当 TiKV 节点不可用时 PD 可能删除正常 Peers 的问题 #7249 @lhy1024
    • 修复在大集群中添加多个 TiKV 节点可能导致 TiKV 心跳上报变慢或卡住的问题 #7248 @rleungx
  • TiFlash

    • 修复 UPPER()LOWER() 函数在 TiDB 和 TiFlash 中计算结果不一致的问题 #7695 @windtalker
    • 修复在空分区上执行查询报错的问题 #8220 @JaySon-Huang
    • 修复同步 TiFlash 副本时可能创建表失败导致 panic 的问题 #8217 @hongyunyan
  • Tools

    • Backup & Restore (BR)

      • 修复 PITR 可能跳过恢复 CREATE INDEX DDL 的问题 #47482 @Leavrth
      • 修复大宽表场景下,日志备份在某些场景中可能卡住的问题 #15714 @YuJuncen
    • TiCDC

性能测试

如需了解 TiDB v7.5.0 的性能表现,你可以参考 TiDB Cloud Dedicated 集群的 TPC-C 性能测试报告Sysbench 性能测试报告(英文版)。

贡献者

感谢来自 TiDB 社区的贡献者们:

文档内容是否有帮助?