문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
스키마 유효성 검사
스키마 검증을 사용하면 허용된 데이터 유형 및 값 범위와 같은 필드에 대한 유효성 검사 규칙을 만들 수 있습니다.
MongoDB는 유연한 스키마 모델을 사용하므로 컬렉션의 문서가 기본적으로 동일한 필드나 데이터 유형을 가질 필요가 없습니다. 애플리케이션 스키마를 설정한 후에는 스키마 유효성 검사를 사용하여 의도하지 않은 스키마 변경이나 부적절한 데이터 유형이 없는지 확인할 수 있습니다.
스키마 유효성 검사를 사용해야 하는 경우
스키마 유효성 검사 요구 사항은 사용자가 애플리케이션을 사용하는 방식에 따라 달라집니다. 애플리케이션이 개발 초기 단계에 있는 경우 데이터를 어떻게 구성해야 할지 모르기 때문에 스키마 검증이 도움이 되지 않는 제한을 부과할 수 있습니다. 특히 컬렉션의 필드는 시간이 지남에 따라 변경될 수 있습니다.
스키마 유효성 검사는 데이터 구성 방법을 잘 알고 있는 기존 애플리케이션에 가장 유용합니다. 다음 시나리오에서 스키마 유효성 검사를 사용할 수 있습니다:
사용자 컬렉션의 경우
password필드가 문자열로만 저장되는지 확인합니다. 이 유효성 검사는 사용자가 암호를 이미지와 같은 예기치 않은 데이터 형식으로 저장하는 것을 방지합니다.판매 컬렉션의 경우
item필드가 스토어에서 판매하는 품목 목록에 속하는지 확인합니다. 이 유효성 검사는 사용자가 판매 데이터를 입력할 때 실수로 품목 이름의 철자를 잘못 입력하는 것을 방지합니다.학생 컬렉션의 경우
gpa필드가 항상 양수인지 확인합니다. 이 유효성 검사를 통해 데이터 입력 중 오류를 방지할 수 있습니다.
MongoDB가 유효성 검사를 하는 경우
컬렉션에 스키마 유효성 검사 규칙을 추가한 후:
모든 문서 삽입은 규칙에 부합해야 합니다.
스키마 유효성 검사 수준은 규칙이 기존 문서 및 문서 업데이트에 적용되는 방식을 정의합니다. 자세한 내용은 기존 문서에 대한 유효성 검사 수준 지정을 참조하세요.
컬렉션에서 스키마 유효성 검사 규칙과 일치하지 않는 문서를 찾으려면 스키마와 일치하지 않는 문서 찾기를 참조하세요.
문서 유효성 검사에 실패하면 어떻게 되나요?
기본적으로 삽입 또는 업데이트 작업으로 인해 잘못된 문서가 생성되면 MongoDB는 작업을 거부하고 문서를 컬렉션에 쓰지 않습니다.
또는 스키마 위반이 발생할 때 잘못된 문서 및 로그 경고를 허용하도록 MongoDB를 구성할 수 있습니다.
자세히 알아보려면 유효하지 않은 문서 처리 방법 선택을 참조하세요.
시작하기
스키마 유효성 검사와 관련된 일반적인 작업은 다음 페이지를 참조하세요:
자세히 알아보기
MongoDB의 유연한 스키마 모델에 대해 알아보려면 데이터 모델링을 참조하세요.