↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 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 / 7.3 / 7.2
历史版本。 PostgreSQL 8.0 已结束支持。 请参阅 当前版本手册.

9.12. 序列操作函数 #

本节描述PostgreSQL中用于操作序列对象(也称为序列生成器,或简称序列)的函数。序列对象是用CREATE SEQUENCE创建的特殊单行表。序列对象通常用于为表中的行生成惟一标识符。在表 9.34中列出的序列函数,提供了简单的、多用户安全方法,用于从序列对象中获取连续的序列值。

表 9.34. 序列函数

FunctionReturn Type描述
nextval(text)bigint推进序列并返回新值
currval(text)bigint返回最近用 nextval 获取的值
setval(text, bigint)bigint设置序列的当前值
setval(text, bigint, boolean)bigint设置序列的当前值和is_called标志

大体上由于历史原因,序列函数调用要操作的序列由一个文本字符串参数指定。为了与普通SQL名称的处理方式达到某种兼容,除非字符串被双引号括起,否则序列函数会把参数转换为小写。因此:

nextval('foo')      操作序列 foo
nextval('FOO')      操作序列 foo
nextval('"Foo"')    操作序列 Foo

必要时,序列名可以带模式限定:

nextval('myschema.foo')     操作 myschema.foo
nextval('"myschema".foo')   同上
nextval('foo')              在搜索路径中查找 foo

当然,文本参数不仅可以是简单的字面量,也可以是表达式的结果,这偶尔会很有用。

可用的序列函数有:

nextval

把序列对象推进到它的下一个值并返回该值。这是以原子方式完成的:即使多个会话并发地执行nextval,每个会话也会安全地获得一个不同的序列值。

currval

返回当前会话中nextval最近一次为该序列获取的值。(如果在本会话中从未对该序列调用过nextval,则会报告错误。)由于返回的是一个会话局部的值,无论其他会话在当前会话之后是否执行过nextval,它都给出可预测的答案。

setval

重置序列对象的计数值。双参数形式把序列的last_value字段设置为指定值,并把其is_called字段设置为true,这意味着下一次nextval将在返回值之前推进序列。在三参数形式中,is_called可以设置为true或false。如果设置为false,下一次nextval将恰好返回指定的值,序列的推进从再下一次nextval开始。例如,

SELECT setval('foo', 42);           Next nextval will return 43
SELECT setval('foo', 42, true);     Same as above
SELECT setval('foo', 42, false);    Next nextval will return 42

setval返回的结果就是其第二个参数的值。

重要

为了避免阻塞从同一序列获取编号的并发事务,nextval操作永远不会被回滚;也就是说,一旦取出了一个值,它就被视为已使用,即使执行nextval的事务随后中止也是如此。这意味着中止的事务可能会在已分配的值序列中留下未使用的“空洞”。setval操作也永远不会被回滚。

如果一个序列对象是用默认参数创建的,那么连续调用nextval将返回从 1 开始的连续值。通过在CREATE SEQUENCE命令中使用特殊参数,可以得到其他行为;更多信息见其命令参考页。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.