9.16. 序列操作功能

本节描述了对序列对象进行操作的函数，也称为序列生成器或仅称为序列。序列对象是使用CREATE SEQUENCE创建的特殊单行表。序列对象通常用于为表的行生成唯一的标识符。 Table 9.47中列出的序列函数提供了简单，多用户安全的方法，用于从序列对象中获取连续的序列值。

表 9.47. 序列函数

序列函数要操作的序列由regclass参数指定，该参数只是pg_class系统目录中序列的 OID。但是，您不必手工查找 OID，因为regclass数据类型的 Importing 转换器将为您完成工作。只需编写用单引号引起来的序列名称，使其看起来像 Literals 常量。为了与普通 SQL 名称的处理兼容，除非字符串在序列名称周围包含双引号，否则它将转换为小写。从而：

nextval('foo')      operates on sequence foo
nextval('FOO')      operates on sequence foo
nextval('"Foo"')    operates on sequence Foo

序列名称可以根据需要使用模式限定：

nextval('myschema.foo')     operates on myschema.foo
nextval('"myschema".foo')   same as above
nextval('foo')              searches search path for foo

有关regclass的更多信息，请参见Section 8.19。

nextval('foo'::text)      foo is looked up at runtime

可用的序列函数是：

• nextval

  • 将序列对象前进到下一个值，然后返回该值。这是原子完成的：即使多个会话同时执行nextval，每个会话也将安全地接收不同的序列值。

如果使用默认参数创建了序列对象，则连续nextval调用将返回以 1 开头的连续值。其他行为可以通过使用CREATE SEQUENCE命令中的特殊参数来获得；有关更多信息，请参见其命令参考页面。

此功能需要序列具有USAGE或UPDATE特权。

• currval

  • 返回nextval在当前会话中为此序列最近获取的值。 (如果从未在此会话中为此序列调用nextval，则会报告错误.)由于此方法返回的是会话本地值，因此它提供了一个可预测的答案，即自当前会话以来其他会话是否已执行nextval。

此功能需要序列具有USAGE或SELECT特权。

• lastval

  • 返回当前会话中nextval最近返回的值。此函数与currval相同，不同之处在于，它不引用序列名称作为参数，而是引用当前会话中最近应用于序列nextval的那个序列。如果当前会话中尚未调用nextval，则调用lastval是错误的。

此功能要求最后使用的序列具有USAGE或SELECT特权。

• setval

  • 重置序列对象的计数器值。两参数形式将序列的last_value字段设置为指定值，并将其is_called字段设置为true，这意味着下一个nextval将在返回值之前使序列前进。 currval报告的值也设置为指定值。在三参数形式中，is_called可以设置为true或false。 true与二参数形式的效果相同。如果将其设置为false，则下一个nextval将恰好返回指定值，并且序列前进从下一个nextval开始。此外，在这种情况下，由currval报告的值不会更改。例如，

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返回的结果只是其第二个参数的值。

此功能需要对序列具有UPDATE特权。