| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
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 } ]
CREATE SEQUENCE는 새로운 시퀀스번호 생성기를 생성합니다. 이것은 name 이름으로 된, 새로운 특별한 단일 행 테이블을 생성하고 초기화하는 것을 포함합니다. 생성기는 이 커멘드를 발행하는 사용자가 소유합니다.
스키마명이 제시된 경우, 시퀀스는 지정된 스키마에서 생성됩니다. 스키마명이 제시되지 않은 경우, 시퀀스는 현재의 스키마에서 생성됩니다. 임시 시퀀스는 특별한 스키마에서 존재하므로, 임시 시퀀스가 생성될 시에 스키마명이 제시되지 않을 수 있습니다. 시퀀스명은 다른 시퀀스, 테이블, 인덱스의 이름 또는 동일 스키마 내의 뷰 이름과 달라야 합니다.
시퀀스가 생성된 후, 시퀀스 연산을 위해 nextval, currval, 및 setval함수를 사용하세요.
이들 함수는 Section 9.12에 문서화되어 있습니다.
시퀀스를 직접 갱신할 수는 없어도, 쿼리를 사용할 수 있습니다.
SELECT * FROM name ;
시퀀스의 현재 상태와 매개변수를 검증 하려면, 다음과 같이 합니다.
특히 시퀀스의 last_value부분은 세션에 의해 할당된 마지막 값을 보여줍니다.
(물론, 다른 세션이 nextval호출을 시행하고 있는 경우, 출력될 쯤에 이 값은 무용지물이 될 수 있습니다.)
지정된 경우, 시퀀스 객체는 이 세션을 위해 생성되고, 자동적으로 세션 종료상에서 삭제됩니다. 검증을 거친 스키마명을 참조하지 않는 한, 임시 시퀀스가 존재하는 동안에 동일한 이름을 가진, 기존의 항구적인 시퀀스는 가시화되지 않습니다.(이 세션에서)
생성하는 시퀀스의 이름(검증을 거친 스키마)입니다.
값을 지정하는 옵션 절INCREMENT BY increment 은, 새로운 값을 생성하기 위해 현재의 시퀀스 값에 추가됩니다. 양의 값은 오름차순 시퀀스를 생성하고, 음의 값은 내림차순 시퀀스를 생성합니다. 디폴트 값은 1입니다.
최소값을 결졍하는 옵션절MINVALUE minvalue 은, 시퀀스를 생성할 수 있습니다. 이 절이 제시되지 않거나 NO MINVALUE이 지정되지 않는 경우, 디폴트가 사용됩니다. 디폴트는 오름차순 시퀀스와 내림차순 시퀀스의 각각 1 및 -263-1입니다.
MAXVALUE maxvalue 옵션절은, 시퀀스의 최대값을 결정합니다. 이 절이 제시되지 않거나, NO MAXVALUE이 지정되지 않은 경우, 디폴트 값이 사용됩니다. 디폴트는 오름차순 시퀀스 및 내림차순 시퀀스의 각각 263-1 및 -1입니다.
START WITH start 옵션 절을 사용하면, 어디서에서나 시퀀스를 시작할 수 있습니다. 시작 값의 디폴트는, 오름차순 시퀀스의 minvalue 및 내림차순 시퀀스의 maxvalue 입니다.
시퀀스 번호를 지정하는 옵션절 CACHE cache 은, 보다 빠른 엑세스의 메모리에 사전할당되고 저장됩니다. 최소값은 1(한번에 1개의 값만이 생성됩니다, 즉, no cache)이고 이것 또한 디폴트 입니다.
CYCLE옵션은, maxvalue 또는 minvalue 시퀀스가 각각 오름차순 또는 내림차순 시퀀스로 도달할 시, 랩어라운드하는 것을 허용합니다. 최소치 또는 최대치에 도달하는 경우, 생성된 다음 숫자는 각각 minvalue 또는 maxvalue 가 됩니다.
NO CYCLE이 지정된 경우, 시퀀스가 최대값에 도달한 후에, 모든 nextval호출은 에러를 반환합니다.
CYCLE 또는 NO CYCLE 둘 다 지정되지 않은 경우, NO CYCLE가 디폴트가 됩니다.
OWNED BY옵션은 특정한 테이블의 열과 연관된 시퀀스를 생성합니다. 그러한 열(또는 열의 테이블)이 삭제되는 경우, 시퀀스 또한 자동적으로 삭제됩니다. 지정된 테이블은, 시퀀스처럼 같은 스키마 내에 있어야 하며, 같은 소유자가 소유해야 합니다. 디폴트 OWNED BY NONE는 이와같은 연관성이 없음을 지정합니다.
시퀀스를 삭제하기 위해 DROP SEQUENCE를 사용합니다.
bigint계산에 기초한 시퀀스입니다. 따라서 범위는, 8바이트 정수의 범위 (-9223372036854775808 to 9223372036854775807)를 초과할 수 없습니다. 오래된 플랫폼상에서, 8바이트 정수의 컴파일러는 지원되지 않을 수 있습니다. 이 경우, 시퀀스는 통상 integer계산을 사용합니다. (범위는 -2147483648 에서 +2147483647 )
1보다 큰
cache
설정이, 2개이상의 세션에 동시에 사용되는 시퀀스 객체에사용되는 경우, 예기치 않은 결과를 얻을 수 있습니다.
각각의 세션은, 한 세션이 시퀀스 객체에 접근하고, 시퀀스 객체의 last_value를 적절히 증가시키는 동안, 연속적인 시퀀스 값을 할당하고 캐쉬합니다.
세션 내 nextval의
cache
-1다음의 사용은, 시퀀스 객체를 사용하지 않고, 사전할당된 값을 반환합니다.
따라서, 시퀀스에 "holes"의 결과를 가져오는 세션이 종료될 시, 세션 내에서 사용되지 않은 할당된 모든 번호를 잃게 됩니다.
더욱이, 각각 다른 시퀀스 값을 할당하기 위해 2개 이상의 세션이 보장될 지라도, 모든 세션이 고려될 시, be generated out of값은 생성될 수 있습니다.
예를들면, 10의
cache
이 설정된 세션A는 1부터 10까지의 값을 지정하고, nextval=1를 반환합니다.
세션B는 11부터 20까지의 값을 지정하고, 세션A가 nextval=2를 생성하기 전에 nextval=11를 반환합니다.
그러므로, 1의
cache
설정은 nextval값이 순차적으로 생성한다는 것을 추측합니다.
1보다 큰
cache
로 nextval값이 모두 다르고, 순차적으로 생성되지 않는다는 것을 추측해야 합니다.
또한, last_value는 nextval이 값을 반환했는지 반환하지 않았는지, 아무 세션이 지정한 최근의 값을 반영합니다.
또 다른 고려사항은, 이러한 시퀀스에서 실행된 setval가, 캐쉬했던 모든 사전할당 값이 소모될 때까지 다른 세션에 의해 주의되지 않는다는 것입니다.
101에서 시작하여, serial라는 시퀀스의 오름차순 시퀀스를 생성합니다.
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;