大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:SHARD_ROW_ID_BITS

· 52CE 我爱测

对于非聚簇索引主键或没有主键的表,TiDB 会使用内部自动生成的 作为隐式自增 rowid。大量执行 插入语句时会把数据集中写入单个 Region,造成写入热点。

SHARD_ROW_ID_BITS

本文介绍表属性 SHARD_ROW_ID_BITS,它用来设置隐式 _tidb_rowid 分片数量的 bit 位数。

基本概念

对于非聚簇索引主键或没有主键的表,TiDB 会使用内部自动生成的 _tidb_rowid 作为隐式自增 rowid。大量执行 INSERT 插入语句时会把数据集中写入单个 Region,造成写入热点。

通过设置 SHARD_ROW_ID_BITS,可以把 rowid 打散写入多个不同的 Region,缓解写入热点问题。

  • SHARD_ROW_ID_BITS = 4 表示 16 个分片
  • SHARD_ROW_ID_BITS = 6 表示 64 个分片
  • SHARD_ROW_ID_BITS = 0 表示默认值 1 个分片

设置 SHARD_ROW_ID_BITS = S 时,_tidb_rowid 的具体结构如下:

符号位 分片位 自增位
1 bit S bits 63-S bits
  • 自增位的值保存在 TiKV 中,由 TiDB 按顺序分配,每次分配后值会自增 1。当自增位的值耗尽后(即达到最大值时),再次自动分配时会报 Failed to read auto-increment value from storage engine 错误。
  • 关于 _tidb_rowid 取值范围:最终生成值包含的最大位数 = 分片位 + 自增位,最大值为 (2^63)-1。

警告:

_tidb_rowid 是 TiDB 内部隐式分配的行 ID。不要假定它在所有情况下都是全局唯一的。对于未使用聚簇索引的分区表,ALTER TABLE ... EXCHANGE PARTITION 操作可能会导致不同分区具有相同的 _tidb_rowid 值。详情请参阅 _tidb_rowid。

注意:

分片位长度 (S) 的选取:

  • 由于 _tidb_rowid 总位数为 64 位,分片位的数量会影响自增位的数量:当分片位数增加时,自增位数会减少,反之亦然。因此,你需要权衡“自动分配值的随机性”以及“可用自增空间”。
  • 最佳实践是将分片位设置为 log(2, x),其中 x 为当前集群中 TiKV 节点的数量。例如,如果一个 TiDB 集群中存在 16 个 TiKV 节点,分片位推荐设置为 log(2, 16),即 4。在所有 Region 被均匀调度到各个 TiKV 节点后,此时大批量写入操作的负载可被均匀分布到不同 TiKV 节点,以实现资源最大化利用。

关于 SHARD_ROW_ID_BITS 的更多使用信息,可参考使用 SHARD_ROW_ID_BITS 处理热点表。

语句示例

CREATE TABLE t (
    id INT PRIMARY KEY NONCLUSTERED
) SHARD_ROW_ID_BITS = 4;
ALTER TABLE t SHARD_ROW_ID_BITS = 4;

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。