기존 문서에 대한 유효성 검사 수준 지정

유효성 유효성 검사 moderate 유효성 검사 규칙을 지정합니다.

moderate validationLevel을 사용하여 movies 컬렉션에 유효성 검사기를 추가합니다.

db.runCommand( {   collMod: "movies",   validator: { $jsonSchema: {      bsonType: "object",      required: [ "title" ],      properties: {         title: {            bsonType: "string",            description: "title must be a string and is required"         }      }   } },   validationLevel: "moderate"} )

validationLevel가 moderate이기 때문에 MongoDB는 모든 문서 삽입에 대해 유효성 검사 규칙을 적용하고, 이미 규칙을 충족하는 기존 문서의 업데이트에 대해서도 적용합니다.

Insert a valid document.

다음 insert 명령은 string 값을 가진 title 필드가 포함된 문서를 추가하며, 이는 유효성 검사 규칙을 충족합니다.

db.movies.insertOne(   { title: "Wings", year: 1927 })

결과를 관찰합니다.

문서가 유효성 검사 규칙을 충족하므로 삽입이 성공합니다. MongoDB는 다음과 유사한 출력을 반환합니다.

{  acknowledged: true,  insertedId: ...}

유효성 유효성 검사 strict 유효성 검사 규칙을 지정합니다.

strict validationLevel을 사용하여 movies 컬렉션에 유효성 검사기를 추가합니다.

db.runCommand( {   collMod: "movies",   validator: { $jsonSchema: {      bsonType: "object",      required: [ "title" ],      properties: {         title: {            bsonType: "string",            description: "title must be a string and is required"         }      }   } },   validationLevel: "strict"} )

validationLevel가 strict이기 때문에 MongoDB는 모든 문서 삽입 및 업데이트에 유효성 검사 규칙을 적용합니다.

Insert a valid document.

다음 insert 명령은 string 값을 가진 title 필드가 포함된 문서를 추가하며, 이는 유효성 검사 규칙을 충족합니다.

db.movies.insertOne(   { title: "The Conversation", year: 1974 })

결과를 관찰합니다.

문서가 유효성 검사 규칙을 충족하므로 삽입이 성공합니다. MongoDB는 다음과 유사한 출력을 반환합니다.

{  acknowledged: true,  insertedId: ...}

(조건부) validationLevel을(를) strict(으)로 설정합니다.

컬렉션의 validationLevel이 이미 strict이 아니라면, 다음 절차를 수행하세요. 엄격한 유효성 검사 지정

constraint 수준에 맞게 컬렉션을 준비합니다.

prepareConstraintValidationLevel을(를) true(으)로 설정하고 collMod을(를) 실행합니다.

db.runCommand( {   collMod: "movies",   prepareConstraintValidationLevel: true} )

이 명령은 bypassDocumentValidation을 차단하고 유효성 검사기에 대한 변경을 방지하여 업그레이드를 위해 컬렉션을 준비합니다. MongoDB가 우회를 제한하는 방법을 알아보려면 스키마 유효성 검사 우회를 참조하세요.

유효성 검사 수준을 constraint으로 설정합니다.

validationLevel을(를) constraint(으)로 설정하려면 collMod을(를) 실행하세요. validationAction은(는) error 또는 errorAndLog이어야 합니다.

db.runCommand( {   collMod: "movies",   validationLevel: "constraint",   validationAction: "error"} )

validationLevel를 constraint(으)로 업그레이드하는 동일한 collMod 작업에서는 validator을(를) 변경할 수 없습니다. 이 명령을 실행하기 전에 유효성 검사 규칙을 설정합니다. 나중에 규칙을 변경하려면 수준을 strict(으)로 다운그레이드하고, 규칙을 수정한 다음, 다시 constraint(으)로 업그레이드하십시오.

validationLevel이(가) constraint이므로 MongoDB는 업그레이드 전에 기존 문서가 규칙을 충족했는지 여부에 관계없이 모든 문서 삽입 및 업데이트에 유효성 검사 규칙을 적용합니다.

레벨을 constraint으로 설정하면 MongoDB는 컬렉션의 모든 기존 문서를 스캔하고 문서가 유효성 검사기를 위반하는 경우 collMod 작업에 실패합니다. 이 스캔은 대규모 컬렉션의 경우 계산 비용이 많이 들 수 있습니다. 작업이 실패하면 계속하기 전에 유효성 검사기를 통과하도록 위반 문서를 업데이트하세요.

Insert a valid document.

다음 insert 명령은 string 값을 가진 title 필드가 포함된 문서를 추가하며, 이는 유효성 검사 규칙을 충족합니다.

db.movies.insertOne(   { title: "Sunrise", year: 1927 })

결과를 관찰합니다.

문서가 유효성 검사 규칙을 충족하므로 삽입이 성공합니다. MongoDB는 다음과 유사한 출력을 반환합니다.

{  acknowledged: true,  insertedId: ...}