CREATE SEQUENCE

Section: SQL Commands (7)
Updated: 2003-11-02
Index Return to Main Contents
 

NAME

CREATE SEQUENCE - 创建一个新的序列发生器

 

SYNOPSIS

CREATE [ TEMPORARY | TEMP ] SEQUENCE name [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ START [ WITH ] start ] [ CACHE cache ] [ [ NO ] CYCLE ]

 

DESCRIPTION 描述

CREATE SEQUENCE 将向当前数据库里增加一个新的序列号生成器。 包括创建和初始化一个新的名为 name的单行表。生成器将为使用此命令的用户所有。


 如果给出了一个模式名,那么该序列是在指定模式中创建的。 否则它会在当前模式中创建临时序列存在于一个特殊的模式中,因此如果创建一个临时序列的时候, 不能给出模式名。 序列名必需和同一模式中的其他序列,表,索引,或者视图不同。


 在序列创建后,你可以使用函数 nextval, currval, 和 setval 操作序列。这些函数在 ``Sequence-Manipulation Functions'' 中有详细文档。


 尽管你不能直接更新一个序列,但你可以使用象

SELECT * FROM name;


 检查一个序列的参数和当前状态。特别是序列的 last_value 字段显示了任意后端进程分配的最后的数值。 (当然,这些值在被打印出来的时候可能已经过时了 --- 如果其它进程正积极地使用 nextval。)  

PARAMETERS 参数

TEMPORARY or TEMP

 如果声明了这个修饰词,那么该序列对象只为这个会话创建, 并且在会话结束的时候自动删除。在临时序列存在的时候, 同名永久序列是不可见的(在同一会话里),除非它们是用模式修饰的名字引用的。
name

 将要创建的序列号名(可以用模式修饰)。
increment
INCREMENT BY increment 子句是可选的。一个正数将生成一个递增的序列, 一个负数将生成一个递减的序列。缺省值是一(1)。
minvalue
NO MINVALUE

 可选的子句 MINVALUE minvalue  决定一个序列可生成的最小值。 如果没有声明这个子句或者声明了 NO MINVALUE,那么就使用缺省。 缺省分别是递增序列为 1 递减为 -263-1。
maxvalue
NO MAXVALUE

 使用可选子句 MAXVALUE maxvalue  决定序列的最大值。 如果没有声明这个子句或者声明了 NO MAXVALUE,那么就使用缺省。 缺省的分别是递增为 263-1,递减为 -1。
start

 可选的 START WITH start  子句  使序列可以从任意位置开始。缺省初始值是递增序列为 minvalue  递减序列为 maxvalue.
cache
CACHE cache 选项使序列号预分配并且为快速访问存储在内存里面。 最小值(也是缺省值)是1(一次只能生成一个值, 也就是说没有缓存)这也是缺省。
CYCLE
NO CYCLE

 可选的CYCLE关键字可用于使序列到达 最大值(maxvalue) 或 最小值(minvalue)  时可复位并继续下去。如果达到极限,生成的下一个数据将分别是 最小值(minvalue) 或 最大值(maxvalue)。


 如果声明了可选的关键字 NO CYCLE, 那么在序列达到其最大值之后任何对 nextval 的调用都强返回一个错误。 如果既没有声明 CYCLE 也没有声明 NO CYCLE, 那么 NO CYCLE 是缺省。

 

NOTES 注意


 使用 DROP SEQUENCE 语句来删除序列。


 序列是基于 bigint 运算的,因此其范围不能超过八字节的整数范围(-9223372036854775808 到 9223372036854775807)。 在一些老一点的平台上可能没有对八字节整数的编译器支持, 这种情况下序列使用普通的 integer 运算(范围是 -2147483648 到 +2147483647)。


 如果 cache 设置大于一, 并且这个序列对象将被用于并发多会话的场合,那么可能会有不可预料的结果发生。 每个会话在一次访问序列对象的过程中将分配并缓存随后的序列值,并且相应增加序列对象的 last_value。 这样,同一个事务中的随后的 cache-1 次 nextval  将只是返回预先分配的数值,而不用动序列对象。因此,任何在一个会话中分配但是没有使用的数字都将在会话结尾丢失,导致序列里面出现"空洞"。


 另外,尽管系统保证为多个会话分配独立的序列值,但是如果考虑所有会话, 那么这个数值可能会丢失顺序。比如,如果 cache  设置为 10,那么会话 A 保留了 1..10 并且返回 nextval=1, 然后会话 B 可能会保留 11..20 然后在会话 A 生成 nextval=2 之前返回 nextval=11。因此,对于 cache 设置为一的情况,我们可以安全地假设 nextval 值是顺序生成的; 而如果把 cache 设置得大于一, 那么你只能假设 nextval 值总是唯一得,而不是完全顺序地生成。 同样,last_value 将反映任何会话保留的最后的数值,不管它是否曾被 nextval 返回。


 另外一个考虑是在这样的序列上执行的 setval 将不会被其它会话注意到,直到它们用光他们缓存的数值。  

EXAMPLES 例子


 创建一个叫 serial 的递增序列,从101开始:

CREATE SEQUENCE serial START 101;


 从此序列中选出下一个数字:

SELECT nextval('serial');
    
 nextval
---------
     114


 在一个 INSERT 中使用此序列:

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


 在一个 COPY FROM 后更新序列:

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

 

COMPATIBILITY 兼容性

CREATE SEQUENCE 是 PostgreSQL 语言扩展。 在 SQL 标准里没有 CREATE SEQUENCE 语句。  

译者

Postgresql 中文网站 何伟平 <laser@pgsqldb.org>


 

Index

NAME
SYNOPSIS
DESCRIPTION 描述
PARAMETERS 参数
NOTES 注意
EXAMPLES 例子
COMPATIBILITY 兼容性
译者

This document was created by man2html, using the manual pages.
Time: 13:12:50 GMT, December 24, 2015