描述

CREATE SEQUENCE创建一个新的序列号发生器。这会创建并 初始化一个名为name的特殊单行表。该发生器归发出该命令 的用户所有。

如果给定了模式名，则序列会在指定模式中创建。否则，它会在当前模式中 创建。临时序列存在于一个特殊模式中，因此创建临时序列时不能指定模式 名。序列名必须不同于同一模式中任何其他关系（表、序列、索引、视图、 物化视图或外部表）的名称。

创建序列后，可以使用函数 nextval、 currval以及 setval来操作该序列。这些函数的文档见 第 9.15 节。

虽然不能直接更新序列，但可以使用如下查询：

SELECT * FROM name;

来查看序列的参数和当前状态。特别是，序列的 last_value字段会显示任一会话最近分配的值。（当然， 如果其他会话正在调用nextval，那么到该值被打印出来 时，它可能已经过时。）

参数

注解

使用DROP SEQUENCE删除序列。

序列基于bigint算术，因此其范围不能超过八字节整数的范围 （-9223372036854775808 到 9223372036854775807）。

如果对一个将由多个会话并发使用的序列对象设置了大于 1 的cache，则可能得到意想不到的结果。 每个会话会在一次访问该序列对象时分配并缓存连续的序列值，并相应增加 该序列对象的last_value。随后，该会话中接下来的 cache-1 次nextval 调用会直接返回预分配的值，而不接触序列对象。因此，任何在会话中已分配 但未使用的数字都会在会话结束时丢失，从而在序列中造成“空洞”。

此外，虽然多个会话保证会分配到互不相同的序列值，但从所有会话整体来看， 这些值的生成顺序可能会乱序。例如，当cache设置为 10 时，会话 A 可能保留值 1..10 并返回nextval=1；然后会话 B 可能保留值 11..20 并返回nextval=11，而此时会话 A 尚未生成 nextval=2。因此，当cache设置为 1 时，可以安全地假定 nextval值按顺序生成；当cache设置大于 1 时，只应假定 nextval值彼此不同，而不应假定它们严格按顺序生成。 此外，last_value会反映任一会话最近保留的值，不管该值 是否已经由nextval返回。

另一个需要注意的问题是，在这种序列上执行的setval 不会立刻被其他会话察觉，直到它们用完自己缓存的所有预分配值为止。

示例

创建一个名为serial的升序序列，从 101 开始：

CREATE SEQUENCE serial START 101;

从该序列中取出下一个数字：

SELECT nextval('serial');

 nextval
---------
     101

从该序列中取出下一个数字：

SELECT nextval('serial');

 nextval
---------
     102

在INSERT命令中使用该序列：

INSERT INTO distributors VALUES (nextval('serial'), 'nothing');

在一次COPY FROM之后更新序列值：

BEGIN;
COPY distributors FROM 'input_file';
SELECT setval('serial', max(id)) FROM distributors;
END;

兼容性

CREATE SEQUENCE符合SQL 标准，但下列情况除外：

另见