AUTO_RANDOM 从 v3.1.0 版本开始引入

警告：
当前 AUTO_RANDOM 属性为实验功能，不建议在生产环境中使用。在后续版本中，AUTO_RANDOM 的语法或语义可能会变化。

使用 AUTO_RANDOM 功能前，须在 TiDB 配置文件 experimental 部分设置 allow-auto-random = true。该参数详情可参见 allow-auto-random。

使用场景

AUTO_RANDOM 用于解决大批量写数据入 TiDB 时因含有整型自增主键列的表而产生的热点问题。详情参阅 TiDB 高并发写入场景最佳实践。

以下面语句建立的表为例：

create table t (a int primary key auto_increment, b varchar(255))

在以上语句所建的表上执行大量未指定主键值的 INSERT 语句，示例如下：

insert into t(b) values ('a'), ('b'), ('c')

如以上语句，由于未指定主键列的值（a 列），TiDB 会使用连续自增的行值作为行 ID，可能导致单个 TiKV 节点上产生写入热点，进而影响对外提供服务的性能。要避免这种性能下降，可以在执行建表语句时为 a 列指定 AUTO_RANDOM 属性而不是 AUTO_INCREMENT 属性。示例如下：

create table t (a int primary key auto_random, b varchar(255))

或者

create table t (a int auto_random, b varchar(255), primary key (a))

此时再执行形如 INSERT INTO t(b) values... 的 INSERT 语句。

如果该 INSERT 语句没有指定整型主键列（a 列）的值，或者指定为 NULL，TiDB 会为该列自动分配值。该值不保证自增，不保证连续，只保证唯一，避免了连续的行 ID 带来的热点问题。
如果该 INSERT 语句显式指定了整型主键列的值，和 AUTO_INCREMENT 属性类似，TiDB 会保存该值。注意，如果未在系统变量 @@sql_mode 中设置 NO_AUTO_VALUE_ON_ZERO，即使显式指定整型主键列的值为 0，TiDB 也会为该列自动分配值。

自动分配值的计算方式如下：

该行值在二进制形式下，除去最高位（无论是 unsigned 还是 signed）的次高五位（称为 shard bits）由当前事务的开始时间决定，剩下的位数按照自增的顺序分配。

若要使用一个不同的 shard bits 的数量，可以在 AUTO_RANDOM 后面加一对括号，并在括号中指定想要的 shard bits 数量。示例如下：

create table t (a int primary key auto_random(3), b varchar(255))

以上建表语句中，shard bits 的数量为 3。shard bits 的数量的取值范围是 [1, field_max_bits)，其中 field_max_bits 为整型主键列类型占用的位长度。

创建完表后，使用 SHOW WARNINGS 可以查看当前表可支持的最大隐式分配的次数：

show warnings

+-------+------+------------------------------------------------+
| Level | Code | Message                                        |
+-------+------+------------------------------------------------+
| Note  | 1105 | Available implicit allocation times: 268435455 |
+-------+------+------------------------------------------------+

另外，含有 AUTO_RANDOM 属性的表在系统表 information_schema.tables 中 TIDB_ROW_ID_SHARDING_INFO 一列的值为 PK_AUTO_RANDOM_BITS=x，其中 x 为 shard bits 的数量。

要获取上一次 TiDB 隐式分配的 ID，可以使用 select last_insert_id() 查看，例如：

insert into t (b) values ("b")
select * from t;
select last_insert_id()

可能得到的结果如下：

+------------+---+
| a          | b |
+------------+---+
| 1073741825 | b |
+------------+---+

+------------------+
| last_insert_id() |
+------------------+
| 1073741825       |
+------------------+

兼容性

TiDB 支持解析版本注释语法。示例如下：

create table t (a bigint primary key /*T![auto_rand] auto_random */)

create table t (a int primary key auto_random)

以上两个语句含义相同。

在 show create table 的结果中，AUTO_RANDOM 属性会被注释掉。注释会附带一个特性标识符，例如 /*T![auto_rand] auto_random */。其中 auto_rand 表示 AUTO_RANDOM 的特性标识符，只有实现了该标识符对应特性的 TiDB 版本才能够正常解析 SQL 语句片段。

该功能支持向前兼容，即降级兼容。没有实现对应特性的 TiDB 版本则会忽略表（带有上述注释）的 AUTO_RANDOM 属性，因此能够使用含有该属性的表。