©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
本节描述PostgreSQL用于操作序列对象的函数。序列对象(也叫序列生成器或者就叫序列) 都是用 CREATE SEQUENCECREATE SEQUENCE创建的特殊的单行表。 一个序列对象通常用于为行或者表生成唯一的标识符。在Table 9-39中列出的序列函数为我们 从序列对象中获取后续的序列值提供了简单的、多用户安全的方法。
Table 9-39. 序列函数
| 函数 | 返回类型 | 描述 |
|---|---|---|
currval(regclass) |
bigint | 返回最近一次用nextval获取的指定序列的数值 |
lastval() |
bigint | 返回最近一次用nextval获取任何序列的数值 |
nextval(regclass) |
bigint | 递增序列并返回新值 |
setval(regclass，bigint) |
bigint | S设置序列的当前数值 |
setval(regclass，bigint，boolean) |
bigint | 设置序列的当前数值以及is_called标志 |
用regclass参数指定序列函数操作的序列，它只是序列在 系统表空间的pg_class表里的 OID 。不过，你不需要手工查找 OID ，因为 regclass数据类型的输入转换器会帮你做这件事。只要写出单引号包围的序列名字 即可，因此它看上去像文本常量。要达到和处理普通SQL名字的兼容性， 这个字符串将转换成小写，除非在序列名字周围包含双引号，因此：
nextval('foo') operates on sequencefoo
nextval('FOO') operates on sequencefoo
nextval('"Foo"') operates on sequenceFoo
必要时序列名可以用模式修饰：
nextval('myschema.foo')operates on 操作myschema.foo
nextval('"myschema".foo')same as above同上
nextval('foo') searches search path for 在搜索路径中查foo
见Section 8.16获取有关regclass的更多信息。
Note: 在PostgreSQL8.1之前，序列函数的参数类型是text而不是regclass， 而上面描述的从文本字符串到 OID 值的转换将在每次调用的时候发生。 为了向下兼容，这个机制仍然存在， 但是在内部实际上是在函数调用前隐含地将text转换成regclass实现的
如果你把一个序列函数的参数写成一个无修饰的文本字符串，那么它将变成类型 为regclass的常量。因为这只是一个 OID ，它将跟踪最初标识的序列， 而不管后面是否改名、模式是否变化等等。这种"提前绑定"的行为通常是字段缺省 和视图里面引用序列所需要的。但是有时候你可能想要"推迟绑定"，这个时候序列的引用是在运行时解析的。 要获取推迟绑定的行为，我们可以强制存储为text常量，而不是regclass常量：
nextval('foo'::text) foois looked up at runtime在运行时查找请注意，推迟绑定是PostgreSQL版本 8.1 之前唯一可用的行为， 因此你可能需要在旧的应用程序里如此使用来保留旧有的语义。
当然，序列函数的参数也可以是表达式。如果它是一个文本表达式， 那么隐含的转换将导致运行时的查找。
可用的序列函数有：
nextval 递增序列对象到它的下一个数值并且返回该值。这个动作是自动完成的：
即使多个会话并发运行nextval，
每个进程也会安全地收到一个唯一的序列值。
currval 在当前会话中获取最近一次nextval序列的数值。（如果在本会话中从未在
该序列上调用过nextval，那么会报告一个错误。）请注意，因为此函数返回一个本会话范围的数值，
它也能给出一个可预计的结果，可以判断其它会话是否执行过nextval函数
lastval 返回当前会话里最近一次nextval返回的数值。这个函数等效于currval，
只是它不用序列名作为参数，它获取当前会话里面最近一次nextval使用的序列。
如果当前会话还没有调用过nextval，那么调用lastval是会报错的。
setval 重置序列对象的计数器数值。2个参数的形式设置序列的last_value字段
为声明数值并且将其is_called字段设置为true，
表示下一次nextval
将在返回数值之前递增该序列。currval报告的值也设定为指定的值。
在3个参数形式里，is_called可以设置为
true或false。如果你把它设置为false，
那么下一次nextval将返回这里声明的数值而随后nextval才开始递增该序列。
因此在这种情况下currval报告的值没有改变（这是8.3之前版本的一个变化） 比如，
SELECT setval('foo'， 42); nextval的下一个将返回43
SELECT setval('foo'， 42， true);如上所述
SELECT setval('foo'， 42， false); nextval的下一个将返回42
setval返回的结果就是它的第二个参数的数值。
如果一个序列对象是带着默认参数创建的，那么对它调用nextval将返回从1开始的后续数值。其它的行为可以通过使
用CREATE SEQUENCE的指定参数选项获取；参阅其命令参考页获取更多信息。
Important: 为了避免从同一个序列获取数值的当前事务被阻塞，
nextval操作决不会回滚； 也就是说，一旦一个数值已经被抓走，那么就认为它已经用过了， 即使调用nextval的事务后面又退出了也一样。 这就意味着退出的事务可能在序列赋予的数值中留下"空洞"。setval操作也决不回滚