描述

如果创建表时需要某个数值列的值不重复并且保持递增，这就是自增列。在 MySQL 租户里，列的类型可以定义为 AUTO_INCREMENT，即 MySQL 租户的自增列。

自增列有三个重要属性，包括自增起始值、自增步长和自增列缓存大小，通过以下三个租户变量参数来控制。

系统变量

说明

auto_increment_cache_size

用于设置自增的缓存个数，取值范围为 [1, 100000000]，默认值为 1000000。

auto_increment_increment

用于设置自增步长，取值范围为 [1, 65535]，默认值为 1。

auto_increment_offset

用于确定 AUTO_INCREMENT 列值的起点，取值范围为 [1, 65535]，默认值为 1。

示例

下面创建了一个自增列，在使用 INSERT 语句插入记录时不需要指定自增列，OceanBase 数据库会自动为该列填充值。

如果在 INSERT 时指定了自增列的值，且这个值为 0，则 OceanBase 数据库会用自增列的下一个值填充列的值；如果这个值比当前最大值小，则不影响自增列的下一个值的计算；如果这个值比当前值最大值大，则自增列会把插入值和自增列缓存值的和作为下次自增的起始值。

  1. obclient> CREATE TABLE t1(id bigint not null auto_increment primary key, name varchar(50), gmt_create timestamp not null default current_timestamp);
  2. Query OK, 0 rows affected (0.08 sec)
  4. obclient> INSERT INTO t1(name) VALUES('A'),('B'),('C');
  5. Query OK, 3 rows affected (0.01 sec)
  6. Records: 3  Duplicates: 0  Warnings: 0
  8. obclient> SELECT * FROM t1;
  9. +----+------+---------------------+
  10. | id | name | gmt_create          |
  11. +----+------+---------------------+
  12. |  1 | A    | 2020-04-03 17:09:55 |
  13. |  2 | B    | 2020-04-03 17:09:55 |
  14. |  3 | C    | 2020-04-03 17:09:55 |
  15. +----+------+---------------------+
  16. 3 rows in set (0.01 sec)
  18. obclient> INSERT INTO t1(id, name) VALUES(0, 'D');
  19. Query OK, 1 row affected (0.00 sec)
  21. obclient> INSERT INTO t1(id, name) VALUES(-1,'E');
  22. Query OK, 1 row affected (0.00 sec)
  24. obclient> INSERT INTO t1(id, name) VALUES(10,'F');
  25. Query OK, 1 row affected (0.01 sec)
  27. obclient> INSERT INTO t1(name) VALUES('G');
  28. Query OK, 1 row affected (0.00 sec)
  30. obclient> SELECT * FROM t1;
  31. +---------+------+---------------------+
  32. | id      | name | gmt_create          |
  33. +---------+------+---------------------+
  34. |      -1 | E    | 2020-04-03 17:10:24 |
  35. |       1 | A    | 2020-04-03 17:09:55 |
  36. |       2 | B    | 2020-04-03 17:09:55 |
  37. |       3 | C    | 2020-04-03 17:09:55 |
  38. |       4 | D    | 2020-04-03 17:10:19 |
  39. |      10 | F    | 2020-04-03 17:10:29 |
  40. | 1000011 | G    | 2020-04-03 17:10:34 |
  41. +---------+------+---------------------+
  42. 7 rows in set (0.00 sec)