PostgreSQL7.0手册-用户手册-19. SQL命令-CREATE SEQUENCE
2019-09-08 23:33:26
供稿：网友
CREATE SEQUENCE
名称
CREATE SEQUENCE ― 创建一个新的序列号生成器
语法
CREATE SEQUENCE seqname [ INCREMENT increment ]
[ MINVALUE minvalue ] [ MAXVALUE maxvalue ]
[ START start ] [ CACHE cache ] [ CYCLE ]
输入
seqname
将要创建的序列号名．
increment
INCREMENT increment 子句是可选的．一个正数将生成一个递增的序列，一个负数将生成一个递减的序列．缺省值是一（1）．
minvalue
可选的子句 MINVALUE minvalue 决定一个序列可生成的最小值．缺省分别是递增序列为1递减为-2147483647．
maxvalue
使用可选子句 MAXVALUE maxvalue 决定序列的最大值．缺省的分别是递增为2147483647，递减为-1．
start
可选的 START start 子句 使序列可以从任意位置开始．缺省初始值是递增序列为 minvalue 递减序列为 maxvalue ．
cache
CACHE cache 选项使序列号预分配并且为快速访问存储在内存里面．最小值（也是缺省值）是1（一次只能生成一个值, 也就是说没有缓存）．
CYCLE
可选的 CYCLE 关键字可用于使序列到达最大值（maxvalue）或最小值（minvalue）时可复位并继续下去．如果达到极限，生成的下一个数据将分别是最小值（minvalue）或最大值（maxvalue）．
输出
CREATE
命令成功执行的返回信息．
ERROR: Relation 'seqname' already exists
如果声明的序列已经存在．
ERROR: DefineSequence: MINVALUE (start) can't be >= MAXVALUE (max)
如果声明的初始值超出范围（最大值），返回此信息．
ERROR: DefineSequence: START value (start) can't be < MINVALUE (min)
如果声明的初始值超出范围（最小值），返回此信息．
ERROR: DefineSequence: MINVALUE (min) can't be >= MAXVALUE (max)
如果最小值和最大值不连贯．
描述
CREATE SEQUENCE 将向当前数据库里增加一个新的序列号生成器．包括创建和初始化一个新的名为 seqname 的单行表．生成器将为使用此命令的用户"所有"．
在序列创建后，你可以使用函数 nextval(seqname) 从序列中获得新的数字．函数 currval('seqname') 可用于获取对当前会话中指定序列的上一次 nextval(seqname) 调用返回的数字．函数 setval('seqname', newvalue) 可用于设置指定的序列的当前值．下一次 nextval(seqname) 调用将返回所给的值加上序列增值．
使用象
SELECT * FROM sequence_name;
这样的查询可以获得序列的参数．除了获取最初的参数外，你可以用
SELECT last_value FROM sequence_name;
获得后端分配的最后一个值．你可以使用
底层的锁定用于令多个请求同时调用生成器成为可能．
注意
如果用语序列对象的缓存的设置大于一，而且该对象可能被多个后端同时使用就有可能产生不可预料的结果．每个后端在访问过序列对象并递增序列对象的最后值后，将分配跟在序列值后面"缓存数"．这样，该后端在下面的（缓存数-1）次返回序列值时将使用预分配好的数值，而不对共享对象做任何更新．所以，已经分配但在当前会话中没有使用的数字将会丢失．而且，尽管多个后端保证分配独立的序列值，当考虑所有的后端时该数值却有可能是乱序的．（例如，设置缓存数为10，后端 A 可能保留数值 1..10 并且返回 nextval=1，而后端 B 可能保留数值 11..20 并在后端A生成nextval=2之前返回 nextval=11．）因此，将缓存数设为一可以安全地假设 nextval 的数值是顺序生成的；当缓存数设置大于一，我们只能假设 nextval 值都是独立的，而不能假设它们都是纯粹顺序生成的．同样，last_value 将反映由任何后端保留的最后数值，不管它是不是nextval曾返回过的．
注意
请参考 DROP SEQUENCE 语句来删除序列．
每个后端使用其自身的缓存来存储分配的数字．已分配但当前会话没有使用的数字将丢失，导致序列里面出现"空洞"．
用法
创建一个叫 serial 的递增序列，从101开始：
CREATE SEQUENCE serial START 101;
从此序列中选出下一个数字
SELECT NEXTVAL ('serial');
nextval
-------
114
在一个 INSERT 中使用此序列：
INSERT INTO distributors VALUES (NEXTVAL('serial'),'nothing');
在一个 COPY FROM 后设置序列：
CREATE FUNCTION distributors_id_max() RETURNS INT4
AS 'SELECT max(id) FROM distributors'
LANGUAGE 'sql';
BEGIN;
COPY distributors FROM 'input_file';
SELECT setval('serial', distributors_id_max());
END;
兼容性
SQL92
CREATE SEQUENCE 是 Postgres 语言扩展．在 SQL92 里没有 CREATE SEQUENCE 语句．
