FUNCTION序列操作函数
nextval
将序列对象推进到下一个值并返回该值。
Advances the sequence object to its next value and returns that value.
序列操作函数 引入 9.0(基线) 现存至 20 devel 1 条签名 0 次签名变更
- 分组
- 序列操作函数
- 签名数
- 1 条
- 引入版本
- 9.0(基线)
- 状态
- 现存
- 签名变更
- 未变过
- 本版来源
- 本站译文
版本轨迹
相对 PostgreSQL 17 无变化。
签名
PostgreSQL 18 里 nextval 的 1 条签名,按上游手册顺序排列。参数名用斜体,类型用弱化色, 之后是返回类型。说明取自本站手册译文:标「沿用」的借用了另一版的译文,标「EN」的本站暂无译文、按英文原文显示。
-
nextval(regclass) →bigint将序列对象推进到下一个值并返回该值。这是自动完成的:即使多个会话并发地执行nextval,每个会话也会安全地接收到不同的序列值。 如果序列对象是用默认形参创建的,则连续的nextval调用将返回以1开始的连续值。 其他行为可以通过在CREATE SEQUENCE命令中使用适当的参数获得。
演化历史
相邻两个大版本之间的差异,新的在前。版本号链到该版的签名。
-
PostgreSQL 13 ← 12 手册重排
这一跳手册重排了函数表的写法,签名文本整体改写,只记函数的增删,不逐条比较签名。
签名矩阵
每条签名在给出了签名的 18 个版本里的存在情况;方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来,上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同,跨越那一跳的同一条签名会显示成两行。
存在 不存在
同组函数
| 函数 | 签名 | 主签名 | 版本变动 | 最近变更 |
|---|---|---|---|---|
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标志。 | 现存 | |||