· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 330 8 8.8 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 降级至 v5.3.0 以前版本后，这些临时表会被当作普通表处理，导致数据错误。 – TiCDC 和 BR 从 v5.3.0 开始支持全局临时表。如果使用 v5.3.0 以下版本同步全局临时表到下游，会导 致表定义错误。 – 通过 TiDB 生态工具导入的集群、恢复后的集群、同步的下游集群必须是 TiDB v5.3.0 及以上版本，否 则创建全局临时表时报错。 – 关于临时表的更多兼容性信息，请参考与 运维操作。 用户文档 2.2.2.8 部署及运维 • 持续性能分析（实验特性） TiDB Dashboard 引入持续性能分析功能，提供在集群运行状态时自动保存实例性能分析结果的能力，通 过火焰图的形式提高了 TiDB 集群性能的可观测性，有助于缩短故障诊断时间。 该功能默认关闭，需进入 TiDB Dashboard 持续性能分析页面开启。 持续性能分析功能必须使用 TiUP 1.7.0 及以上版本升级或安装的集群才可使用。

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 899 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 查所需导 入的数据 是否存在 冲突。该 参数默认 值为 false，表 示仅开启 后置冲突 检测。仅 当导入模 式为物理 导入模式 (tikv- �→ importer �→ . �→ backend �→ = " �→ local") 时可以使 用该参数。 TiDB Lightning logical- �→ import �→ -batch �→ -rows 新增 在逻辑导 入模式下， 数，默认 值为 65536。 52 配置文件 配置项 修改类型 描述 TiDB Lightning logical- �→ import �→ -batch �→ -size 新增 在逻辑导 入模式下， 用于设置 下游 TiDB 服务器上 执行的每 条 SQL 语 句的最大 值。默认 值为 "96KiB"， 单位可以 为 KB、KiB、 MB、MiB 等 存储单位。 Data Migration

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 883 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · INTO 任务的 性能。如 果要从 低版本 的集群 升级到 v8.1.0 或 更高版 本，且 该集群 已开启 分布式 执行框 架，为 了避免 升级期 间 ADD �→ INDEX �→ 操作 可能导 致数据 索引不 一致的 问题， 请在升 级前关 闭分布 式执行 框架 （即将 tidb_ �→ enable �→ _ �→ dist �→ _ �→ task 设置为 OFF）， 升级后 再手动 如果你之前已经生成过密码，可以直接使用原密码，或点击 Reset Password 重新生成密码。 5. 启动 MySQL Workbench，并点击 MySQL Connections 标题旁边的 +。 198 图 1: MySQL Workbench: add new connection 6. 在 Setup New Connection 对话框中，配置以下连接参数： • Connection Name：为该连接指定一个有意义的名称。

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 889 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 支持配置多个 PD 地址以增强稳定性 #49515 @mittalrishabh * 支持通过配置参数 block-size 来控制 TiDB Lightning 本地文件排序的 I/O 区块大小，提升数据导 入性能 #45037 @mittalrishabh 51 2.2.6 错误修复 • TiDB – 修 复 TiDB panic 并 报 错 invalid memory address or @AilinKid – 修复当分区列类型为 DATETIME 时，执行 ALTER TABLE ... LAST PARTITION 失败的问题 #48814 @crazycs520 – 修复数据中包含后导空格时，在 LIKE 中使用 _ 通配符可能会导致查询结果出错的问题 #48983 @time-and-fate – 修复 tidb_server_memory_limit 导致内存长期压力较高时，TiDB

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1238 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · Protocol 协 议。 60 配置文件 或组件 配置项 修改类型 描述 TiDB Lightning logical- �→ import �→ -prep- �→ stmt 新增 在逻辑导 入模式下， 该参数控 制是否使 用预处理 语句和语 句缓存来 提高性能。 默认值为 false。 BR --log. �→ crypter �→ .key 新增 设置日志 备份数据 的加密密 钥，十六 如果你之前已经生成过密码，可以直接使用原密码，或点击 Reset Password 重新生成密码。 5. 启动 MySQL Workbench，并点击 MySQL Connections 标题旁边的 +。 222 图 1: MySQL Workbench: add new connection 6. 在 Setup New Connection 对话框中，配置以下连接参数： • Connection Name：为该连接指定一个有意义的名称。

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 877 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 生成 Heap Profile。从 v7.5.0 开始，TiKV 支持远程处理 Heap Profile，你可以通过 TiDB �→ Dashboard 直接获取 Heap Profile 的火焰图和调用图。该功能提供了与 Go �→ 堆内存分析同等的简单易用体验。 2.2.1 功能详情 2.2.1.1 可扩展性 • 支持设置 TiDB 节点的服务范围，用于选择适用的 TiDB 节点分布式执行 或 IMPORT INTO 任务 (GA) #46258 @ywqzzy 在资源密集型集群中，并行执行 ADD INDEX 或 IMPORT INTO 任务可能占用大量 TiDB 节点的资源，从而导 致集群性能下降。为了避免对已有业务造成性能影响，v7.4.0 以实验特性引入了变量tidb_service_scope， 用于控制TiDB 分布式执行框架下各 TiDB 节点的服务范围。你可以从现有

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 984 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · Protocol 协 议。 55 配置文件 或组件 配置项 修改类型 描述 TiDB Lightning logical- �→ import �→ -prep- �→ stmt 新增 在逻辑导 入模式下， 该参数控 制是否使 用预处理 语句和语 句缓存来 提高性能。 默认值为 false。 BR --log. �→ crypter �→ .key 新增 设置日志 备份数据 的加密密 钥，十六 如果你之前已经生成过密码，可以直接使用原密码，或点击 Reset Password 重新生成密码。 5. 启动 MySQL Workbench，并点击 MySQL Connections 标题旁边的 +。 图 1: MySQL Workbench: add new connection 6. 在 Setup New Connection 对话框中，配置以下连接参数： • Connection Name：为该连接指定一个有意义的名称。

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 919 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 18446744073709551615（64 位平 台）和 4294967295（32 位平台）修改为 1048576，代表同时执行请求的 session 个数 最多可以设置为 1048576，避免设置过大导 致 TiDB Server OOM。 TiKV max-apply-unpersisted- �→ log-limit 修改 默认值从 0 修改为 1024，代表允许 apply 已 经 commit 如果你之前已经生成过密码，可以直接使用原密码，或点击 Reset Password 重新生成密码。 5. 启动 MySQL Workbench，并点击 MySQL Connections 标题旁边的 +。 图 1: MySQL Workbench: add new connection 6. 在 Setup New Connection 对话框中，配置以下连接参数： • Connection Name：为该连接指定一个有意义的名称。

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 873 10.1.1 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · Lightning 暂停 PD 调度的范围。默认值为 "table �→ "，可选值为 "table" 和 "global"。对于 TiDB v6.1.0 之前的版本，只能配置 "global" 选项，即导 入数据过程中暂停全局调度。从 v6.1.0 开始，支持 "table" 选项，表示仅暂停目标表数据范围所在 Region 的调度。建议在数据量较大的场景将该配置项设置为 "global"，以提升稳定性。 置认证算法 #8867 @hi-rustin – TiDB Lightning * 将关于 Region 分布不均的 Precheck 项的严重级别从 Critical 调整为 Warn，以避免阻塞用户导 入数据 #42836 @okJiang * 在导入数据期间遇到 unknown RPC 错误时，增加了重试机制 #43291 @D3Hunter * 增强 Region Job 的重试机制 #43682

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 399 8 8.9 TiDB 集群问题导图· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 49 -0.87 900 386553.31 399777.11 5.09 4.74 3.42 v5.4.0 对比 v5.3.0，Point Select 性能基本持平，略提升了 0.64%。 图 1: Point Select 2.5.1.4.2 Update Non-index 性能 Threads v5.3.0 TPS v5.4.0 TPS v5.3.0 95% latency (ms) 65 3.77 900 57897.56 59666.8 27.66 27.66 3.06 v5.4.0 对比 v5.3.0，Update Non-index 性能提升了 2.59%。 55 图 2: Update Non-index 2.5.1.4.3 Update Index 性能 Threads v5.3.0 TPS v5.4.0 TPS v5.3.0 95% latency (ms)