更新时间:2026-10-21 GMT+08:00
分享

CREATE SEQUENCE

功能描述

向当前数据库创建一个新的序列。序列是指一个存放等差数列的特殊表,该表不存储常规数据,通常用于为行或者表生成唯一的标识符。

注意事项

  • 仅当用户被授予CREATE ANY SEQUENCE权限,才允许在PUBLIC模式和用户模式下进行创建操作。创建序列的用户将成为序列的所有者。
  • 创建序列后,使用序列的nextval()函数以及generate_series(1,N)函数对表插入数据时,需保证nextval()函数的可调用次数大于等于N+1次,否则会因generate_series()内部调用N+1次nextval()而导致报错。
  • 序列不支持与rowid、rowno系统列关联。

语法格式

CREATE [ LARGE | TEMPORARY | TEMP ] SEQUENCE [ IF NOT EXISTS ] name [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE | NOMINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE] 
    [ START [ WITH ] start ] [ CACHE cache | NOCACHE ] [ [ NO ] CYCLE | NOCYCLE ] [ RESTART [ WITH start ] ] [ [ NO ] ORDER | NOORDER ]
    [ OWNED BY { table_name.column_name | NONE } ];

参数说明

  • LARGE

    如果指定LARGE关键字,会创建int128位的序列;未指定LARGE关键字,则默认创建int64的序列。

    SEQUENCE默认最大值为263-1,如果使用了LARGE标识,最大值可以支持到2127-1。

  • TEMPORARY | TEMP

    可选。临时序列关键字。

    • 创建临时序列需要数据库启用PG兼容。
    • 临时序列的生命周期是会话级的,临时序列对象是会话隔离的。序列在会话退出后会自动删除清理。
    • 临时序列存在于一个特殊的模式中,每个会话有且仅有一个临时模式,若提前创建了临时模式,则在创建临时序列时可给出模式名,若未提前创建,则在创建临时序列时不能给出模式名,并且每个会话只能访问自己的临时模式中的对象,无法访问其他会话的临时模式中的对象。如果访问的临时模式不属于本会话,会报告错误。
    • 当临时序列存在时,已有的同名永久序列(在这个会话中) 会变得不可见,不过可以用模式限定的名称来引用同名永久序列。
  • IF NOT EXISTS

    如果指定IF NOT EXISTS关键字,创建序列前会在当前Schema中查找是否存在同名的序列,若存在则不会新建,返回NOTICE提示。

    未指定IF NOT EXISTS关键字时,若Schema中存在同名序列,返回ERROR告警。

  • name

    创建的序列名称。可以使用模式进行具体指定,指定模式名,则在指定的模式中创建该序列,否则会在当前模式中进行创建。同一模式下,序列名需满足唯一约束,不能和同一个模式中的其他序列、表、索引、视图或外表的名称相同。

    取值范围:字符串,要符合标识符命名规范且最大长度不超过63个字符。

  • increment

    可选。指定序列的步长。

    • 正数:将生成一个递增的序列。
    • 负数:将生成一个递减的序列。
    默认值为1。

    在B兼容模式下,步长为浮点数时会自动转为整型。其他模式下,该参数不支持输入浮点数。

  • MINVALUE minvalue | NO MINVALUE| NOMINVALUE

    可选,执行序列的最小值。NOMINVALUE等价于NO MINVALUE。

    如果没有声明minvalue或者声明了NO MINVALUE时:

    • 对于未声明LARGE关键字的序列,递增序列的默认值为1,递减序列的默认值为-263+1。
    • 对于声明了LARGE关键字的序列,递增序列的默认值为1,递减序列的默认值为-2127。
  • MAXVALUE maxvalue | NO MAXVALUE| NOMAXVALUE

    可选。执行序列的最大值。NOMAXVALUE等价于NO MAXVALUE。

    如果没有声明maxvalue或者声明了NO MAXVALUE时:

    • 对于未声明LARGE关键字的序列,递增序列的默认值为263-1,递减序列的默认值为-1。
    • 对于声明了LARGE关键字的序列,递增序列的默认值为2127-1,递减序列的默认值为-1。

    序列与表字段绑定时,若序列值增长超过字段类型最大值,将导致插入报错。因此,字段类型必须能容纳序列的最大可能值,避免业务异常。

  • START [ WITH ] start

    可选。指定序列的起始值。

    默认值:对于递增序列为minvalue,递减序列为maxvalue。

  • CACHE cache | NOCACHE

    可选。为了快速访问,而在内存中预先存储序列号的个数。NOCACHE等价于不指定cache值。

    默认值为1,表示一次只能生成一个值,即没有缓存。

    不建议同时定义cache和maxvalue/minvalue。定义cache后无法保证序列的连续性,可能会产生空洞,造成序列号段浪费。

  • [ NO ] CYCLE | NOCYCLE

    可选。使序列达到maxvalue或者minvalue后可循环并继续循环。

    如果声明了NO CYCLE,则在序列达到其最大值后任何对nextval的调用都会返回一个错误。

    • NOCYCLE的作用等价于NO CYCLE。当未指定循环循环选项时,默认值为NO CYCLE。
    • 若指定序列为CYCLE时,则不能保证序列的唯一性。
  • RESTART [ WITH start ]

    可选。重新指定序列的起始值。

    当未指定具体的start时,对于递增序列该选项的默认值为minvalue,对于递减序列该选项的默认值为maxvalue。

  • [ NO ] ORDER | NOORDER

    可选。用于标识序列是否全局有序。NOORDER的作用等价于NO ORDER,未指定该关键字时,默认值为NO ORDER。

    • 若定义序列为NO ORDER,在不同会话之间无法保证序列的连续性,可能会产生空洞,造成序列号段浪费。
    • 若定义序列为ORDER,可保证后续并发获取的序列值在不同会话之间全局有序递增或递减。
    • 该选项仅在A兼容性下支持。
    • 从不支持该选项的版本升级至当前版本,升级提交后该选项才可生效。
  • OWNED BY

    可选。将序列和一个表的指定字段进行关联。在删除该字段或其所在表的时候,将自动删除已关联的序列。关联的表和序列的所有者必须是同一个用户,并且在同一个模式中。需要注意的是,通过指定OWNED BY,仅仅是建立了表的对应列和序列之间关联关系,并不会在插入数据时在该列上产生自增序列。

    未指定该选项时,默认为OWNED BY NONE,表示不存在具体的关联。

    通过OWNED BY创建的序列不建议用于其他表,如果希望多个表共享序列,该系列不应该从属于特定表。

