Sequences

PostgreSQL의 시퀀스(Sequence)는 고유 식별자를 생성하기 위해 만들어진 특수한 단일 행 테이블로, 주로 자동 증가하는 기본 키 값에 사용됩니다. 여러 세션에서 고유한 순차 값을 생성하는 스레드 안전한 방법을 제공합니다.

주요 기능

• 생성 및 초기화: CREATE SEQUENCE를 사용하여 새 시퀀스를 생성합니다. 증가 값, 시작 값, 최소/최대 값, 캐시 크기와 같은 매개변수를 지정할 수 있습니다.

• 조작 함수

  • nextval('sequence_name'): 시퀀스를 진행시키고 다음 값을 반환합니다.
  • currval('sequence_name'): 현재 세션의 시퀀스 현재 값을 반환합니다.
  • setval('sequence_name', value): 시퀀스의 현재 값을 설정합니다.
  • lastval(): 현재 세션에서 nextval이 반환한 마지막 값을 반환합니다.

• 소유권: OWNED BY 절을 사용하여 시퀀스를 테이블 컬럼에 연결할 수 있습니다. 테이블이나 컬럼을 삭제하면 연결된 시퀀스도 자동으로 삭제됩니다.

• 순환: CYCLE 옵션을 사용하여 시퀀스가 최대값 또는 최소값에 도달했을 때 순환하도록 설정할 수 있습니다. 기본값은 NO CYCLE입니다.

• 캐싱: CACHE 옵션을 사용하여 성능 향상을 위해 시퀀스 값을 미리 할당할 수 있습니다.

제한사항

• 간격: 시퀀스는 연속적이지 않습니다. 중단된 트랜잭션이나 충돌로 인해 시퀀스 값에 간격이 생길 수 있습니다.
• 동시성: 시퀀스는 세션 간 고유한 값을 제공하지만, 모든 세션을 고려할 때 값이 순서대로 나오지 않을 수 있습니다.
• 롤백 불가: 트랜잭션이 실패해도 시퀀스의 변경사항은 롤백되지 않습니다. 이는 고유한 값을 보장하지만 간격이 생길 수 있습니다.
• 충돌 복구: 로그되지 않은 시퀀스나 충돌 이전에 수정된 시퀀스는 이전 상태로 제대로 복원되지 않을 수 있습니다.

실제 사용

• 기본 동작: 기본적으로 시퀀스는 1씩 증가하고 1부터 시작합니다.
• 사용자 정의 동작: 사용자 정의 시작점, 증가값, 최소/최대 값, 순환을 지정할 수 있습니다.
• 연결: 일반적으로 자동 증가 필드를 위해 테이블 컬럼과 연결되어 고유 식별자 관리를 원활하게 합니다.

사용 예제

import { pgSchema, pgSequence } from "drizzle-orm/pg-core";

// No params specified
export const customSequence = pgSequence("name");

// Sequence with params
export const customSequence = pgSequence("name", {
      startWith: 100,
      maxValue: 10000,
      minValue: 100,
      cycle: true,
      cache: 10,
      increment: 2
});

// Sequence in custom schema
export const customSchema = pgSchema('custom_schema');
export const customSequence = customSchema.sequence("name");