pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
本节描述PostgreSQL中用于操作序列对象（也称为序列生成器，或简称序列）的函数。 序列对象是用CREATE SEQUENCE创建的特殊单行表。 序列对象通常用于为表中的行生成惟一标识符。在表 9.34中列出的序列函数，提供了简单的、多用户安全方法，用于从序列对象中获取连续的序列值。
表 9.34. 序列函数
| 函数 | 返回类型 | 描述 |
|---|---|---|
|
bigint |
推进序列并返回新值 |
|
bigint |
返回最近一次用nextval获取的值 |
|
bigint |
设置序列的当前值 |
|
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); 下一次 nextval 将返回 43
SELECT setval('foo', 42, true); 与上面相同
SELECT setval('foo', 42, false); 下一次 nextval 将返回 42
setval 返回的结果只是其 第二个参数的值。
为了避免阻塞从同一序列获取编号的并发事务，nextval操作永远不会被回滚；也就是说，一旦取出了一个值，它就被视为已使用，即使执行nextval的事务随后中止也是如此。这意味着中止的事务可能会在已分配的值序列中留下未使用的“空洞”。setval操作也永远不会被回滚。
如果一个序列对象是用默认参数创建的，那么连续调用nextval将返回从 1 开始的连续值。通过在CREATE SEQUENCE命令中使用特殊参数，可以得到其他行为；更多信息见其命令参考页。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。