CREATE SEQUENCE

CREATE SEQUENCE：定义新的序列生成器。

支持的语法

CREATE SEQUENCE [ IF NOT EXISTS ] name CACHE cache
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ [ NO ] CYCLE ]
    [ START [ WITH ] start ]
    [ OWNED BY { table_name.column_name | NONE } ]

where data_type is BIGINT
      and cache = 1 or cache >= 65536

说明

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

如果提供了架构名称，则在指定的架构中创建序列。否则，将在当前架构中创建序列。序列名称必须与同一架构中的任何其它关系（表、序列、索引、视图、实体化视图或外部表）的名称不同。

创建序列后，您可以使用函数 nextval、currval 和 setval 对序列进行操作。序列操作函数中介绍了这些函数。

尽管您无法直接更新序列，但您可以使用如下查询：

SELECT * FROM name;

来检查序列的某些参数和当前状态。尤其是，序列的 last_value 字段显示任何会话分配的最后一个值。（当然，如果其它会话正在积极地进行 nextval 调用，则此值在打印时可能已经过时了。） 可以在 pg_sequences 视图中观察其它参数，例如 increment 和 maxvalue。

参数

备注

使用 DROP SEQUENCE 移除序列。

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

由于 nextval 和 setval 调用从不会回滚，因此，如果需要“无间隙”分配序列号，则无法使用序列对象。

在一次访问序列对象期间，每个会话都会分配和缓存连续的序列值，并相应地增加序列对象的 last_value。然后，在该会话中下一个 cache-1 使用 nextval 时，只返回预分配的值，而不涉及序列对象。因此，当会话结束时，任何已分配但未在该会话中使用的数字都将丢失，从而导致序列中出现“空洞”。

此外，尽管可以保证多个会话分配不同的序列值，但在考虑所有会话时，这些值可能会以非顺序方式生成。例如，如果 cache 设置为 10，则会话 A 可能会保留值 1..10 并返回 nextval=1，然后会话 B 可能会在会话 A 生成 nextval=2 之前保留值 11..20 并返回 nextval=11。因此，如果 cache 设置为 1，则可以安全地假设 nextval 值是按顺序生成的；如果 cache 设置大于 1，则只应假设 nextval 值都是不同的，而不是纯粹按顺序生成的。此外，last_value 将反映任何会话保留的最新值，无论 nextval 是否已返回该值。

另一个注意事项是，在其它会话用完它们已缓存的任何预分配值之前，这些会话将不会注意到对此类序列执行的 setval。

示例

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

CREATE SEQUENCE serial CACHE 65536 START 101;

从此序列中选择下一个数字：

SELECT nextval('serial');

 nextval
---------
     101

从此序列中选择下一个数字：

SELECT nextval('serial');

 nextval
---------
     102

在 INSERT 命令中使用此序列：

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

使用 setval 将序列重置为特定值：

SELECT setval('serial', 200);
SELECT nextval('serial');

 nextval
---------
     201

兼容性

除以下例外情况之外，CREATE SEQUENCE 符合 SQL 标准：