Menu

PostgreSQL 외래 키와 ON DELETE CASCADE 사용법

외래 키는 컬럼이 다른 테이블에 있는 값만 받도록 합니다. REFERENCES, ON DELETE CASCADE, SET NULL, RESTRICT, 기존 테이블에 키 추가하기, 인덱스 만들기를 다룹니다.

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

외래 키는 컬럼을 다른 테이블의 기본 키나 고유 컬럼에 묶습니다. PostgreSQL은 그쪽에 일치하는 행이 없는 값을 모두 거부합니다. column type REFERENCES other_table (column)으로 씁니다. 부모 행이 삭제될 때 자식 행을 어떻게 할지는 ON DELETE CASCADE나 ON DELETE SET NULL로 정합니다.

참조되는 컬럼에는 PRIMARY KEY나 UNIQUE 제약 조건이 있어야 합니다. 컬럼 없이 REFERENCES customers라고 쓰면 PostgreSQL은 customers의 기본 키를 씁니다.

위반했을 때의 오류

존재하지 않는 고객의 주문은 거부됩니다.

오류에는 제약 조건 이름 orders_customer_id_fkey가 나옵니다. PostgreSQL이 이름 없는 외래 키에 붙이는 이름입니다. 주문이 남아 있는 고객을 삭제해도 키에 다른 설정이 없다면 같은 식으로 실패합니다.

ON DELETE 옵션

옵션부모 행이 삭제될 때
NO ACTION (기본값)자식 행이 있으면 삭제가 실패
RESTRICT같지만, 검사를 트랜잭션 끝으로 미룰 수 없음
CASCADE자식 행도 삭제
SET NULL자식의 외래 키 컬럼이 NULL이 됨
SET DEFAULT자식의 컬럼이 기본값이 됨

ON UPDATE도 같은 옵션을 받습니다. 부모의 키 값이 바뀔 때 적용되며, 생성된 id를 쓰면 드문 일입니다.

CASCADE는 주문의 품목처럼 부모 없이는 의미가 없는 행에 맞습니다.

chair만 남습니다. CASCADE는 다른 키로도 이어지므로, 삭제 한 번에 여러 테이블의 행이 지워질 수 있습니다.

SET NULL은 자식 행을 남기고 연결만 끊습니다.

Ada는 남고 team_id가 NULL이 됩니다. PostgreSQL 15부터 ON DELETE SET NULL (column)으로 여러 컬럼 키 중 일부 컬럼만 비울 수 있습니다.

기존 테이블에 외래 키 추가하기

ALTER TABLE orders
    ADD CONSTRAINT orders_customer_id_fkey
    FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE;

이 문장은 기존 행을 모두 검사하고, 부모가 없는 행이 있으면 실패합니다. 큰 테이블에서는 새 행만 검사하는 NOT VALID로 키를 추가하세요. 그다음 ALTER TABLE orders VALIDATE CONSTRAINT orders_customer_id_fkey;를 실행하면 쓰기를 막지 않고 기존 행을 검사합니다. 기존 키의 ON DELETE 동작을 바꾸려면 한 ALTER TABLE 안에서 제약 조건을 삭제하고 다시 추가하세요.

외래 키 컬럼에 인덱스 만들기

PostgreSQL은 참조되는 쪽에만 인덱스를 두고, 참조하는 컬럼에는 두지 않습니다. orders.customer_id에 인덱스가 없으면 customers에서 행을 삭제할 때마다 자식을 찾느라 orders 전체를 스캔하고, 고객 한 명의 주문을 가져올 때도 마찬가지입니다.

CREATE INDEX orders_customer_id_idx ON orders (customer_id);

테이블의 외래 키 목록은 pg_constraint를 조회해 봅니다.

이 키를 따라 조인하는 방법은 조인 페이지에서 다루며, 지연 가능한(deferrable) 키를 포함한 전체 규칙은 매뉴얼의 제약 조건 장에 있습니다.

자주 묻는 질문

PostgreSQL은 외래 키에 인덱스를 만들어 주나요?

참조하는 컬럼에는 만들지 않습니다. 참조되는 컬럼은 기본 키나 고유 컬럼이어야 하므로 이미 인덱스가 있습니다. 조인과 부모 테이블의 삭제가 외래 키 컬럼을 검색하므로, 그 컬럼에 직접 인덱스를 만드세요.

PostgreSQL에서 외래 키는 어떻게 삭제하나요?

ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey;를 실행합니다. 이름 없는 외래 키는 table_column_fkey라는 이름이 붙으며, psql에서 \d orders로 정확한 이름을 볼 수 있습니다.

PostgreSQL에서 외래 키 컬럼이 NULL일 수 있나요?

네. 외래 키 컬럼의 NULL은 검사하지 않으므로 그 행에는 부모가 필요 없습니다. 모든 행에 부모가 있어야 한다면 NOT NULL을 추가하세요.

외래 키가 같은 테이블을 참조할 수 있나요?

네. manager_id int REFERENCES employees (id) 같은 컬럼은 같은 테이블의 다른 행을 가리킵니다. 조직도나 댓글 스레드 같은 트리는 이렇게 저장합니다.

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

Coddy로 코딩 배우기

시작하기