sequence-functions.md

title	summary
序列函数	了解 TiDB 中的序列函数。

序列函数

TiDB 中的序列函数用于返回或设置使用 CREATE SEQUENCE 语句创建的序列对象的值。

函数名称	功能描述
NEXTVAL()	返回序列的下一个值
NEXT VALUE FOR	返回序列的下一个值（NEXTVAL() 的别名）
SETVAL()	设置序列的当前值
LASTVAL()	返回当前会话中最近一次生成的序列值

NEXTVAL()

NEXTVAL() 函数返回序列的下一个值。

示例：

创建一个序列 s1：

CREATE SEQUENCE s1;

从序列 s1 中获取下一个值：

SELECT NEXTVAL(s1);

输出结果如下：

+-------------+
| NEXTVAL(s1) |
+-------------+
|           1 |
+-------------+
1 row in set (0.00 sec)

NEXT VALUE FOR

NEXT VALUE FOR 函数是 NEXTVAL() 的别名。

示例：

使用 NEXTVAL() 从序列 s1 中获取下一个值：

SELECT NEXTVAL(s1);

输出结果如下：

+-------------+
| NEXTVAL(s1) |
+-------------+
|           2 |
+-------------+
1 row in set (0.00 sec)

使用 NEXT VALUE FOR 从序列 s1 中获取下一个值：

SELECT NEXT VALUE FOR s1;

输出结果如下：

+-------------------+
| NEXT VALUE FOR s1 |
+-------------------+
|                 3 |
+-------------------+
1 row in set (0.00 sec)

SETVAL()

SETVAL(n) 函数设置序列的当前值。

示例：

从序列 s1 中获取下一个值：

SELECT NEXTVAL(s1);

输出结果如下：

+-------------+
| NEXTVAL(s1) |
+-------------+
|           4 |
+-------------+
1 row in set (0.00 sec)

将序列 s1 的当前值设置为 10：

SELECT SETVAL(s1, 10);

输出结果如下：

+----------------+
| SETVAL(s1, 10) |
+----------------+
|             10 |
+----------------+
1 row in set (0.00 sec)

验证设置序列的当前值为 10 后的下一个值：

SELECT NEXTVAL(s1);

输出结果如下：

+-------------+
| NEXTVAL(s1) |
+-------------+
|          11 |
+-------------+
1 row in set (0.00 sec)

LASTVAL()

LASTVAL() 函数返回当前会话中最近一次生成的序列值。

示例：

获取当前会话中最后使用的 s1 序列的值：

SELECT LASTVAL(s1);

输出结果如下：

+-------------+
| LASTVAL(s1) |
+-------------+
|          11 |
+-------------+
1 row in set (0.00 sec)

MySQL 兼容性

根据 ISO/IEC 9075-2，MySQL 不支持创建和操作序列的函数和语句。