스키마 유효성 검사

개요

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

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

You can define schema validation rules when creating a collection by using driver methods, or you can add them to an existing collection by using the collMod MongoDB command. This guide only describes how to enable schema validation when creating a collection. To learn more about enabling schema validation on existing collections, see collMod in the Server manual.

JSON Schema 유효성 검사

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

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

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

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

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

For a full list of JSON schema object fields, see JSON Schema in the Server manual.

스키마 유효성 검사 구현

CreateCollectionOptions 인스턴스의 스키마 및 관련 옵션을 create_collection() 메서드에 전달하여 스키마 유효성 검사를 구현할 수 있습니다. CreateCollectionOptions::builder() 메서드를 사용하여 CreateCollectionOptions 인스턴스를 빌드할 수 있습니다.

다음 CreateCollectionOptions::builder() 함수를 호출하여 새 컬렉션에 대한 유효성 검사 옵션을 지정합니다.

let validator =
    doc! {
        "$jsonSchema": doc! {
           "bsonType": "object",
           "title": "Answer Value Validation",
           "properties": doc! {
              "answer": doc! {
                 "enum": vec! [ "yes", "no" ],
              }
           }
        }
    };
let validation_opts = CreateCollectionOptions::builder()
    .validator(validator)
    .validation_action(Some(ValidationAction::Error))
    .validation_level(Some(ValidationLevel::Moderate))
    .build();
db.create_collection("survey_answers", validation_opts).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 유효성 검사 지정