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.

Saltar la validación del esquema

En algunas situaciones, es posible que debas omitir las reglas de validación de esquema de una colección. Por ejemplo, si está restaurando datos potencialmente no válidos de una copia de seguridad a una colección que tiene reglas de validación. En este escenario, los documentos antiguos pueden no cumplir con los nuevos requisitos de validación.

Se omite la validación del esquema para cada operación. Si omites la validación del esquema para insertar un documento inválido, cualquier actualización futura del documento inválido debe:

  • También omitir la validación de esquema

  • Resulta en un documento válido

Si el validationLevel de la colección es constraint, o si prepareConstraintValidationLevel es true, MongoDB rechaza cualquier operación de guardar que establezca bypassDocumentValidation en true. La operación de guardar falla incluso cuando el documento cumple con las reglas de validación:

{ ok: 0, errmsg: "bypassDocumentValidation is not permitted with 'constraint' validationLevel", code: 2, codeName: "BadValue"}

Si prepareConstraintValidationLevel es true, la operación de guardar falla con un mensaje diferente. Ese mensaje menciona prepareConstraintValidationLevel y proporciona el comando que lo borra. Ambos fallos utilizan el código de error BadValue.

Para restauración la capacidad de omitir la validación, actualice la colección con collMod:

  • Si el validationLevel de la colección es constraint, establézcalo en strict.

  • Si el prepareConstraintValidationLevel de la colección es true, establézcalo en false.

Nuevo en la versión 9.0.

Puedes utilizar los siguientes comandos y métodos para omitir la validación en cada operación:

Para implementaciones que han activado el control de acceso, para omitir la validación de documentos, el usuario autenticado debe tener la acción bypassDocumentValidation. Los roles integrados dbAdmin y restore proporcionan esta acción.

El siguiente ejemplo crea una colección con validación de esquemas y luego inserta un documento no válido al omitir las reglas de validación.

1

Crea una colección students y usa el operador $jsonSchema para establecer reglas de validación de esquema:

db.createCollection("students", { validator: { $jsonSchema: { bsonType: "object", required: [ "name", "year", "major", "address" ], properties: { name: { bsonType: "string", description: "must be a string and is required" }, year: { bsonType: "int", minimum: 2017, maximum: 3017, description: "must be an integer in [ 2017, 3017 ] and is required" } } } }} )
2

El documento siguiente no es válido porque el campo year está fuera de los límites permitidos (2017-3017):

{ name: "Alice", year: Int32( 2016 ), major: "History", gpa: Double(3.0), address: { city: "NYC", street: "33rd Street" }}

Para pasar por alto las reglas de validación e insertar el documento no válido, ejecute el siguiente comando insert, que establece la opción bypassDocumentValidation en true:

db.runCommand( { insert: "students", documents: [ { name: "Alice", year: Int32( 2016 ), major: "History", gpa: Double(3.0), address: { city: "NYC", street: "33rd Street" } } ], bypassDocumentValidation: true} )

Para confirmar que el documento se insertó correctamente, query la colección students:

db.students.find()

MongoDB devuelve el documento insertado:

[ { _id: ObjectId("62bcb4db3f7991ea4fc6830e"), name: 'Alice', year: 2016, major: 'History', gpa: 3, address: { city: 'NYC', street: '33rd Street' } }]