示例

  • 创建一个名为seq1的递增序列,从101开始,步长为10。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    gaussdb=# CREATE SEQUENCE seq1
        START 101
        INCREMENT 10;
    
    --从序列中选出下一个数字:
    gaussdb=# SELECT nextval('seq1');
     nextval 
    ---------
         101
    (1 row)
    gaussdb=# SELECT nextval('seq1');
     nextval 
    ---------
         111
    
    --删除序列。
    gaussdb=# DROP SEQUENCE seq1;
    
  • 表自增列的一种实现。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    --创建表。
    gaussdb=# CREATE TABLE test1(id int PRIMARY KEY, name varchar(20));
    
    --创建与表关联的序列。
    gaussdb=# CREATE SEQUENCE test_seq2
        START 1
        NO CYCLE
        OWNED BY test1.id;
    
    --设置字段的默认值。
    gaussdb=# ALTER TABLE test1 ALTER COLUMN id SET DEFAULT nextval('test_seq2'::regclass);
    
    -- 插入数据。
    gaussdb=# INSERT INTO test1 (name) values ('Joe'),('Scott'),('Ben');
    
    --查询表的数据。
    gaussdb=# SELECT * FROM test1;
     id | name  
    ----+-------
      1 | Joe
      2 | Scott
      3 | Ben
    (3 rows)
    
    --删除序列和表。
    gaussdb=# DROP SEQUENCE test_seq2 CASCADE;
    gaussdb=# DROP TABLE test1;
    
  • 序列的循环。
    --创建一个递增序列seq_test1,最大值为3,且可以循环。
    gaussdb=# CREATE SEQUENCE seq_test1
        START 1 
        MAXVALUE 3 
        CYCLE;
    
    --建表,并插数据。
    gaussdb=# CREATE TABLE tbl_test1(
        c1 int DEFAULT nextval('seq_test1'),
        c2 varchar
    );
    gaussdb=# INSERT INTO tbl_test1 (c2) values ('test');
    gaussdb=# INSERT INTO tbl_test1 (c2) values ('test');
    gaussdb=# INSERT INTO tbl_test1 (c2) values ('test');
    gaussdb=# INSERT INTO tbl_test1 (c2) values ('test');
    gaussdb=# INSERT INTO tbl_test1 (c2) values ('test');
    
    --查询表数据,当递增序列seq_test的值达到最大值后会重新从最小值开始。
    gaussdb=# SELECT * FROM tbl_test1;
     c1 |  c2  
    ----+------
      1 | test
      2 | test
      3 | test
      1 | test
      2 | test
    (5 rows)
    
    --删除表和序列。
    gaussdb=# DROP TABLE tbl_test1;
    gaussdb=# DROP SEQUENCE seq_test1;
  • 序列全局有序。
    --创建一个全局有序的递增序列。
    gaussdb=# CREATE SEQUENCE seq_test2 ORDER START WITH 1 INCREMENT BY 1 CACHE 50;
    CREATE SEQUENCE
    --创建表。
    gaussdb=# CREATE TABLE tbl_test2(c1 int, c2 varchar);
    CREATE TABLE
    --开启三个不同会话,并行执行插表操作。
    --会话A:
    gaussdb=# INSERT INTO tbl_test2 values (nextval('seq_test2'), 'sessionA');
    INSERT 0 1
    --会话B:
    gaussdb=# INSERT INTO tbl_test2 values (nextval('seq_test2'), 'sessionB');
    INSERT 0 1
    --会话C:
    gaussdb=# INSERT INTO tbl_test2 values (nextval('seq_test2'), 'sessionC');
    INSERT 0 1
    --查询表数据,递增序列seq_test2的值全局有序,且不会产生空洞,不会造成序列号段浪费。
    gaussdb=# SELECT * FROM tbl_test2;
     c1 |    c2
    ----+----------
      1 | sessionA
      2 | sessionB
      3 | sessionC
    (3 rows)
    --删除表和序列。
    gaussdb=# DROP TABLE tbl_test2;
    DROP TABLE
    gaussdb=# DROP SEQUENCE seq_test2;
    DROP SEQUENCE

相关链接

DROP SEQUENCE,ALTER SEQUENCE

相关文档