// PostgreSQL 오류 참조

PostgreSQL 23P01: 배제 제약 조건 위반

행이 EXCLUDE 제약 조건 하에서 기존 행과 충돌하며, 일반적으로 동일한 방, 자원 또는 사람에 대한 시간 범위가 겹치는 경우입니다.

SQLSTATE
23P01
이름
exclusion_violation
카테고리
무결성 제약 조건 위반
오류 메시지
conflicting key value violates exclusion constraint "bookings_room_during_excl"
DETAIL:  Key (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) conflicts with existing key (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).

의미

배제 제약 조건은 고유성을 일반화한 것입니다: 나열된 모든 비교를 동시에 만족하는 두 개의 행이 있을 수 없습니다. 전형적인 사용은 EXCLUDE USING gist (room_id WITH =, during WITH &&), 즉 같은 방의 두 예약은 기간이 겹칠 수 없다는 뜻입니다.

23P01은 새로 추가되거나 업데이트된 행이 다음에 표시되는 기존 행과 충돌했을 때 나옵니다 DETAIL 줄.

일반적인 원인

  • 이중 예약: 새로운 범위가 동일한 키에 대해 기존 범위와 겹칩니다.
  • 상한을 포함하는 범위([a,b]) 여기에 닿는 항목: [10:00,11:00] 그리고 [11:00,12:00] 에서 겹칩니다. 기본 형식은 반열린 구간 [a,b) 이를 방지합니다.
  • 겹치는 범위를 삽입하는 두 개의 동시 트랜잭션; 첫 번째 트랜잭션이 커밋될 때 두 번째 트랜잭션이 실패합니다.

해결 방법

  1. 쓰기 전에 충돌하는 행을 찾거나, 어떤 예약이 걸리는지 사용자에게 보여주세요.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. 연달아 이어지는 예약이 겹치지 않도록 반개방 범위를 사용하세요.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. 충돌하는 행은 다음으로 건너뜁니다: ON CONFLICT DO NOTHING, 제외 제약조건과는 함께 동작하며(DO UPDATE 않습니다).

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 10:00', '2026-05-01 11:00'))
    ON CONFLICT ON CONSTRAINT bookings_room_during_excl DO NOTHING;

안전하게 재현하세요

그 btree_gist 확장이 있으면 GiST 인덱스가 일반 정수도 =.

CREATE EXTENSION IF NOT EXISTS btree_gist;
CREATE TEMP TABLE b (room int, during tstzrange,
    EXCLUDE USING gist (room WITH =, during WITH &&));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:00', '2026-01-01 11:00'));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:30', '2026-01-01 12:00'));  -- ERROR: conflicting key value violates exclusion constraint

관련 오류

그 밖의 무결성 제약 조건 위반 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.