시퀀스(Sequences)

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

주요 기능

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

• 조작 함수

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

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

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

• 캐싱: 시퀀스 값은 CACHE 옵션을 사용해 미리 할당할 수 있으며, 이는 성능 향상에 도움이 됩니다.

제한 사항

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

실제 사용

• 기본 동작: 기본적으로 시퀀스는 1씩 증가하며 1에서 시작합니다.
• 커스텀 동작: 시작점, 증가량, 최소/최대 값, 순환 여부 등을 커스텀하게 지정할 수 있습니다.
• 연관성: 주로 테이블 컬럼과 연결되어 자동 증가 필드로 사용되며, 고유 식별자를 쉽게 관리할 수 있습니다.

사용 예제

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

// 매개변수 없이 시퀀스 생성
export const customSequence = pgSequence("name");

// 매개변수와 함께 시퀀스 생성
export const customSequence = pgSequence("name", {
      startWith: 100,
      maxValue: 10000,
      minValue: 100,
      cycle: true,
      cache: 10,
      increment: 2
});

// 커스텀 스키마에서 시퀀스 생성
export const customSchema = pgSchema('custom_schema');
export const customSequence = customSchema.sequence("name");