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

ALTER SEQUENCE

功能描述

修改指定序列的参数。

注意事项

  • 序列的所有者、被授予了序列ALTER权限的用户或者被授予了ALTER ANY SEQUENCE权限的用户才能执行ALTER SEQUENCE命令,三权分立开关关闭时,系统管理员默认拥有该权限。但要修改序列的所有者,当前用户必须是该序列的所有者或者系统管理员,且该用户是新所有者角色的成员。
  • A兼容模式下,支持修改序列的拥有者、最大值、最小值、步长、当前值、归属列、是否循环、是否有序以及缓存值;其他兼容模式下,支持修改序列的拥有者、归属列、最大值以及缓存值。若要修改其他参数,可以删除重建,并用setval函数恢复当前值。
  • 不支持在事务、函数和存储过程中进行修改序列的最大值、最小值、步长、当前值、循环选项以及有序选项的操作。
  • 修改序列的最大值、最小值、步长、当前值、循环选项、有序选项或缓存值后,会清空该序列在所有会话的缓存值。
  • 如果创建序列时指定了LARGE标识,则在进行ALTER操作时,也需指定LARGE标识。
  • ALTER SEQUENCE会阻塞nextval、setval、currval和lastval的调用。

语法格式

  • 修改序列最大值、最小值、步长、当前值、归属列、循环选项、有序选项以及缓存值
    ALTER [ LARGE ] SEQUENCE [ IF EXISTS ] name 
        [ MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE ] [ CACHE cache | NOCACHE ]
        [ MINVALUE minvalue | NO MINVALUE | NOMINVALUE ] [ [ NO ] CYCLE | NOCYCLE ]
        [ INCREMENT [ BY ] increment ] [ RESTART [START WITH start ] ]
        [ [ NO ] ORDER | NOORDER ]
        [ OWNED BY { table_name.column_name | NONE } ] ;

  • 修改序列的拥有者
    ALTER [ LARGE ] SEQUENCE [ IF EXISTS ] name OWNER TO new_owner;

参数说明

  • LARGE

    LARGE标识,如果创建序列时指定了LARGE标识,则在进行ALTER操作时,也需指定LARGE标识。

  • name

    将要修改的序列名称。

  • IF EXISTS

    当序列不存在时使用该选项,不会显示ERROR,而是返回一个NOTICE信息。

  • MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE

    执行序列的最大值。新修改的最大值必须大于当前的last_value值,last_value表示序列中已经被申请的序列最大值,可以使用“\d 序列名”命令进行查询。

    取值范围:

    • 若创建序列时未指定LARGE标识,取值范围为(last_value, 263-1]。
    • 若创建序列时指定LARGE标识,取值范围为(last_value, 2127-1]。
  • MINVALUE minvalue | NO MINVALUE| NOMINVALUE

    执行序列的最小值。新修改的最小值必须小于当前的last_value值,last_value表示序列中已经被申请的序列最小值,可以使用“\d 序列名”命令进行查询。

    取值范围:

    • 若创建序列时未指定LARGE标识,取值范围为[-263+1, last_value)。
    • 若创建序列时指定LARGE标识,取值范围为[-2127, last_value)。
  • INCREMENT [ BY ] increment

    指定序列的步长。

    取值范围:
    • 正数:序列递增。
    • 负数:序列递减。
  • RESTART [ START WITH start ]

    重新指定序列的起始值。

    当未指定具体start时(即仅指定RESTART选项),对于递增序列默认起始值为minvalue,递减序列默认起始值为maxvalue。

  • [ NO ] CYCLE | NOCYCLE

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

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

    • NOCYCLE的作用等价于NO CYCLE。
    • 若定义序列为CYCLE,则不能保证序列的唯一性。
  • [ NO ] ORDER | NOORDER

    用于标识序列是否为全局有序。NOORDER的作用等价于NO ORDER。

    • 若定义序列为NO ORDER,在不同会话之间无法保证序列的连续性,可能会产生空洞,造成序列号段浪费。
    • 若定义序列为ORDER,可保证后续并发获取的序列值在不同会话之间全局有序递增或递减。
  • CACHE cache | NOCACHE

    指定序列的缓存值。当指定为NOCACHE时,序列的缓存值为1。

    取值范围:

    • 若创建序列时未指定LARGE标识,取值范围为[1, 263-1]。
    • 若创建序列时指定了LARGE标识,取值范围为[1, 2127-1]。
  • OWNED BY { table_name.column_name | NONE }

    将序列和一个表的指定字段进行关联,当进行删除该字段或其所在表的时候,会自动删除已关联的序列。

    • 如果序列已经和表有关联后,使用这个选项后新的关联关系会覆盖旧的关联。
    • 关联的表和序列的所有者必须是同一个用户,并且在同一个模式中。
    • 使用OWNED BY NONE将删除任何已经存在的关联。
  • new_owner

    序列新所有者的用户名称。修改序列的所有者,执行者必须是新角色的直接或者间接成员,并且该角色必须拥有序列所在模式上的CREATE权限。

示例

--创建一个名为serial的递增序列,从101开始。
gaussdb=# CREATE SEQUENCE serial START 101;

--创建一个表,定义默认值。
gaussdb=# CREATE TABLE t1(c1 bigint default nextval('serial'));

--将序列serial的归属列变为t1.c1。
gaussdb=# ALTER SEQUENCE serial OWNED BY t1.c1;

--修改序列serial的最大值。
gaussdb=# ALTER SEQUENCE serial MAXVALUE 1000;

--修改序列serial的最小值。
gaussdb=# ALTER SEQUENCE serial MINVALUE -1000;

--修改序列serial的步长。
gaussdb=# ALTER SEQUENCE serial INCREMENT BY 10;

--修改序列serial的起始值。
gaussdb=# ALTER SEQUENCE serial RESTART START WITH 101;

--修改序列serial的循环选项。
gaussdb=# ALTER SEQUENCE serial CYCLE;

--修改序列serial的有序选项。
gaussdb=# ALTER SEQUENCE serial ORDER;

--修改序列serial的缓存值。
gaussdb=# ALTER SEQUENCE serial CACHE 10;

--删除序列和表。
gaussdb=# DROP SEQUENCE serial CASCADE;
gaussdb=# DROP TABLE t1;

--创建一个序列seq_test。
gaussdb=# CREATE SEQUENCE seq_test;

--查询序列信息。
gaussdb=# \ds
               List of relations
 Schema |   Name   |   Type   | Owner | Storage 
--------+----------+----------+-------+---------
 public | seq_test | sequence | omm   | 
(1 row)

--创建用户u_test并修改序列所有者。
gaussdb=# CREATE USER u_test PASSWORD '********';
gaussdb=# ALTER SEQUENCE seq_test OWNER TO u_test;
gaussdb=# \ds
                List of relations
 Schema |   Name   |   Type   | Owner  | Storage 
--------+----------+----------+--------+---------
 public | seq_test | sequence | u_test | 
(1 row)

--删除用户和序列。
gaussdb=# DROP SEQUENCE seq_test;
gaussdb=# DROP USER u_test;

--创建一个序列seq_test。
gaussdb=# CREATE SEQUENCE seq_test MINVALUE 1 MAXVALUE 10 CACHE 6 INCREMENT BY 2;

--修改序列为循环序列缓存值大于循环值报错。
gaussdb=# ALTER SEQUENCE seq_test CYCLE;
ERROR:  The CACHE value may not exceed the CYCLE value.

--删除序列。
gaussdb=# DROP SEQUENCE seq_test;

相关文档