// PostgreSQL 오류 참조

PostgreSQL 23514: 체크 제약 조건 위반

테이블의 CHECK 제약 조건 또는 도메인의 체크를 행이 실패하여 INSERT 또는 UPDATE가 거부되었습니다.

SQLSTATE
23514
이름
check_violation
카테고리
무결성 제약 조건 위반
오류 메시지
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

의미

A CHECK 제약 조건은 모든 행이 충족해야 하는 조건으로, 예를 들어 qty > 0과 같은 조건입니다. 23514는 새로 추가되거나 업데이트된 행이 조건을 거짓으로 만들었음을 의미합니다. 다음 값으로 평가되는 조건은 NULL 통과하므로 검사가 거부하지 않습니다 NULL 값을 자체적으로 거부하지 않습니다.

메시지에 제약 조건 이름이 나옵니다; \d table_name psql에서나 pg_get_constraintdef 자기 조건이 표시됩니다. 기존에 잘못된 행이 있는 테이블에 체크를 추가하면 같은 방식으로 실패하며, check constraint ... of relation ... is violated by some row.

일반적인 원인

  • 허용 범위나 허용 값 집합을 벗어난 데이터, 예를 들어 음수 수량이나 알 수 없는 상태.
  • 데이터베이스 규칙과 어긋나는 애플리케이션 쪽 검증.
  • 다음을 추가하는 경우 CHECK 이미 이를 어기는 행이 있는 테이블에 제약 조건을 추가한 경우.
  • 다음을 가진 도메인 타입 CHECK (value for domain ... violates check constraint).

해결 방법

  1. 제약 조건의 조건을 읽으세요.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. 기록하려는 데이터가 조건을 충족하도록 수정하세요.

  3. 기존에 잘못된 행이 있는 테이블에 CHECK 제약 조건을 추가하려면 NOT VALID (기존 행이 아니라 새 행에만 적용됨)으로 추가한 뒤 데이터를 정리하고 검증하세요.

    ALTER TABLE orders ADD CONSTRAINT orders_qty_check CHECK (qty > 0) NOT VALID;
    UPDATE orders SET qty = 1 WHERE qty <= 0;
    ALTER TABLE orders VALIDATE CONSTRAINT orders_qty_check;

안전하게 재현하세요

CREATE TEMP TABLE o (qty int CHECK (qty > 0));
INSERT INTO o VALUES (-1);  -- ERROR: new row for relation "o" violates check constraint "o_qty_check"

관련 오류

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

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

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

SQLly에서 PostgreSQL 작업하기

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