TiDB v8.4 中文手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: download.pingcap.org

摘要

《TiDB v8.4 中文手册》详细介绍了 TiDB v8.4 版本的配置参数、功能改进和 Bug 修复。主要内容包括：1) 配置参数的调整，如 grpc-keepalive-timeout 的数据类型和最小值的修改，以及 region-split-keys 和 region-split-size 默认值的调整；2) 新增功能，如 tidb_enable_stats_owner 配置项，用于控制统计信息自动更新任务的运行；3) Bug 修复，涉及 GRANT/REVOKE 原子性、分区表加锁、索引长度限制、FROM_UNIXTIME 函数等问题；4) 工具改进，如 TiDB Binlog 新增 kafka-client-id 配置项，TiDB Lightning 优化配置项和修复非 server mode 模式下 web 界面无法打开的问题。

AI总结

《TiDB v8.4 中文手册》主要介绍了 TiDB 在 v8.4 版本中的配置参数优化、功能改进和 Bug 修复。以下是核心内容总结：

### 1. **配置参数优化**
- **TiDB**：
- `grpc-keepalive-timeout` 参数从 INT 类型改为 FLOAT64，最小值支持设置为 0.05，适用于网络抖动频繁的场景，减少重试间隔以提升性能。
- 新增 `tidb_enable_stats_owner` 参数，控制是否允许 TiDB Server 运行统计信息自动更新任务。
- **TiKV**：
- `region-split-keys` 和 `region-split-size` 的默认值分别从 "960000" 和 "96MiB" 修改为 "2560000" 和 "256MiB"，优化 Region 分裂行为。

### 2. **功能改进**
- **TiDB**：
- 支持在 binlog 写入失败时，TiDB 退出，避免数据不一致。
- 新增 `max-index-length` 配置项，用户可自定义索引支持的最大长度。
- **TiKV**：
- 引入流控机制，解决日志追不及时和事务大小过大导致的连接重连问题。
- **PD**：
- 修复因处理 Region heartbeat 时的数据竞争导致 Region 信息不正确的问题。

### 3. **Bug 修复**
- **TiDB**：
- 修复 GRANT/REVOKE 多用户操作时的原子性问题、分区表加锁问题、索引长度超限报错信息不准确等问题。
- 修复 `FROM_UNIXTIME` 函数小数点位数不准确、事务中删除自己写的记录导致冲突检测失效等问题。
- **TiKV**：
- 修复关闭一致性检查参数时，插入并删除已存在 Key 导致的冲突检测失效问题。
- **PD**：
- 修复 Region 信息缓存失效问题，优化 TSO 的有效时间。

### 4. **工具改进**
- **TiDB Binlog**：
- 新增 `kafka-client-id` 配置项，支持 Kafka 客户端 ID 配置。
- **TiDB Lightning**：
- 修复 CSV 文件解析、Region key 编码错误等问题，优化配置项默认值。

### 5. **版本兼容性**
- **TiDB 3.0.11** 和 **TiDB 4.0 RC** 版本存在已知问题，建议使用最新版本。
- **TiDB 4.0.11** 新增支持 `utf8_unicode_ci` 和 `utf8mb4_unicode_ci` 排序规则。

### 6. **性能优化**
- **TiKV**：
- 默认开启 Hibernate Region 特性，降低 Region 活跃度以节省资源。
- **TiFlash**：
- 优化锁操作，避免 DDL 和读操作相互阻塞。

### 7. **监控与告警**
- **TiDB Dashboard** 新增多项监控项，如 Deadlock Detect Duration、Statement Lock Keys Count 等，提升集群监控能力。

总结：TiDB v8.4 在配置参数、性能优化、Bug 修复和工具改进方面进行了多项更新，重点提升了网络抖动场景下的性能、事务处理的原子性和监控能力，同时修复了多个影响稳定性和数据一致性的问题。