FUNCTION序列操作函数

setval

设置序列对象的当前值，以及可选的它的is_called标志。

Sets the sequence object's current value, and optionally its is_called flag.

序列操作函数引入 9.0（基线）现存至 20 devel 1 条签名 0 次签名变更

版本轨迹

相对 PostgreSQL 17 无变化。

PostgreSQL 18 里 setval 的 1 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色，之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。

setval ( regclass, bigint [, boolean ] ) → bigint

设置序列对象的当前值，以及可选的它的is_called标志。双参数形式将序列的last_value字段设置为指定的值，并将其is_called字段设置为true，意味着下一个nextval将在返回值之前推进序列。 currval将报告的值也设置为指定的值。在三参数形式中，is_called可以设置为true 或 false。 true与双参数形式具有相同的效果。如果设置为false，下一个nextval将返回指定的值，序列推进从下面的nextval开始。而且，currval报告的值在这种情况下不会改变。例如,

相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。

每条签名在给出了签名的 18 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。

存在不存在

签名	9.0	9.1	9.2	9.3	9.4	9.5	9.6	10	11	12	13	14	15	16	17	18	19	20
`setval ( regclass, bigint ) → bigint`	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在
`setval ( regclass, bigint, boolean ) → bigint`	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在
`setval ( regclass, bigint [, boolean ] ) → bigint`	不存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在	不存在	存在	存在	存在	存在	存在	存在	存在	存在

函数	签名	主签名	最近变更
SEQUENCE MANIPULATION FUNCTIONS 序列操作函数 5 个 ↗
`currval`基线	1	`currval ( regclass ) → bigint`	—
返回nextval在当前会话中为该序列最近获取的值。			现存
`lastval`基线	1	`lastval () → bigint`	—
返回nextval在当前会话中最近返回的值。			现存
`nextval`基线	1	`nextval ( regclass ) → bigint`	—
将序列对象推进到下一个值并返回该值。			现存
`pg_get_sequence_data`	1	`pg_get_sequence_data ( regclass ) → record ( last_value bigint, is_called bool, page_lsn pg_lsn )`	—
返回有关序列的信息。			现存
`setval`基线	1	`setval ( regclass, bigint [, boolean ] ) → bigint`	—
设置序列对象的当前值，以及可选的它的is_called标志。			现存