Para los documentos que ya existen en su colección antes de agregar la validación, puede especificar cómo MongoDB aplica las reglas de validación a estos documentos.
Context
El validationLevel de tu esquema determina los documentos para los cuales MongoDB aplica reglas de validación:
Nivel de validación | Comportamiento |
|---|---|
| MongoDB aplica las mismas reglas de validación tanto a la inserción de documentos como a la actualización de documentos válidos existentes que cumplan con las reglas de validación. No se requiere que las actualizaciones de documentos existentes en la colección que no cumplan con las reglas de validación pasen la validación. |
| (Por defecto) MongoDB aplica las mismas reglas de validación a todas las inserciones y actualizaciones de documentos. |
| MongoDB aplica las reglas de validación a todas las inserciones y actualizaciones de documentos, y garantías que cada documento de la colección cumpla las reglas. A diferencia de
Nuevo en la versión 9.0. |
Requisito previo
Los ejemplos en esta página usan una colección movies. Para crear la colección e insertar los documentos que utilizan los ejemplos, ejecute el siguiente comando:
db.movies.insertMany( [ { title: "The Godfather", year: 1972 }, { title: "Casablanca", year: 1942 }] )Especificar validación moderada
El siguiente ejemplo añade un validador moderate a la colección movies e inserta un documento que cumple las reglas de validación.
Especifica reglas de validación con nivel de validación moderate.
Agregue un validador a la colección movies con moderate validationLevel:
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"} )Dado que el validationLevel es moderate, MongoDB aplica las reglas de validación a todas las inserciones de documentos y a las actualizaciones de documentos existentes que ya cumplen las reglas.
Especificar validación estricta
El siguiente ejemplo añade un validador strict a la colección movies e inserta un documento que cumple las reglas de validación.
Especifica reglas de validación con nivel de validación strict.
Agregue un validador a la colección movies con strict validationLevel:
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"} )Dado que el validationLevel es strict, MongoDB aplica las reglas de validación a todas las inserciones y actualizaciones de documentos.
Nota
Cuando actualiza a la validación strict, MongoDB no comprueba retroactivamente que los documentos existentes en la colección pasen el validador. Después de la actualización, la colección puede contener documentos inválidos que existían antes de la actualización. Sin embargo, las operaciones de actualización en documentos no válidos fallan debido al validador. Para actualizar un documento inválido, primero resuelva el problema que hace que el validador falle.
Especificar validación de restricción
El siguiente ejemplo actualiza la colección movies al nivel de validación constraint. Cuando actualiza al nivel constraint, MongoDB comprueba que cada documento que ya está en la colección cumple con el validador.
Nota
El siguiente procedimiento se aplica a una colección que ya existe. Si establece el validationLevel en constraint al crear la colección, no es necesario establecer primero el nivel en strict ni preparar la colección.
(Condicional) Establezca su validationLevel en strict.
Si el validationLevel de su colección no es ya strict, siga el procedimiento para especificar una validación estricta.
Prepare la colección para el nivel constraint.
ejecutar collMod con prepareConstraintValidationLevel establecido en true:
db.runCommand( { collMod: "movies", prepareConstraintValidationLevel: true} )Este comando prepara la colección para la actualización bloqueando bypassDocumentValidation y evitando cambios en el validador. Para aprender cómo MongoDB restringe la omisión, consulte Omitir la validación de esquema.
Establezca el nivel de validación en constraint.
ejecutar collMod para establecer validationLevel a constraint. El validationAction debe ser error o errorAndLog:
db.runCommand( { collMod: "movies", validationLevel: "constraint", validationAction: "error"} )No puede cambiar el validator en la misma operación collMod que actualiza el validationLevel a constraint. Establezca las reglas de validación antes de ejecutar este comando. Para cambiar las reglas más tarde, baje el nivel a strict, modifique las reglas y luego vuelva a subir a constraint.
Dado que el validationLevel es constraint, MongoDB aplica las reglas de validación a todas las inserciones y actualizaciones de documentos, independientemente de si un documento existente cumplía las reglas antes de la actualización.
Cuando establece el nivel en constraint, MongoDB escanea todos los documentos existentes en la colección y falla la operación collMod si algún documento infringe el validador. Este escaneo puede ser computacionalmente costoso para colecciones grandes. Si la operación falla, actualice los documentos infractores para que pasen el validador antes de continuar.
Importante
La salida de errores está destinada al uso humano. Podría cambiar en el futuro y no debe dependerse de ello en scripts.