# DB02003: 제약 위반

## 이 의미는 무엇인가요?[​](#what-this-means "이 의미는 무엇인가요?으로 직접 링크")

저장하려는 데이터가 데이터베이스 규칙을 위반하고 있습니다. 제약 조건은 어떤 데이터를 저장할 수 있는지에 대한 규칙을 시행하여 데이터 무결성을 보장합니다.

## 일반적인 원인[​](#common-causes "일반적인 원인으로 직접 링크")

* **필수 데이터 결여** — 필수 필드가 비어 있음
* **유효하지 않은 관계** — 존재하지 않는 레코드를 참조
* **데이터 유형 불일치** — 필드에 대한 잘못된 데이터 유형
* **값이 범위를 초과함** — 숫자가 허용된 한계를 초과

## 해결 방법[​](#how-to-fix "해결 방법으로 직접 링크")

### 1. 필수 필드 확인[​](#1-check-required-fields "1. 필수 필드 확인으로 직접 링크")

모든 필수 데이터가 제공되었는지 확인하세요:

* 고객 정보 (필요한 경우)
* 제품 세부정보
* 주문 항목

### 2. 참조 확인[​](#2-verify-references "2. 참조 확인으로 직접 링크")

오류가 관계와 관련된 경우:

* 참조된 제품이 존재하는지 확인
* 고객 ID가 유효한지 확인
* 카테고리 할당 확인

### 3. 데이터 값 검토[​](#3-review-data-values "3. 데이터 값 검토으로 직접 링크")

잘못된 값이 있는지 확인하세요:

* 허용되지 않는 경우 음수 수량
* 한계를 초과하는 가격
* 잘못된 상태 값

### 4. 최신 데이터 동기화[​](#4-sync-latest-data "4. 최신 데이터 동기화으로 직접 링크")

참조된 데이터가 동기화되지 않았을 수 있습니다:

* 서버에서 데이터 새로 고침
* 동기화가 완료될 때까지 대기
* 작업을 다시 시도

### 5. 지우고 다시 시도[​](#5-clear-and-retry "5. 지우고 다시 시도으로 직접 링크")

데이터가 손상된 경우:

1. 문제가 있는 양식을 지웁니다
2. 데이터를 다시 입력합니다
3. 다시 제출합니다

## 일반적인 제약 예[​](#common-constraint-examples "일반적인 제약 예으로 직접 링크")

* **수량은 양수여야 함** — 0 또는 음수 항목을 추가할 수 없음
* **가격은 숫자여야 함** — 가격 필드에 텍스트 사용 불가
* **고객이 존재해야 함** — 존재하지 않는 고객에게 주문을 할당할 수 없음

## 관련 오류[​](#related-errors "관련 오류으로 직접 링크")

* [DB02001](/ko/error-codes/DB02001.md) — 중복 레코드
* [DB03003](/ko/error-codes/DB03003.md) — 필수 필드 누락
