Specify Validation Level for Existing Documents指定现有文档的验证级别

Specify validation rules with strict validation level.指定具有strict验证级别的验证规则。

Add a validator to the contacts collection with strict validationLevel:使用strict validationLevel将验证器添加到contacts集合中：

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

Because the validationLevel is strict, when any document is updated, MongoDB checks that document for validation.因为validationLevel是strict，当任何文档被更新时，MongoDB都会检查该文档的验证。

Test the validation.测试验证。

The following update commands modify both documents in the contacts collection such that neither of the documents are consistent with the validation rule which requires name to be a string:以下更新命令修改了contacts集合中的两个文档，使得这两个文档都不符合要求name为字符串的验证规则：

db.contacts.updateOne(
   { _id: 1 },
   { $set: { name: 10 } }
)

db.contacts.updateOne(
   { _id: 2 },
   { $set: { name: 20 } }
)

Observe results.观察结果。

Both update operations fail. MongoDB returns the following output for each operation:两次更新操作均失败。MongoDB为每个操作返回以下输出：

 MongoServerError: Document failed validation
 Additional information: {
   failingDocumentId: <id>,
   details: {
     operatorName: '$jsonSchema',
     schemaRulesNotSatisfied: [
       {
         operatorName: 'properties',
         propertiesNotSatisfied: [
           {
             propertyName: 'name',
             description: 'name must be a string and is required',
             details: [
               {
                 operatorName: 'bsonType',
                 specifiedAs: { bsonType: 'string' },
                 reason: 'type did not match',
                 consideredValue: <value>,
                 consideredType: 'int'
               }
             ]
           }
         ]
       },
       {
         operatorName: 'required',
         specifiedAs: { required: [ 'phone', 'name' ] },
         missingProperties: [ 'phone' ]
       }
     ]
   }
 }

Specify validation rules with moderate validation level.指定具有moderate验证级别的验证规则。

Add a validator to the contacts collection with moderate validationLevel:使用moderate validationLevel将验证器添加到contacts集合中：

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

Because the validationLevel is moderate:因为validationLevel是moderate：

• If you update the document with _id: 1, MongoDB applies the new validation rules because the existing document meets the validation requirements.如果你用_id:1更新文档，MongoDB会应用新的验证规则，因为现有文档符合验证要求。
• If you update the document with _id: 2, MongoDB does not apply the new validation rules because the existing document does not meet the validation requirements.如果用_id: 2更新文档，MongoDB不会应用新的验证规则，因为现有文档不符合验证要求。

Test the validation.测试验证。

The following update commands modify both documents in the contacts collection such that neither of the documents are consistent with the validation rule which requires name to be a string:以下更新命令修改了contacts集合中的两个文档，使得这两个文档都不符合要求名称为字符串的验证规则：

db.contacts.updateOne(
   { _id: 1 },
   { $set: { name: 10 } }
)

db.contacts.updateOne(
   { _id: 2 },
   { $set: { name: 20 } }
)

Observe results.观察结果。

MongoDB returns the following output for each operation:MongoDB为每个操作返回以下输出：

// _id: 1

MongoServerError: Document failed validation
Additional information: {
  failingDocumentId: 1,
  details: {
    operatorName: '$jsonSchema',
    schemaRulesNotSatisfied: [
      {
        operatorName: 'properties',
        propertiesNotSatisfied: [
          {
            propertyName: 'name',
            description: 'name must be a string and is required',
            details: [
              {
                operatorName: 'bsonType',
                specifiedAs: { bsonType: 'string' },
                reason: 'type did not match',
                consideredValue: 10,
                consideredType: 'int'
              }
            ]
          }
        ]
      }
    ]
  }
}

// _id: 2

{
   acknowledged: true,
   insertedId: null,
   matchedCount: 1,
   modifiedCount: 0,
   upsertedCount: 0
}

The output shows:输出显示：

• The update fails for the document with _id: 1. This document met the initial validation requirements, and MongoDB applies validation rules to this document._id: 1的文档更新失败。此文档符合初始验证要求，MongoDB将验证规则应用于此文档。
• The update succeeds for the document with _id: 2. This document did not meet the initial validation requirements, and MongoDB does not apply validation rules to this document._id: 2的文档更新成功。此文档不符合初始验证要求，MongoDB也不对此文档应用验证规则。