Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Especifica el nivel de validación para los documentos existentes

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.

El validationLevel de tu esquema determina los documentos para los cuales MongoDB aplica reglas de validación:

Nivel de validación
Comportamiento

moderate

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.

strict

(Por defecto) MongoDB aplica las mismas reglas de validación a todas las inserciones y actualizaciones de documentos.

constraint

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 strict, una colección con validación constraint no puede contener documentos que no eran válidos antes de establecer el nivel. Este nivel añade las siguientes restricciones:

  • La acción de validación debe ser error o errorAndLog.

  • No puede modificar las reglas de validación de esquema mientras el nivel sea constraint. Para cambiar las reglas de validación, baje a la versión strict, modifique las reglas y luego actualice a la versión constraint.

  • No se puede omitir la validación de documentos. Para obtener más información, consulte Omitir la validación de esquema.

Nuevo en la versión 9.0.

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

El siguiente ejemplo añade un validador moderate a la colección movies e inserta un documento que cumple las reglas de validación.

1

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.

2

El siguiente comando de inserción agrega un documento que incluye un campo title con un valor de tipo string, que cumple la regla de validación:

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

La inserción se realiza correctamente porque el documento cumple con las reglas de validación. MongoDB devuelve una salida similar a la siguiente:

{ acknowledged: true, insertedId: ...}

El siguiente ejemplo añade un validador strict a la colección movies e inserta un documento que cumple las reglas de validación.

1

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.

2

El siguiente comando de inserción agrega un documento que incluye un campo title con un valor de tipo string, que cumple la regla de validación:

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

La inserción se realiza correctamente porque el documento cumple con las reglas de validación. MongoDB devuelve una salida similar a la siguiente:

{ acknowledged: true, insertedId: ...}

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.

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.

1

Si el validationLevel de su colección no es ya strict, siga el procedimiento para especificar una validación estricta.

2

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.

3

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.

4

El siguiente comando de inserción agrega un documento que incluye un campo title con un valor de tipo string, que cumple la regla de validación:

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

La inserción se realiza correctamente porque el documento cumple con las reglas de validación. MongoDB devuelve una salida similar a la siguiente:

{ acknowledged: true, insertedId: ...}

Importante

La salida de errores está destinada al uso humano. Podría cambiar en el futuro y no debe dependerse de ello en scripts.