PostgreSQL 序列（SEQUENCE）
阿新 • • 發佈：2019-02-19
一、簡介
序列物件（也叫序列生成器）就是用CREATE SEQUENCE 建立的特殊的單行表。一個序列物件通常用於為行或者表生成唯一的識別符號。
二、建立序列
方法一：直接在表中指定欄位型別為serial 型別
david=# create table tbl_xulie ( david(# id serial, david(# name text); NOTICE: CREATE TABLE will create implicit sequence "tbl_xulie_id_seq" for serial column "tbl_xulie.id" CREATE TABLE david=#
方法二：先建立序列名稱，然後在新建的表中列屬性指定序列就可以了，該列需int 型別
建立序列的語法：
CREATE [ TEMPORARY | TEMP ] SEQUENCE name [ INCREMENT [ BY ] increment ] [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ] [ START [ WITH ] start ] [ CACHE cache ] [ [ NO ] CYCLE ] [ OWNED BY { table.column | NONE }]
例項：
david=# create sequence tbl_xulie2_id_seq increment by 1 minvalue 1 no maxvalue start with 1; CREATE SEQUENCE david=#
david=# create table tbl_xulie2 ( david(# id int4 not null default nextval('tbl_xulie2_id_seq'), david(# name text); CREATE TABLE david=#
三、檢視序列
david=# \d tbl_xulieTable "public.tbl_xulie" Column | Type | Modifiers --------+---------+-------------------------------------------------------- id | integer | not null default nextval('tbl_xulie_id_seq'::regclass) name | text | david=# \d tbl_xulie2 Table "public.tbl_xulie2" Column | Type | Modifiers --------+---------+--------------------------------------------------------- id | integer | not null default nextval('tbl_xulie2_id_seq'::regclass) name | text | david=#
檢視序列屬性
david=# \d tbl_xulie_id_seq Sequence "public.tbl_xulie_id_seq" Column | Type | Value ---------------+---------+--------------------- sequence_name | name | tbl_xulie_id_seq last_value | bigint | 1 start_value | bigint | 1 increment_by | bigint | 1 max_value | bigint | 9223372036854775807 min_value | bigint | 1 cache_value | bigint | 1 log_cnt | bigint | 0 is_cycled | boolean | f is_called | boolean | f Owned by: public.tbl_xulie.id david=#
david=# select * from tbl_xulie2_id_seq; sequence_name | last_value | start_value | increment_by | max_value | min_value | cache_value | log_cnt | is_cycled | is_called -------------------+------------+-------------+--------------+---------------------+-----------+-------------+---------+-----------+----------- tbl_xulie2_id_seq | 1 | 1 | 1 | 9223372036854775807 | 1 | 1 | 0 | f | f (1 row) david=#
四、序列應用
4.1 在INSERT 命令中使用序列
david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+------- 1 | David 2 | Sandy (2 rows) david=#
4.2 資料遷移後更新序列
david=# truncate tbl_xulie; TRUNCATE TABLE david=# david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Eagle'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Miles'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Simon'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Rock'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Peter'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sally'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Nicole'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Monica'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Renee'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+-------- 15 | Sandy 16 | David 17 | Eagle 18 | Miles 19 | Simon 20 | Rock 21 | Peter 22 | Sally 23 | Nicole 24 | Monica 25 | Renee (11 rows) david=# copy tbl_xulie to '/tmp/tbl_xulie.sql'; COPY 11 david=# truncate tbl_xulie; TRUNCATE TABLE david=# alter sequence tbl_xulie_id_seq restart with 100; ALTER SEQUENCE david=# select currval('tbl_xulie_id_seq'); currval --------- 25 (1 row) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 100 (1 row) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 101 (1 row) david=# begin; BEGIN david=# copy tbl_xulie from '/tmp/tbl_xulie.sql'; COPY 11 david=# select setval('tbl_xulie_id_seq', max(id)) from tbl_xulie; setval -------- 25 (1 row) david=# end; COMMIT david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Flash'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+-------- 15 | Sandy 16 | David 17 | Eagle 18 | Miles 19 | Simon 20 | Rock 21 | Peter 22 | Sally 23 | Nicole 24 | Monica 25 | Renee 26 | Flash (12 rows) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 27 (1 row) david=#
五、序列函式
下面序列函式，為我們從序列物件中獲取最新的序列值提供了簡單和併發讀取安全的方法。
| 函式 | 返回型別 | 描述 |
| nextval(regclass) | bigint | 遞增序列物件到它的下一個數值並且返回該值。這個動作是自動完成的。即使多個會話併發執行nextval，每個程序也會安全地收到一個唯一的序列值。 |
| currval(regclass) | bigint | 在當前會話中返回最近一次nextval抓到的該序列的數值。(如果在本會話中從未在該序列上呼叫過 nextval，那麼會報告一個錯誤。)請注意因為此函式返回一個會話範圍的數值，而且也能給出一個可預計的結果，因此可以用於判斷其它會話是否執行過nextval。 |
| lastval() | bigint | 返回當前會話裡最近一次nextval返回的數值。這個函式等效於currval，只是它不用序列名為引數，它抓取當前會話裡面最近一次nextval使用的序列。如果當前會話還沒有呼叫過nextval，那麼呼叫lastval將會報錯。 |
| setval(regclass, bigint) | bigint | 重置序列物件的計數器數值。設定序列的last_value欄位為指定數值並且將其is_called欄位設定為true，表示下一次nextval將在返回數值之前遞增該序列。 |
| setval(regclass, bigint, boolean) | bigint | 重置序列物件的計數器數值。功能等同於上面的setval函式，只是is_called可以設定為true或false。如果將其設定為false，那麼下一次nextval將返回該數值，隨後的nextval才開始遞增該序列。 |
5.1 檢視下一個序列值
david=# select nextval('tbl_xulie_id_seq'); nextval --------- 3 (1 row) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 4 (1 row) david=#
5.2 檢視序列最近使用值
david=# select nextval('tbl_xulie_id_seq'); nextval --------- 4 (1 row) david=# select currval('tbl_xulie_id_seq'); currval --------- 4 (1 row) david=# select currval('tbl_xulie_id_seq'); currval --------- 4 (1 row) david=#
5.3 重置序列
方法一：使用序列函式
a. setval(regclass, bigint)
david=# truncate tbl_xulie; TRUNCATE TABLE david=# select setval('tbl_xulie_id_seq', 1); setval -------- 1 (1 row) david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+------- 2 | Sandy 3 | David (2 rows) david=# select currval('tbl_xulie_id_seq'); currval --------- 3 (1 row) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 4 (1 row) david=#
b. setval(regclass, bigint, boolean)
b.1 setval(regclass, bigint, true)
david=# truncate tbl_xulie; TRUNCATE TABLE david=# select setval('tbl_xulie_id_seq', 1, true); setval -------- 1 (1 row) david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+------- 2 | Sandy 3 | David (2 rows) david=#
效果同a. setval(regclass, bigint)
b.2 setval(regclass, bigint, false)
david=# truncate tbl_xulie; TRUNCATE TABLE david=# select setval('tbl_xulie_id_seq', 1, false); setval -------- 1 (1 row) david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+------- 1 | Sandy 2 | David (2 rows) david=#
方法二：修改序列
修改序列的語法：
ALTER SEQUENCE name [ INCREMENT [ BY ] increment ] [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ] [ START [ WITH ] start ] [ RESTART [ [ WITH ] restart ] ] [ CACHE cache ] [ [ NO ] CYCLE ] [ OWNED BY { table.column | NONE } ] ALTER SEQUENCE name OWNER TO new_owner ALTER SEQUENCE name RENAME TO new_name ALTER SEQUENCE name SET SCHEMA new_schema
例項：
david=# truncate tbl_xulie; TRUNCATE TABLE david=# alter sequence tbl_xulie_id_seq restart with 0; ERROR: RESTART value (0) cannot be less than MINVALUE (1) david=# alter sequence tbl_xulie_id_seq restart with 1; ALTER SEQUENCE david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'David'); INSERT 0 1 david=# insert into tbl_xulie values (nextval('tbl_xulie_id_seq'), 'Sandy'); INSERT 0 1 david=# select * from tbl_xulie; id | name ----+------- 1 | David 2 | Sandy (2 rows) david=# select nextval('tbl_xulie_id_seq'); nextval --------- 3 (1 row) david=#
六、刪除序列
語法：
DROP SEQUENCE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]
當有表字段使用到PG序列時，不能直接刪除。
david=# drop sequence tbl_xulie2_id_seq; ERROR: cannot drop sequence tbl_xulie2_id_seq because other objects depend on it DETAIL: default for table tbl_xulie2 column id depends on sequence tbl_xulie2_id_seq HINT: Use DROP ... CASCADE to drop the dependent objects too. david=# drop table tbl_xulie2; DROP TABLE david=# drop sequence tbl_xulie2_id_seq; DROP SEQUENCE david=#
說明：對於序列是由建表時指定serial 建立的，刪除該表的同時，對應的序列也會被刪除。
七、參考資料