Especifica el nivel de validación para los documentos existentes

Especifica reglas de validación con el nivel de validación strict.

Agregue un validador a la colección contacts con strict validationLevel:

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"
} )

Como el validationLevel es strict, cuando se actualiza cualquier documento, MongoDB verifica la validación de ese documento.

Probar la validación.

Los siguientes comandos de actualización modifican ambos documentos en la colección contacts de modo que ninguno de los documentos sea consistente con la regla de validación que requiere que name sea una cadena:

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

Inspeccione los resultados.

Ambas operaciones de actualización fallan. MongoDB devuelve la siguiente salida para cada operación:

 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' ]
       }
     ]
   }
 }

Especifica reglas de validación con el nivel de validación moderate.

Agregue un validador a la colección contacts con moderate validationLevel:

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"
} )

Debido a que el validationLevel es moderate:

• Si actualizas el documento con _id: 1, MongoDB aplica las nuevas reglas de validación porque el documento existente cumple con los requisitos de validación.

• Si actualizas el documento con _id: 2, MongoDB no aplica las nuevas reglas de validación porque el documento existente no se ajusta a los requisitos de validación.

Probar la validación.

Los siguientes comandos de actualización modifican ambos documentos en la colección contacts de modo que ninguno de los documentos sea consistente con la regla de validación que requiere que name sea una cadena:

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

Inspeccione los resultados.

MongoDB devuelve la siguiente salida para cada operación:

// _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
}

La salida muestra:

• La actualización falla para el documento con _id: 1. Este documento cumplió con los requisitos de validación iniciales y MongoDB le aplica reglas de validación.

• La actualización es exitosa para el documento con _id: 2. Este documento no cumplió con los requisitos de validación iniciales, y MongoDB no aplica las reglas de validación a este documento.