Menu

PostgreSQL ALTER TABLE: 컬럼 추가, 이름 변경, 삭제, 타입 변경

ALTER TABLE은 이미 있는 테이블을 바꿉니다. 컬럼 추가, 이름 변경, 삭제, USING을 쓴 타입 변경, 기본값과 NOT NULL 설정, 제약 조건 추가를 다룹니다.

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

ALTER TABLE은 이미 있는 테이블을 바꿉니다. 가장 많이 쓰는 형태는 ADD COLUMN, RENAME COLUMN ... TO, DROP COLUMN, ALTER COLUMN ... TYPE입니다. 여러 작업을 쉼표로 구분해 한 문장에 넣을 수 있습니다.

기존 행의 plan에는 'free'가, signed_up에는 NULL이 들어갑니다. PostgreSQL 11부터 상수 기본값이 있는 컬럼을 추가해도 테이블을 다시 쓰지 않으므로, 큰 테이블에서도 빠릅니다. clock_timestamp() 같은 휘발성(volatile) 기본값은 여전히 모든 행을 다시 씁니다.

컬럼이나 테이블 이름 바꾸기

이름 변경은 즉시 끝나며 데이터, 인덱스, 제약 조건이 그대로 유지됩니다. 뷰는 테이블 이름이 아니라 내부 id를 참조하므로 계속 동작합니다. 다른 곳에 텍스트로 적힌 이름은 따라 바뀌지 않습니다. PL/pgSQL 함수 본문과 애플리케이션 쿼리는 여전히 옛 이름을 쓰므로, 이름을 바꾸기 전에 검색해 보세요.

컬럼 삭제하기

DROP COLUMN은 컬럼과 그 데이터를 지웁니다. 뷰나 외래 키가 그 컬럼에 의존하면 실패합니다. CASCADE는 그것들도 함께 지우고, IF EXISTS는 컬럼이 이미 없을 때 오류를 건너뜁니다.

이때 PostgreSQL은 테이블을 다시 쓰지 않습니다. 컬럼을 삭제됨으로 표시만 하고, 공간은 행이 업데이트되거나 테이블을 다시 쓸 때 돌아옵니다.

컬럼 타입 바꾸기

ALTER COLUMN ... TYPE은 모든 값을 변환합니다. 이전 타입에서 새 타입으로 자동 캐스트가 없으면, 새 값을 계산하는 식과 함께 USING을 추가합니다.

USING이 없으면 이 문장은 column "price" cannot be cast automatically to type numeric 오류로 실패합니다. 값 하나라도 변환할 수 없으면 문장 전체가 실패하고 테이블은 그대로 남습니다.

대부분의 타입 변경은 테이블을 다시 씁니다. varchar(n)을 더 길게 하거나 varchar를 text로 바꾸는 것처럼 다시 쓰지 않는 경우도 있습니다.

기본값과 NOT NULL 설정하고 없애기

SET NOT NULL은 테이블을 스캔해 NULL이 있는 행이 하나라도 있으면 실패하므로, 먼저 빈 값을 채우세요.

DROP DEFAULT와 DROP NOT NULL은 이를 되돌립니다. 새 기본값은 앞으로의 INSERT에만 적용되며, 기존 행은 값을 유지합니다.

제약 조건 추가하기

ALTER TABLE orders ADD CONSTRAINT total_positive CHECK (total > 0);
ALTER TABLE orders DROP CONSTRAINT total_positive;

CHECK나 외래 키를 추가하면 검증을 위해 테이블 전체를 스캔합니다. 크고 바쁜 테이블에서는 먼저 NOT VALID로 추가하세요. 새 행만 검사합니다. 그다음 ALTER TABLE orders VALIDATE CONSTRAINT total_positive;를 실행합니다. 이 명령은 읽기와 쓰기를 막지 않는 약한 잠금으로 기존 행을 검사합니다. 외래 키 페이지도 같은 방식을 쓰며, ALTER TABLE 레퍼런스에 모든 형태와 잠금이 정리되어 있습니다.

자주 묻는 질문

PostgreSQL에서 컬럼 순서를 바꿀 수 있나요?

없습니다. ALTER TABLE로는 컬럼을 옮길 수 없고, 새 컬럼은 항상 끝에 추가됩니다. SELECT에서 원하는 순서로 컬럼을 나열하거나, 그 순서로 새 테이블을 만들고 데이터를 복사하세요.

PostgreSQL에서 ALTER TABLE은 테이블을 잠그나요?

대부분의 형태가 ACCESS EXCLUSIVE 잠금을 걸며, 문장이 끝날 때까지 읽기와 쓰기를 막습니다. 빠른 변경(이름 변경, 컬럼 삭제, 상수 기본값이 있는 컬럼 추가)은 잠깐만 잠급니다. 테이블을 다시 쓰는 타입 변경은 다시 쓰는 동안 계속 잠급니다.

PostgreSQL에서 컬럼 여러 개를 한 번에 추가하려면 어떻게 하나요?

한 문장 안에서 작업을 쉼표로 구분합니다. ALTER TABLE users ADD COLUMN phone text, ADD COLUMN city text;처럼 씁니다. 한 ALTER TABLE 안의 모든 작업은 잠금 하나로 함께 실행됩니다.

PostgreSQL에서 ALTER TABLE을 롤백할 수 있나요?

네. PostgreSQL의 DDL은 트랜잭션을 지원하므로, BEGIN ... ROLLBACK 안의 ALTER TABLE은 완전히 되돌려집니다.

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

Coddy로 코딩 배우기

시작하기