跳到主要内容
版本：V1.1.0

ALTER SEQUENCE

描述​

该语句用于更改现有序列的增量、最小值和最大值、缓存数量和行为，对应操作仅影响后续的序列号。

信息

用户只能操作属于自己 Schema 中的序列，或者拥有该序列的有 ALTER 对象权限。

语法​

ALTER SEQUENCE [ schema. ] sequence_name
{ RESTART [ START WITH int_value ]
|[ MINVALUE int_value | NOMINVALUE ]
|[ MAXVALUE int_value | NOMAXVALUE ]
|[ INCREMENT BY int_value ]
|[ CACHE int_value | NOCACHE ]
|[ ORDER | NOORDER ]
|[ CYCLE | NOCYCLE]
}
;

参数说明​

字段描述
schema.指定包含序列的 Schema。如果省略 Schema，则数据库会在用户当前所在的 Schema 中更改序列。
sequence_name要更改的序列名称。
RESTART重置序列值。升序时从 MINVALUE 重新开始取值；降序时从 MAXVALUE 重新开始取值；或者，使用 START WITH int_value 从 int_value 处开始取值。
MINVALUE int_value更改序列的最小值，int_value 的取值范围是 [-(1027-1) ~ (1027-1)]。
NOMINVALUE如果更改为 NOMINVALUE，则升序时最小值为 1，降序时最小值为 -(1027-1)。
MAXVALUE int_value更改序列的最大值，int_value 的取值范围是 [(-1027+1) ~ (1028-1)]。新指定的 MAXVALUE 不能小于当前序列号的值。
注意 同时指定 MINVALUE 和 MAXVALUE 时，MINVALUE 必须小于 MAXVALUE。 MAXVALUE 和 MINVALUE 之差必须大于等于 INCREMENT BY 中 的 int_value。
NOMAXVALUE如果更改为 NOMAXVALUE，则升序时最大值为(1028-1)，降序时最大值为 -1。
INCREMENT BY int_value更改序列的自增步数。int_value 不可以为 0。如果指定为正数，则序列为升序；如果指定为负数，则序列为降序。不指定时缺省值为 1。
CACHE int_value更改在内存中预分配的自增值个数，int_value 默认为 20。CACHE int_value 的值必须大于 1，如果 CACHE INT_VALUE 的值为 1，则等价于 NOCACHE。
NOCACHE更改序列的值为未预先分配。如果同时省略 CACHE 和 NOCACHE，则数据库默认缓存 20 个序列号。
ORDER更改序列的值为按顺序生成。
NOORDER如果更改为 NOORDER，则指定不保证序列的值按顺序生成。
CYCLE更改序列的值为循环生成，即序列在达到其最大值或最小值后继续生成值。在升序达到最大值后，它会生成最小值。在降序序列达到其最小值后，它会生成其最大值。
注意
  • 如果指定了 CYCLE，而且 INCREMENT BY 中的 int_value 小于 0 时，必须指定 MINVALUE。
  • 如果指定了 CYCLE，CACHE 的数量不能超过一个 CYCLE。
NOCYCLENOCYCLE 为默认值，如果更改为 NOCYCLE，则指定序列在达到其最大值或最小值后无法生成更多值。

示例​

  • 修改自增列 seq1 的最大值，并指定自增值循环生成。

    ALTER SEQUENCE seq1 MAXVALUE 1024 CYCLE;
    Query OK, 0 rows affected (0.001 sec)

  • 更改序列 seq3 的最大值和自增步数，开启 CYCLE 和 ORDER，并指定 NOCACHE 以指示序列的值未预先分配。

    ALTER SEQUENCE seq3 MAXVALUE 1500 INCREMENT BY 5 CYCLE NOCACHE ORDER;
    Query OK, 0 rows affected (0.001 sec)

  • 重置序列值，并从 3 开始取值。

    ALTER SEQUENCE seq3 RESTART;
    ALTER SEQUENCE seq3 RESTART START WITH 3;

  • RESTART 的位置可以在选项的任意位置。如下示例中的两条重置序列值的 shell 语句是等价的。

    ALTER SEQUENCE seq3 START WITH 3 RESTART MINVALUE  -100 CYCLE;
    ALTER SEQUENCE seq3 RESTAR START WITH 3 T MINVALUE  -100 CYCLE;

Contents

编辑此页