스키마 유효성 검사

개요

이 가이드에서는 Rust 드라이버를 사용하여 MongoDB 컬렉션에 대한 스키마 유효성 검사 를 구현하는 방법을 배울 수 있습니다.

스키마 유효성 검사를 구현하려면 유효성 검사 규칙 세트로 구성된 JSON schema를 제공해야 합니다. 스키마 유효성 검사를 구현하는 경우 서버는 유효성 검사 규칙을 따르는 쓰기 작업만 실행할 수 있습니다. 스키마 유효성 검사를 사용하여 지정된 컬렉션에 있는 문서 필드의 데이터 유형 및 값 범위를 제한합니다.

컬렉션을 생성할 때 드라이버 메서드를 사용하여 스키마 유효성 검사 규칙을 정의하거나 collMod MongoDB 명령을 사용하여 기존 컬렉션에 추가할 수 있습니다. 이 가이드에서는 컬렉션을 생성할 때 스키마 유효성 검사를 활성화하는 방법에 대해서만 설명합니다. 기존 컬렉션에서 스키마 유효성 검사를 활성화하는 방법에 대해 자세히 알아보려면 MongoDB Server 매뉴얼에서 collMod 를 참조하세요.

JSON Schema 유효성 검사

스키마 유효성 검사 규칙을 사용하여 컬렉션을 만들기 전에 JSON schema를 정의해야 합니다.

JSON schema는 컬렉션에 대한 유효성 검사 규칙을 지정하는 키-값 쌍을 포함하는 JSON 객체입니다. 최상위 수준에서 이 객체에는 $jsonSchema 객체가 포함되어야 합니다. $jsonSchema 객체에는 다음 필드가 포함되어 있습니다.

• title: 스키마에 대한 선택적 설명을 설정합니다.

• 필수: 컬렉션의 각 문서에 대한 필수 필드 목록을 지정합니다.

• 속성: 개별 필드에 대한 속성 요구 사항을 설정합니다.

JSON schema 객체 필드의 전체 목록은 MongoDB Server 매뉴얼의 JSON schema 를 참조하세요.

스키마 유효성 검사 구현

스키마 및 관련 옵션을 CreateCollectionOptions 옵션 빌더 메서드에 전달하여 스키마 유효성 검사 를 구현 수 있습니다.

다음 CreateCollectionOptions 메서드를 호출하여 새 컬렉션 에 대한 유효성 검사 옵션을 지정합니다.

let validator =
    doc! {
        "$jsonSchema": doc! {
           "bsonType": "object",
           "title": "Answer Value Validation",
           "properties": doc! {
              "answer": doc! {
                 "enum": vec! [ "yes", "no" ],
              }
           }
        }
    };
db.create_collection("survey_answers")
    .validator(validator)
    .validation_action(ValidationAction::Error)
    .validation_level(ValidationLevel::Moderate)
    .await?;

{
  "_id": { ... },
  "question": "Do you like to exercise?",
  "answer": "yes"
},
{
  "_id": { ... },
  "question": "Do you like to play computer games?",
  "answer": "no"
}

{
  "_id": { ... },
  "question": "Do you like to exercise?",
  "answer": "depends on my mood"
}

Error: Error { kind: Write(WriteError(WriteError { code: 121, code_name:
None, message: "Document failed validation", details:
Some(Document({"failingDocumentId":
ObjectId("..."), "details":
Document({"operatorName": String("$jsonSchema"), "title": String("Answer
Value Validation"), ... })})) })), ... }

추가 정보

이 페이지에 언급된 MongoDB Server 작업에 대해 자세히 알아보려면 MongoDB Server 매뉴얼에서 다음 문서를 참조하세요.

• collMod 명령에 대한 유효성 검사 작업

• 스키마 유효성 검사

• JSON Schema 유효성 검사 지정