UPSERT(INSERT ON CONFLICT)란 무엇인가요?

Question

Accepted Answer

**UPSERT**는 "삽입하되 이미 존재하면 업데이트"를 의미합니다. PostgreSQL은 이를 **`INSERT ... ON CONFLICT`**로 구현합니다 — 행을 삽입하되, 고유 제약조건을 위반하게 되면 대신 기존 행을 업데이트(또는 아무것도 하지 않음)합니다. 흔한 "삽입-또는-업데이트" 필요를 원자적으로 처리합니다.

## UPSERT가 해결하는 문제

```text
행을 삽입하고 싶지만 (고유 키로) 이미 존재할 수 있는 경우:
  ❌ 일반 INSERT는 존재 시 고유 위반 오류로 실패
  ❌ 확인-후-삽입 (SELECT 후 INSERT 또는 UPDATE)은 RACE CONDITION 존재
     (확인과 삽입 사이에 다른 transaction이 삽입할 수 있음)
→ ON CONFLICT는 단일 문장에서 원자적으로 처리 (race condition 없음)
```

## ON CONFLICT DO UPDATE — 삽입 또는 업데이트

```sql
INSERT INTO users (email, name, login_count)
VALUES ('ann@x.com', 'Ann', 1)
ON CONFLICT (email)                  -- 이 email을 가진 행이 이미 존재하면...
DO UPDATE SET                        -- ...대신 업데이트
  name = EXCLUDED.name,              -- EXCLUDED = 삽입하려던 값
  login_count = users.login_count + 1;  -- 기존 행도 참조 가능
```

삽입 시 `email` 고유 제약조건에서 충돌하면 Postgres는 대신 기존 행을 업데이트합니다. **`EXCLUDED`**는 삽입하려던 값을 가리키고, 기존 행(`users.login_count`)도 참조할 수 있습니다 — 카운터 증가 같은 로직을 가능하게 합니다.

## ON CONFLICT DO NOTHING — 삽입 또는 건너뛰기

```sql
INSERT INTO users (email, name) VALUES ('ann@x.com', 'Ann')
ON CONFLICT (email) DO NOTHING;      -- 존재하면 그냥 건너뜀 (오류 없음)
```

`DO NOTHING`은 충돌하는 행을 조용히 건너뜁니다 — 오류 없이 "없으면 삽입"에 유용합니다.

## 흔한 실제 용도: 카운터와 멱등 삽입

```sql
-- 페이지 조회수 추적 — 첫 조회 시 삽입, 이후 조회 시 증가
INSERT INTO page_views (page_id, views) VALUES (5, 1)
ON CONFLICT (page_id) DO UPDATE SET views = page_views.views + 1;
```

## 왜 중요한가

UPSERT(`INSERT ... ON CONFLICT`)는 매우 흔한 "삽입-또는-업데이트" 필요를 깔끔하고 **안전하게** 해결하는 중요하고 실용적으로 가치 있는 PostgreSQL 기능이므로, 이를 이해하는 것은 실제 데이터 작업에 유용합니다.

그 필요 — (고유 키로) 이미 존재할 수 있는 행을 삽입 — 는 끊임없이 발생하며(레코드 업서트, 카운터, 멱등 삽입, 데이터 동기화), 단순한 대안은 문제가 있습니다. 일반 INSERT는 행이 존재하면 오류로 실패하고, 확인-후-삽입 방식(SELECT 후 INSERT-또는-UPDATE)은 **race condition**(동시 transaction이 확인과 삽입 사이에 삽입하여 오류나 손실 업데이트 유발)을 가집니다. `ON CONFLICT`는 이를 **단일 문장에서 원자적으로** 해결합니다 — race condition을 제거하며, 이는 동시성 애플리케이션의 핵심 정확성 이점입니다.

두 형태 모두 이해하면 — **`DO UPDATE`**(삽입 또는 업데이트, `EXCLUDED`가 시도한 값을 참조하고 카운터 증가 같은 로직을 위해 기존 행을 참조하는 능력)와 **`DO NOTHING`**(삽입 또는 조용히 건너뛰기) — 흔한 패턴(레코드 업서트, 멱등 삽입, 카운터/집계 유지)을 다룹니다.

삽입-또는-업데이트는 빈번한 작업이고 이를 올바르고 안전하게(원자적으로, race condition 없이) 수행하는 것은 동시성 애플리케이션의 데이터 무결성에 중요하므로, UPSERT — 무엇을 해결하는지, 원자성/race condition 이점, DO UPDATE/DO NOTHING 형태 — 를 이해하는 것은 그렇지 않으면 오류가 발생하기 쉬운 흔한 필요에 깔끔하고 안전한 해법을 제공하는 가치 있고 자주 적용되는 PostgreSQL 지식이며, 실제 애플리케이션에 실용적이고 중요한 기능입니다.