ALTER SEQUENCE

ALTER SEQUENCE 语句用于在 TiDB 中修改序列对象。序列是一种与 Table 和 View 对象平级的数据库对象，用于生成自定义的序列化 ID。

语法图

CreateSequenceStmt

TableName

CreateSequenceOptionListOpt

SequenceOptionList

SequenceOption

1. CreateSequenceStmt ::=
2. 'ALTER' 'SEQUENCE' TableName CreateSequenceOptionListOpt

4. TableName ::=
5. Identifier ('.' Identifier)?

7. CreateSequenceOptionListOpt ::=
8. SequenceOption*

10. SequenceOptionList ::=
11. SequenceOption

13. SequenceOption ::=
14. ( 'INCREMENT' ( '='? | 'BY' ) | 'START' ( '='? | 'WITH' ) | ( 'MINVALUE' | 'MAXVALUE' | 'CACHE' ) '='? ) SignedNum
15. |   'COMMENT' '='? stringLit
16. |   'NOMINVALUE'
17. |   'NO' ( 'MINVALUE' | 'MAXVALUE' | 'CACHE' | 'CYCLE' )
18. |   'NOMAXVALUE'
19. |   'NOCACHE'
20. |   'CYCLE'
21. |   'NOCYCLE'
22. |   'RESTART' ( ( '='? | 'WITH' ) SignedNum )?

语法说明

1. ALTER SEQUENCE sequence_name
2. [ INCREMENT [ BY | = ] increment ]
3. [ MINVALUE [=] minvalue | NO MINVALUE | NOMINVALUE ]
4. [ MAXVALUE [=] maxvalue | NO MAXVALUE | NOMAXVALUE ]
5. [ START [ WITH | = ] start ]
6. [ CACHE [=] cache | NOCACHE | NO CACHE]
7. [ CYCLE | NOCYCLE | NO CYCLE]
8. [table_options]

参数说明

注意

在执行 ALTER SEQUENCE ... RESTART 之前，更改 START 值不会影响生成的值。

SEQUENCE 函数

主要通过表达式函数来操纵序列的使用。

• NEXTVAL 或 NEXT VALUE FOR

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

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

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

注意

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

示例

创建一个名为 s1 的序列：

1. CREATE SEQUENCE s1;

1. Query OK, 0 rows affected (0.15 sec)

执行以下 SQL 语句两次，获取该序列接下来的两个值：

1. SELECT NEXTVAL(s1);

1. +-------------+
2. | NEXTVAL(s1) |
3. +-------------+
4. |           1 |
5. +-------------+
6. 1 row in set (0.01 sec)

1. SELECT NEXTVAL(s1);

1. +-------------+
2. | NEXTVAL(s1) |
3. +-------------+
4. |           2 |
5. +-------------+
6. 1 row in set (0.00 sec)

将该序列的步长更改为 2：

1. ALTER SEQUENCE s1 INCREMENT=2;

1. Query OK, 0 rows affected (0.18 sec)

此时，再次获取该序列接下来的两个值：

1. SELECT NEXTVAL(s1);

1. +-------------+
2. | NEXTVAL(s1) |
3. +-------------+
4. |        1001 |
5. +-------------+
6. 1 row in set (0.02 sec)

1. SELECT NEXTVAL(s1);

1. +-------------+
2. | NEXTVAL(s1) |
3. +-------------+
4. |        1003 |
5. +-------------+
6. 1 row in set (0.00 sec)

从以上输出中可以看到，在执行了 ALTER SEQUENCE 语句后，数值的增幅为 2。

你还可以更改序列的其他参数。例如，可以按照以下方式更改序列的 MAXVALUE：

1. CREATE SEQUENCE s2 MAXVALUE=10;

1. Query OK, 0 rows affected (0.17 sec)

1. ALTER SEQUENCE s2 MAXVALUE=100;

1. Query OK, 0 rows affected (0.15 sec)

1. SHOW CREATE SEQUENCE s2\G

1. *************************** 1. row ***************************
2. Sequence: s2
3. Create Sequence: CREATE SEQUENCE `s2` start with 1 minvalue 1 maxvalue 100 increment by 1 cache 1000 nocycle ENGINE=InnoDB
4. 1 row in set (0.00 sec)

MySQL 兼容性

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

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

示例如下：

1. 1, 3, 5, ...            // 序列遵循起始为 1、步长为 2 的等差关系。
2. SELECT SETVAL(seq, 6)   // 设置序列的当前值为 6。
3. 7, 9, 11, ...           // 后续产生值仍会遵循这个等差关系。

在 CYCLE 模式下，序列的起始值第一轮为 START，后续轮次将会是 MinValue (INCREMENT > 0) 或 MaxValue (INCREMENT < 0)。

另请参阅

• CREATE SEQUENCE
• DROP SEQUENCE
• SHOW CREATE SEQUENCE
• Sequence Functions