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验证级别的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集合中的两个文档，使这两个文档都不符合要求name为字符串的验证规则：

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 that:输出显示：

• 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. _id: 2的文档的更新成功。This document did not meet the initial validation requirements, and MongoDB does not apply validation rules to this document.本文档不符合初始验证要求，MongoDB也不将验证规则应用于本文档。