CREATE SEQUENCE

CreateSequenceStmt

IfNotExists

TableName

CreateSequenceOptionListOpt

SequenceOptionList

SequenceOption

语法说明

CREATE [TEMPORARY] SEQUENCE [IF NOT EXISTS] sequence_name
    [ INCREMENT [ BY | = ] increment ]
    [ MINVALUE [=] minvalue | NO MINVALUE | NOMINVALUE ]
    [ MAXVALUE [=] maxvalue | NO MAXVALUE | NOMAXVALUE ]
    [ START [ WITH | = ] start ]
    [ CACHE [=] cache | NOCACHE | NO CACHE]
    [ CYCLE | NOCYCLE | NO CYCLE]
    [table_options]

SEQUENCE 函数

• NEXTVAL 或 NEXT VALUE FOR

  本质上都是 nextval() 函数，获取序列对象的下一个有效值，其参数为序列的 identifier。

• LASTVAL

  lastval() 函数，用于获取本会话上一个使用过的值。如果没有值，则为 NULL，其参数为序列的 identifier。

• SETVAL

  setval() 函数，用于设置序列的增长。其第一参数为序列的 identifier，第二个参数为 num。

注意

在 TiDB 序列的实现中，SETVAL 函数并不能改变序列增长的初始步调或循环步调。在 SETVAL 之后只会返回符合步调规律的下一个有效的序列值。

• 创建一个默认参数的序列对象。

  CREATE SEQUENCE seq;

  Query OK, 0 rows affected (0.06 sec)

• 使用 nextval() 函数获取序列对象的下一个值。

  SELECT nextval(seq);

  +--------------+
  | nextval(seq) |
  +--------------+
  |            1 |
  +--------------+
  1 row in set (0.02 sec)

• 使用 lastval() 函数获取本会话上一次调用序列对象所产生的值。

  SELECT lastval(seq);

  +--------------+
  | lastval(seq) |
  +--------------+
  +--------------+
  1 row in set (0.02 sec)

• SELECT setval(seq, 10);

  +-----------------+
  | setval(seq, 10) |
  +-----------------+
  |              10 |
  +-----------------+
  1 row in set (0.01 sec)

• 也可使用 next value for 语法获取序列的下一个值。

  +--------------------+
  | next value for seq |
  +--------------------+
  |                 11 |
  +--------------------+
  1 row in set (0.00 sec)

• 创建一个默认自定义参数的序列对象。

  CREATE SEQUENCE seq2 start 3 increment 2 minvalue 1 maxvalue 10 cache 3;

  Query OK, 0 rows affected (0.01 sec)

• 当本会话还未使用过序列对象时，lastval() 函数返回 NULL 值。

  +---------------+
  | lastval(seq2) |
  +---------------+
  |          NULL |
  +---------------+
  1 row in set (0.01 sec)

• 序列对象 nextval() 的第一个有效值为 start 值。

  SELECT nextval(seq2);

  +---------------+
  | nextval(seq2) |
  +---------------+
  |             3 |
  1 row in set (0.00 sec)

• 使用 setval() 虽然可以改变序列对象当前值的位置，但是无法改变下一个值的等差规律。

  SELECT setval(seq2, 6);

  +-----------------+
  | setval(seq2, 6) |
  +-----------------+
  |               6 |
  +-----------------+
  1 row in set (0.00 sec)

• 使用 nextval() 下一个值获取时，会遵循序列定义的等差规律。

  +---------------------+
  | next value for seq2 |
  +---------------------+
  |                   7 |
  +---------------------+
  1 row in set (0.00 sec)

• 可以将序列的下一个值作为列的默认值来使用。

  CREATE TABLE t(a int default next value for seq2);

  Query OK, 0 rows affected (0.02 sec)

• 下列示例中，因为没有指定值，会直接获取 seq2 的默认值来使用。

  INSERT into t values();

  Query OK, 1 row affected (0.00 sec)

  SELECT * from t;

  +------+
  | a    |
  +------+
  |    9 |
  +------+
  1 row in set (0.00 sec)

• 下列示例中，因为没有指定值，会直接获取 seq2 的默认值来使用。由于 seq2 的下一个值超过了上述示例 (CREATE SEQUENCE seq2 start 3 increment 2 minvalue 1 maxvalue 10 cache 3;) 的定义范围，所以会显示报错。

  INSERT into t values();

  ERROR 4135 (HY000): Sequence 'test.seq2' has run out

MySQL 兼容性

该语句是 TiDB 的扩展，序列的实现借鉴自 MariaDB。

除了 SETVAL 函数外，其他函数的“步调 (progressions)” 与 MariaDB 一致。这里的步调是指，序列中的数在定义之后会产生一定的等差关系。SETVAL 虽然可以将序列的当前值进行移动设置，但是后续出现的值仍会遵循原有的等差关系。

示例如下：

• SHOW CREATE SEQUENCE