本节介绍用于操作序列对象(也称为序列生成器或简称序列)的函数。序列对象是使用 CREATE SEQUENCE 创建的特殊单行表。序列对象通常用于为表中的行生成唯一标识符。序列函数(列于 表 9.55 中)提供简单、多用户安全的从序列对象获取连续序列值的方法。
表 9.55. 序列函数
函数 描述 |
---|
将序列对象推进到下一个值并返回该值。这是原子操作:即使多个会话并发执行 此函数需要序列的 |
设置序列对象的当前值,以及可选的 SELECT setval('myseq', 42); Next
此函数需要序列的 |
返回当前会话中此序列的 此函数需要序列的 |
返回当前会话中 此函数需要最后使用的序列的 |
为了避免阻塞从同一序列获取数字的并发事务,如果调用事务稍后中止, nextval
获取的值不会被收回重用。这意味着事务中止或数据库崩溃可能导致分配值序列中出现间隙。没有事务中止也可能发生这种情况。例如,带有 ON CONFLICT
子句的 INSERT
将在检测到任何导致其遵循 ON CONFLICT
规则的冲突之前,计算要插入的元组,包括执行任何必需的 nextval
调用。因此, PostgreSQL 序列对象不能用于获取“无间隙”序列。
同样, setval
对序列状态所做的更改会立即对其他事务可见,并且如果调用事务回滚,则不会撤销。
如果在提交包含 nextval
或 setval
调用的事务之前数据库集群崩溃,则序列状态更改可能尚未写入持久存储,因此在集群重启后序列具有原始状态还是更新状态是不确定的。这对于在数据库中使用序列是无害的,因为未提交事务的其他影响也同样不可见。但是,如果您希望将序列值用于数据库之外的持久目的,请确保在这样做之前已提交 nextval
调用。
要由序列函数操作的序列由 regclass
参数指定,该参数只是 pg_class
系统目录中序列的 OID。但是,您不必手动查找 OID,因为 regclass
数据类型的输入转换器会为您完成这项工作。有关详细信息,请参阅 第 8.19 节。
如果您在文档中发现任何不正确之处、与您在使用特定功能时的实际体验不符之处或需要进一步说明之处,请使用 此表单 报告文档问题。