2024 年 9 月 26 日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4

ALTER SEQUENCE

ALTER SEQUENCE — 更改序列生成器的定义

概要

ALTER SEQUENCE [ IF EXISTS ] name
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ START [ WITH ] start ]
    [ RESTART [ [ WITH ] restart ] ]
    [ CACHE cache ] [ [ NO ] CYCLE ]
    [ OWNED BY { table_name.column_name | NONE } ]
ALTER SEQUENCE [ IF EXISTS ] name SET { LOGGED | UNLOGGED }
ALTER SEQUENCE [ IF EXISTS ] name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SEQUENCE [ IF EXISTS ] name RENAME TO new_name
ALTER SEQUENCE [ IF EXISTS ] name SET SCHEMA new_schema

描述

ALTER SEQUENCE 更改现有序列生成器的参数。任何未在 ALTER SEQUENCE 命令中特别设置的参数将保留其先前设置。

您必须拥有序列才能使用 ALTER SEQUENCE。要更改序列的模式,您还必须对新模式具有 CREATE 权限。要更改所有者,您必须能够将 SET ROLE 设置为新的拥有角色,并且该角色必须对序列的模式具有 CREATE 权限。(这些限制强制执行更改所有者不会执行任何您无法通过删除和重新创建序列来完成的操作。但是,超级用户可以随意更改任何序列的所有权。)

参数

name

要更改的序列的名称(可选的模式限定)。

IF EXISTS

如果序列不存在,则不抛出错误。在这种情况下,将发出通知。

data_type

可选子句 AS data_type 更改序列的数据类型。有效类型为 smallintintegerbigint

更改数据类型会自动更改序列的最小值和最大值,当且仅当先前最小值和最大值是旧数据类型的最小值或最大值时(换句话说,如果序列是使用 NO MINVALUENO MAXVALUE 创建的,无论是隐式还是显式)。否则,将保留最小值和最大值,除非在同一命令中给出新值。如果最小值和最大值不适合新数据类型,则会生成错误。

increment

子句 INCREMENT BY increment 是可选的。正值将生成递增序列,负值将生成递减序列。如果未指定,则将保留旧的增量值。

minvalue
NO MINVALUE

可选子句 MINVALUE minvalue 确定序列可以生成的最小值。如果指定 NO MINVALUE,则将使用 1 和数据类型对于递增和递减序列的最小值的默认值。如果未指定任何选项,则将保留当前最小值。

maxvalue
NO MAXVALUE

可选子句 MAXVALUE maxvalue 确定序列的最大值。如果指定 NO MAXVALUE,则将使用数据类型对于递增和递减序列的最大值和 -1 的默认值。如果未指定任何选项,则将保留当前最大值。

start

可选子句 START WITH start 更改序列的记录起始值。这对序列的 当前 值没有影响;它只是设置 ALTER SEQUENCE RESTART 命令将来将使用的值。

restart

可选子句 RESTART [ WITH restart ] 更改序列的当前值。这类似于使用 is_called = false 调用 setval 函数:指定的值将由 nextval下一次 调用返回。编写 RESTART 而不带 restart 值等效于提供 CREATE SEQUENCE 记录或 ALTER SEQUENCE START WITH 最后设置的起始值。

setval 调用相反,对序列执行的 RESTART 操作是事务性的,并且会阻止并发事务从同一序列获取数字。如果这不是所需的运行模式,则应使用 setval

cache

子句 CACHE cache 允许预先分配序列号并存储在内存中以进行更快访问。最小值为 1(一次只能生成一个值,即没有缓存)。如果未指定,则将保留旧的缓存值。

CYCLE

可选的 CYCLE 关键字可用于启用序列在递增或递减序列分别达到 maxvalueminvalue 时进行循环。如果达到限制,则生成的下一个数字将分别为 minvaluemaxvalue

NO CYCLE

如果指定了可选的 NO CYCLE 关键字,则在序列达到其最大值后,对 nextval 的任何调用都将返回错误。如果未指定 CYCLENO CYCLE,则将保留旧的循环行为。

SET { LOGGED | UNLOGGED }

此形式将序列从非日志更改为日志或反之亦然(参见 CREATE SEQUENCE)。它不能应用于临时序列。

OWNED BY table_name.column_name
OWNED BY NONE

OWNED BY 选项会导致序列与特定表列相关联,这样如果该列(或其整个表)被删除,序列也将自动删除。如果指定,此关联将替换序列以前指定的任何关联。指定的表必须与序列具有相同的拥有者,并且位于与序列相同的模式中。指定 OWNED BY NONE 将删除任何现有关联,使序列成为 独立

new_owner

序列的新所有者的用户名。

new_name

序列的新名称。

new_schema

序列的新模式。

注意事项

ALTER SEQUENCE 不会立即影响 nextval 结果,除了当前后端之外,其他后端已预先分配(缓存)序列值。它们将使用所有缓存值,然后才会注意到序列生成参数的更改。当前后端将立即受到影响。

ALTER SEQUENCE 不会影响序列的 currval 状态。(在 PostgreSQL 8.3 之前,有时会这样。)

ALTER SEQUENCE 会阻止并发 nextvalcurrvallastvalsetval 调用。

由于历史原因,ALTER TABLE 也可用于序列;但是,允许用于序列的 ALTER TABLE 的唯一变体等效于上面显示的形式。

示例

将名为 serial 的序列重新启动为 105

ALTER SEQUENCE serial RESTART WITH 105;

兼容性

ALTER SEQUENCE 符合SQL标准,除了 ASSTART WITHOWNED BYOWNER TORENAME TOSET SCHEMA 子句,这些子句是 PostgreSQL 扩展。

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符或需要进一步说明,请使用 此表格 报告文档问题。