创建序列

创建序列

更新时间：2024-12-26 23:00:00

在 OceanBase 数据库中，序列（Sequence）是数据库按照一定规则生成的自增数字序列号，通常是一组间隔的数值（为数字类型）。由于序列具有自增的特性，故通常会被用作主键和唯一键。

可以使用 CREATE SEQUENCE 语句来创建序列。序列提供了两个伪列 CURRVAL和 NEXTVAL，用于返回当前的序列值和下一个序列值。每当查询 NEXTVAL 都会推进 CURRVAL 值。

SQL 语法如下：

CREATE SEQUENCE [IF NOT EXISTS] [database_name.]sequence_name
[MINVALUE int_value | NOMINVALUE]
[MAXVALUE int_value | NOMAXVALUE]
[START WITH int_value]
[INCREMENT BY int_value]
[CACHE int_value | NOCACHE]
[ORDER | NOORDER]
[CYCLE | NOCYCLE];

语句使用说明：

执行该语句的用户需要具备 CREATE 权限。
IF NOT EXISTS：可选，如果待创建的序列已存在，并且没有指定 IF NOT EXISTS，则系统会报错。
database_name. ：可选，用于指定序列所在的数据库。如果不指定 database_name.，则默认为创建当前登录数据库的序列。
MINVALUE int_value | NOMINVALUE：用于指定序列的最小值，取值范围为 [-10²⁷ ~ (10²⁷-1)]。

如果指定为 NOMINVALUE，则升序时最小值为 1，降序时最小值为 -(10²⁷-1)。

如果不指定MINVALUE，则缺省为 NOMINVALUE。
MAXVALUE int_value | NOMAXVALUE：用于指定序列的最大值，取值范围为 [(-10²⁷+1) ~ (10²⁸-1)]。

如果指定为 NOMAXVALUE，则升序时最大值为 (10²⁸-1)，降序时最大值为 -1。

如果不指定 MAXVALUE，则缺省为 NOMAXVALUE。
START WITH：用于指定序列的起始值。该值必须小于等于 MAXVALUE，且大于等于 MINVALUE。如果不指定，则升序时默认取值为最小值，降序时默认取值为最大值。
INCREMENT BY：用于指定序列的自增步数。该值不可以为 0。如果指定为正数，则序列为升序；如果指定为负数，则序列为降序。如果不指定，则缺省值为 1。
CACHE：用于指定在内存中预分配的自增值个数，默认为 20。
ORDER | NOORDER：用于指定序列的值是否按顺序生成。ORDER 表示按顺序生成，NOORDER 表示不按顺序生成。默认为 NOORDER。
CYCLE | NOCYCLE：用于指定序列的值是否循环生成。CYCLE 表示循环生成，NOCYCLE 表示不循环生成。默认为 NOCYCLE。

注意

如果同时指定 MINVALUE 和 MAXVALUE，则 MINVALUE 必须小于 MAXVALUE。
MAXVALUE 和 MINVALUE 之差必须大于等于 INCREMENT BY int_value。
CACHE 的值必须大于 1，如果 CACHE INT_VALUE 的值为 1，则等价于 NOCACHE。
指定了 CYCLE，且 INCREMENT BY 的值小于 0 时，必须指定 MINVALUE。
指定了 CYCLE 时，CACHE 的数量必须不能超过一个 CYCLE。

创建一个序列 seq1 并指定自增步数为 2 的示例如下：

obclient> CREATE SEQUENCE seq1 START WITH 1 MINVALUE 1 MAXVALUE 10 INCREMENT BY 2 NOCYCLE NOORDER CACHE 30;

更多 CREATE SEQUENCE 语句的信息，参见 CREATE SEQUENCE。

注意

相关文档