CREATE SEQUENCE

CREATE SEQUENCE - 새 시퀀스 생성기를 정의합니다.

지원되는 구문

CREATE SEQUENCE [ IF NOT EXISTS ] name CACHE cache
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ [ NO ] CYCLE ]
    [ START [ WITH ] start ]
    [ OWNED BY { table_name.column_name | NONE } ]

where data_type is BIGINT
      and cache = 1 or cache >= 65536

설명

CREATE SEQUENCE는 새 시퀀스 번호 생성기를 생성합니다. 여기에는 이름이 name인 새 특수 단일 행 테이블을 생성하고 초기화하는 작업이 포함됩니다. 명령을 실행하는 사용자가 생성기를 소유합니다.

스키마 이름이 제공되면 지정된 스키마에 시퀀스가 ​​생성됩니다. 그러지 않으면 현재 스키마에서 생성됩니다. 시퀀스 이름은 동일한 스키마 내의 다른 관계(테이블, 시퀀스, 인덱스, 뷰, 구체화된 뷰 또는 외부 테이블)의 이름과 달라야 합니다.

시퀀스가 생성되면 함수 nextval, currval 및 setval을 사용하여 시퀀스에서 작업합니다. 이러한 함수는 시퀀스 조작 함수에 설명되어 있습니다.

시퀀스를 직접 업데이트할 수는 없지만 다음과 같은 쿼리를 사용할 수 있습니다.

SELECT * FROM name;

시퀀스의 일부 파라미터와 현재 상태를 검사합니다. 특히 시퀀스의 last_value 필드에는 세션에서 할당한 마지막 값이 표시됩니다. (물론 다른 세션이 적극적으로 nextval 직접 호출을 수행하는 경우 이 값은 출력되는 시점에 더 이상 사용되지 않을 수 있습니다.) pg_sequences 뷰에서 increment 및 maxvalue와 같은 다른 파라미터를 관찰할 수 있습니다.

파라미터

참고

DROP SEQUENCE를 사용하여 시퀀스를 제거합니다.

시퀀스는 bigint 산술을 기반으로 하므로 범위는 8바이트 정수(-9,223,372,036,854,775,808~9,223,372,036,854,775,807)의 범위를 초과할 수 없습니다.

nextval 및 setval 직접 호출은 롤백되지 않으므로 시퀀스 번호의 ‘간격 없는’ 할당이 필요한 경우 시퀀스 객체를 사용할 수 없습니다.

각 세션은 시퀀스 객체에 대한 한 번의 액세스 중에 연속 시퀀스 값을 할당 및 캐싱하고 그에 따라 시퀀스 객체의 last_value를 늘립니다. 그런 다음 해당 세션 내에서 다음번에 nextval을 cache-1번 사용하면 시퀀스 객체를 터치하지 않고 미리 할당된 값을 반환하기만 합니다. 따라서 세션 내에서 할당되었지만 사용되지 않은 모든 숫자는 해당 세션이 종료될 때 손실되어 시퀀스에서 '구멍'이 됩니다.

또한 여러 세션이 고유한 시퀀스 값을 할당하도록 보장되지만 모든 세션이 고려되면 값이 시퀀스를 벗어나 생성될 수 있습니다. 예를 들어 cache 설정이 10인 경우 세션 A가 값 1..10을 예약하고 nextval=1을 반환한 다음, 세션 B는 세션 A가 nextval=2를 생성하기 전에 값 11..20을 예약하고 nextval=11을 반환할 수 있습니다. 따라서 cache 설정이 1이면 nextval 값이 순차적으로 생성된다고 가정하는 것이 안전합니다. cache 설정이 1보다 크면 nextval 값이 순차적으로만 생성되지 않고 모두 고유하다고 가정해야 합니다. 또한 last_value는 nextval에서 아직 반환했는지 여부에 관계없이 모든 세션에서 예약한 최신 값을 반영합니다.

또 다른 고려 사항은 이러한 시퀀스에서 실행된 setval은 캐싱된 미리 할당된 값을 모두 사용할 때까지 다른 세션에서 인식되지 않는다는 것입니다.

예제

101부터 시작하여 serial이라는 오름차순 시퀀스를 생성합니다.

CREATE SEQUENCE serial CACHE 65536 START 101;

이 시퀀스에서 다음 번호를 선택합니다.

SELECT nextval('serial');

 nextval
---------
     101

이 시퀀스에서 다음 번호를 선택합니다.

SELECT nextval('serial');

 nextval
---------
     102

INSERT 명령에서 이 시퀀스를 사용합니다.

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

setval을 사용하여 시퀀스를 특정 값으로 재설정합니다.

SELECT setval('serial', 200);
SELECT nextval('serial');

 nextval
---------
     201

호환성

CREATE SEQUENCE는 SQL 표준을 준수합니다. 단, 다음은 예외입니다.