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>