0Pricing
SQL Academy · 강의

UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)

ON CONFLICT DO UPDATE로 멱등적 삽입을 구현하고 EXCLUDED를 사용하며 적절한 충돌 대상을 선택합니다.

UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)은(는) CoddyKit의 무료 SQL Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 SQL Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

UPSERT란 무엇입니까?

UPSERT는 존재하지 않으면 INSERT하고, 존재하면 UPDATE하는 작업입니다. PostgreSQL에서는 이를 INSERT ... ON CONFLICT로 표현합니다.

ON CONFLICT DO NOTHING

없으면 INSERT하고, 중복이면 조용히 건너뜁니다:

INSERT INTO users (email, full_name)
VALUES ('alice@example.com', 'Alice')
ON CONFLICT (email) DO NOTHING;

ON CONFLICT DO UPDATE

없으면 INSERT하고, 그렇지 않으면 특정 열을 UPDATE합니다:

INSERT INTO users (email, full_name, last_login)
VALUES ('alice@example.com', 'Alice', NOW())
ON CONFLICT (email)
DO UPDATE SET
  full_name  = EXCLUDED.full_name,
  last_login = EXCLUDED.last_login;

EXCLUDED: 제안된 행

DO UPDATE 내부에서 EXCLUDED.col은 "INSERT가 넣으려고 한 값"을 의미합니다. 열 이름만 쓰거나 users.col을 쓰면 기존 행을 의미합니다.

ON CONFLICT (email)
DO UPDATE SET visits = users.visits + 1,
              last_seen = EXCLUDED.last_seen;

충돌 대상

UNIQUE 제약 조건이나 PRIMARY KEY를 지정해야 합니다:

ON CONFLICT (email)             -- column with UNIQUE
ON CONFLICT (user_id, day)      -- composite UNIQUE
ON CONFLICT ON CONSTRAINT users_email_key   -- by name

조건부 UPSERT (DO UPDATE의 WHERE)

조건이 충족될 때만 UPDATE합니다:

INSERT INTO inventory (product_id, qty)
VALUES (42, 5)
ON CONFLICT (product_id)
DO UPDATE SET qty = inventory.qty + EXCLUDED.qty
WHERE inventory.qty + EXCLUDED.qty <= 1000;

다중 행 UPSERT

여러 행을 INSERT하며, 각 행은 개별적으로 처리됩니다:

INSERT INTO page_views (path, day, count)
VALUES ('/home', CURRENT_DATE, 1), ('/about', CURRENT_DATE, 1)
ON CONFLICT (path, day)
DO UPDATE SET count = page_views.count + EXCLUDED.count;

UPSERT와 RETURNING

INSERT되었든 UPDATE되었든 결과 행을 반환합니다:

INSERT INTO users (email, full_name)
VALUES ('alice@example.com', 'Alice')
ON CONFLICT (email) DO UPDATE
  SET full_name = EXCLUDED.full_name
RETURNING id, full_name;

멱등 작업 흐름

UPSERT를 사용하면 재시도해도 안전합니다. 웹훅이 두 번 실행되더라도 두 번째 호출은 중복 행을 만들지 않고 같은 행을 UPDATE합니다.

MERGE (SQL 표준, PG15+)

PostgreSQL 15에서는 SQL 표준인 MERGE가 추가되어 하나의 명령문에서 INSERT, UPDATE, DELETE를 수행할 수 있습니다:

MERGE INTO users AS u
USING (VALUES ('alice@example.com','Alice')) AS src(email, name)
ON u.email = src.email
WHEN MATCHED THEN UPDATE SET full_name = src.name
WHEN NOT MATCHED THEN INSERT (email, full_name) VALUES (src.email, src.name);

UPSERT하지 말아야 할 때

UPSERT에는 UNIQUE 제약 조건이 필요합니다. UNIQUE 제약 조건이 없다면 일반적으로 별도의 SELECT 후 INSERT 또는 UPDATE를 사용해야 합니다. 다만 경쟁 조건에 주의하고, 적절한 잠금과 함께 트랜잭션으로 감싸야 합니다.

요약

ON CONFLICT는 PostgreSQL에서 깔끔하고 원자적인 UPSERT를 구현하는 방법입니다.

  • "없으면 INSERT"에는 DO NOTHING
  • 실제 UPSERT에는 DO UPDATE
  • EXCLUDED = 제안된 행
  • 항상 충돌 대상을 지정합니다

빠른 확인

ON CONFLICT (email) DO UPDATE SET last_login = EXCLUDED.last_login에서 EXCLUDED는 무엇을 가리킵니까?

자주 묻는 질문

“UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)” 강의는 무료인가요?

네 — “UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 SQL Academy 강의 전체를 잠금 해제할 수 있습니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)”에서 뭘 배우나요?

ON CONFLICT DO UPDATE로 멱등적 삽입을 구현하고 EXCLUDED를 사용하며 적절한 충돌 대상을 선택합니다. 브라우저에서 직접 실행하는 실습 코드로 SQL Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

SQL Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 SQL Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 SQL Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 SQL Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 여러 행을 한 번에 INSERT
  2. UPSERT: ON CONFLICT DO UPDATE(PostgreSQL)
  3. FROM과 JOIN 방식의 UPDATE
  4. USING을 사용한 DELETE와 안전한 패턴
← SQL Academy(으)로 돌아가기