트리거는 테이블이 바뀔 때 PostgreSQL이 함수를 자동으로 호출하게 합니다. RETURNS trigger로 선언한 트리거 함수를 먼저 작성하고 연결합니다: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. 대표적인 용도는 updated_at 컬럼을 최신으로 유지하는 것입니다:
게시물 1만 업데이트되었으므로 게시물 1에만 타임스탬프가 있습니다. NEW는 곧 쓰일 행이며, BEFORE 트리거는 이를 바꿀 수 있고 반드시 돌려줘야 합니다. 같은 함수를 updated_at 컬럼이 있는 모든 테이블에 연결할 수 있습니다.
BEFORE, AFTER, INSTEAD OF 차이
| 시점 | 실행 시기 | 주 용도 |
|---|---|---|
BEFORE | 행이 쓰이기 전 | NEW를 바꾸거나 검증하거나, 행을 건너뜀 |
AFTER | 행이 쓰인 후 | 다른 테이블에 쓰기: 감사 로그, 카운터 |
INSTEAD OF | 변경 대신 실행, 뷰에서만 | 뷰를 쓰기 가능하게 만들기 |
FOR EACH ROW는 영향을 받은 행마다 함수를 한 번씩 실행합니다. FOR EACH STATEMENT(기본값)는 바뀐 행이 없어도 문장마다 한 번 실행합니다. 행 트리거에서 NEW에는 새 행(INSERT, UPDATE), OLD에는 이전 행(UPDATE, DELETE)이 들어 있습니다. TG_OP는 트리거를 실행한 작업을, TG_TABLE_NAME은 테이블 이름을 알려 줍니다.
BEFORE 행 트리거의 반환값이 다음 동작을 정합니다. 진행하려면 (바꿨든 아니든) NEW를 돌려주고, 오류 없이 행을 건너뛰려면 NULL을 돌려줍니다. AFTER 트리거의 반환값은 무시되므로 관례상 NULL을 돌려줍니다.
AFTER 트리거로 감사 로그 남기기
감사 테이블에는 INSERT 두 건, 10에서 12로 바뀐 UPDATE, 가격이 20인 상품의 DELETE가 기록됩니다. 삽입에서는 OLD가, 삭제에서는 NEW가 NULL이라서 coalesce를 씁니다. 행 전체를 저장하려면 to_jsonb(OLD)와 to_jsonb(NEW)를 jsonb 컬럼에 넣으세요.
변경을 막거나 건너뛰기
BEFORE 트리거는 RAISE EXCEPTION으로 변경을 거부해 문장을 중단하거나, NULL을 돌려줘 행을 건너뛸 수 있습니다:
DELETE는 draft를 지우고 paid 송장은 조용히 남겼습니다. BEFORE DELETE 트리거는 삭제를 진행하려면 OLD를 돌려줍니다. 대신 문장 전체를 실패시키려면 RETURN NULL을 RAISE EXCEPTION 'invoice % is paid', OLD.id;로 바꾸세요. 조용히 남는 행보다 오류가 디버깅하기 더 쉽습니다.
특정 컬럼이 바뀔 때만 실행하기
UPDATE OF column은 그 컬럼을 설정하는 업데이트에만 트리거를 실행합니다. WHEN 조건이 거짓이면 함수 호출을 건너뜁니다. IS DISTINCT FROM은 NULL을 값으로 취급하므로 NULL로, 또는 NULL에서 바뀌는 경우도 잡아냅니다:
첫 번째 업데이트는 같은 가격을 설정하므로 WHEN이 거짓이고 카운터는 0으로 남습니다. 두 번째는 가격을 바꾸므로 price_changed가 1이 됩니다.
트리거 조회, 비활성화, 삭제하기
-- triggers you created (excludes the ones behind foreign keys)
SELECT tgrelid::regclass AS table_name, tgname
FROM pg_trigger WHERE NOT tgisinternal;
ALTER TABLE products DISABLE TRIGGER products_price;
ALTER TABLE products ENABLE TRIGGER products_price;
DROP TRIGGER products_price ON products;
psql에서는 \d products가 테이블의 트리거를 보여 줍니다. CREATE OR REPLACE TRIGGER는 PostgreSQL 14부터, EXECUTE FUNCTION은 PostgreSQL 11부터 있습니다. 예전 코드는 EXECUTE PROCEDURE라고 쓰는데, 지금도 동작합니다. 자기 테이블에 쓰는 트리거는 자기 자신을 다시 실행할 수 있으니 루프를 막으세요(pg_trigger_depth()가 중첩 단계를 돌려줍니다). 모든 TG_ 변수는 트리거 함수 공식 문서에, PL/pgSQL 자체는 함수와 프로시저에 정리되어 있습니다.
자주 묻는 질문
PostgreSQL 트리거를 함수 없이 실행할 수 있나요?
아니요. CREATE TRIGGER는 항상 RETURNS trigger로 선언된 함수를 호출합니다. 보통 PL/pgSQL로 함수를 먼저 작성한 다음 연결하세요.
같은 테이블의 트리거는 어떤 순서로 실행되나요?
같은 이벤트에 걸린 같은 종류의 트리거는 이름의 알파벳 순서대로 실행됩니다. 순서가 중요하다면 이름 앞에 숫자나 문자를 붙이세요.
트리거에서 오류가 나면 문장이 롤백되나요?
네. 트리거에서 RAISE EXCEPTION 등으로 오류를 내면 그 트리거를 실행한 문장이 중단되고, 세이브포인트로 잡지 않으면 트랜잭션 전체가 중단됩니다.
TRUNCATE에도 트리거가 실행되나요?
행 단위 DELETE 트리거는 실행되지 않습니다. BEFORE TRUNCATE나 AFTER TRUNCATE로 문장 단위 트리거를 만들어 대응하세요.