Menu

PostgreSQL ENUM 타입 사용법: CREATE TYPE AS ENUM

enum 타입은 CREATE TYPE ... AS ENUM으로 만드는, 순서가 있는 고정된 허용 값 목록입니다. 값 추가와 이름 변경, 목록 조회, 정렬, 그리고 CHECK 제약 조건이 더 나은 경우를 다룹니다.

이 페이지에는 실행 가능한 에디터가 있습니다. 편집하고 실행하면 결과를 바로 볼 수 있습니다.

enum은 선언한 고정 목록에서만 값을 가져오는 데이터 타입입니다. CREATE TYPE name AS ENUM ('a', 'b', 'c')로 만듭니다. 이 타입의 컬럼은 목록에 있는 레이블만 받으며, 알파벳 순이 아니라 선언한 순서로 정렬됩니다.

행은 new, paid, shipped, delivered 순서로 나옵니다. 'lost'처럼 목록에 없는 레이블을 넣으면 invalid input value for enum order_status: "lost" 오류로 실패합니다.

위치로 비교하고 거르기

값에 순서가 있으므로 <, >, BETWEEN은 목록 안의 위치를 비교합니다. "paid 또는 그 이후의 모든 상태"를 조건 하나로 쓸 수 있습니다.

주문 1, 3, 4가 일치합니다. min(status)와 max(status)도 선언한 순서를 따릅니다.

enum 값 목록 보기

enum_range(NULL::type)은 모든 레이블을 배열로 돌려주고, unnest는 이를 행으로 펼칩니다.

enum_first(NULL::mood)와 enum_last(NULL::mood)는 첫 번째와 마지막 레이블을 돌려줍니다. psql에서는 \dT+ mood가 타입과 값을 보여 줍니다.

값 추가하고 이름 바꾸기

ALTER TYPE ... ADD VALUE는 레이블을 끝에 추가하거나, BEFORE나 AFTER로 위치를 정합니다. RENAME VALUE는 레이블을 바꾸며, 그 레이블을 쓰는 모든 행도 따라 바뀝니다. 행은 레이블 텍스트가 아니라 레이블에 대한 참조를 저장하기 때문입니다.

이제 목록은 pending, paid, packed, shipped, delivered입니다. IF NOT EXISTS를 쓰면 이미 있는 레이블을 추가해도 아무 일도 일어나지 않습니다.

PostgreSQL은 값을 삭제하거나 기존 값의 순서를 바꿀 수 없습니다. 대신 새 타입을 만들고, 컬럼을 그 타입으로 변환한 뒤, 이전 타입을 삭제합니다.

CREATE TYPE order_status_new AS ENUM ('pending', 'paid', 'shipped');
UPDATE orders SET status = 'shipped' WHERE status = 'delivered';
ALTER TABLE orders
    ALTER COLUMN status DROP DEFAULT,
    ALTER COLUMN status TYPE order_status_new USING status::text::order_status_new;
DROP TYPE order_status;
ALTER TYPE order_status_new RENAME TO order_status;

기본값의 타입이 이전 enum이므로 먼저 기본값을 삭제합니다. 끝난 뒤 다시 설정하세요.

enum과 CHECK 제약 조건 비교

CHECK 제약 조건이 있는 text 컬럼도 같은 보호를 해 주며, 목록은 일반 ALTER TABLE로 바꿀 수 있습니다.

여기서는 알파벳 순으로 정렬되어 new 다음에 paid가 옵니다.

Enumtext + CHECK
정렬 순서선언한 순서알파벳 순
저장 공간4바이트텍스트 길이
값 삭제새 타입과 컬럼 변환제약 조건 교체
여러 테이블에서 재사용타입 하나제약 조건 반복

상태나 크기처럼 짧고 잘 바뀌지 않으며 순서에 의미가 있는 목록에는 enum을 고르세요. 목록이 자주 바뀌거나 값을 삭제할 일이 있다면 CHECK, 또는 외래 키를 건 조회 테이블을 고르세요. 나머지 세부 사항은 매뉴얼의 enum 장에 있습니다.

자주 묻는 질문

PostgreSQL enum에서 값을 삭제하려면 어떻게 하나요?

ALTER TYPE ... DROP VALUE는 없습니다. 그 값을 뺀 새 enum을 만들고, 그 값을 쓰는 행을 업데이트한 뒤 ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type으로 컬럼을 변환하고, 이전 타입을 삭제합니다.

enum 값은 공간을 얼마나 차지하나요?

레이블 길이와 상관없이 값마다 디스크에서 4바이트를 차지합니다. 레이블은 대소문자를 구분하며 최대 63바이트까지 쓸 수 있습니다.

트랜잭션 안에서 ALTER TYPE ADD VALUE를 쓸 수 있나요?

네, PostgreSQL 12부터 됩니다. 새 값은 그 트랜잭션이 커밋된 뒤에야 쓸 수 있습니다.

enum 컬럼을 텍스트와 비교하려면 어떻게 하나요?

문자열 리터럴은 enum으로 자동 변환되므로 WHERE status = 'paid'는 동작합니다. 텍스트 컬럼이나 파라미터는 status = $1::order_status처럼 캐스트하거나, status::text = $1처럼 텍스트로 비교하세요.

Coddy 프로그래밍 언어 일러스트

Coddy로 코딩 배우기

시작하기