Especificar nível de validação para documentos existentes

Especifique as regras de validação com o nível de validação moderate.

Adicione um validador à coleção movies com 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"} )

Como o validationLevel é moderate, o MongoDB aplica as regras de validação a todas as inserções de documento e a atualizações de documentos existentes que já atendem às regras.

Insert a valid document.

O comando de inserção a seguir adiciona um documento que inclui um campo title com um valor de string, o que satisfaz a regra de validação:

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

Observe os resultados.

A inserção é bem-sucedida porque o documento satisfaz as regras de validação. O MongoDB gera uma saída semelhante ao seguinte:

{  acknowledged: true,  insertedId: ...}

Especifique as regras de validação com o nível de validação strict.

Adicione um validador à coleção movies com 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"} )

Como o validationLevel é strict, o MongoDB aplica as regras de validação a todas as inserções e atualizações de documentos.

Insert a valid document.

O comando de inserção a seguir adiciona um documento que inclui um campo title com um valor de string, o que satisfaz a regra de validação:

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

Observe os resultados.

A inserção é bem-sucedida porque o documento satisfaz as regras de validação. O MongoDB gera uma saída semelhante ao seguinte:

{  acknowledged: true,  insertedId: ...}

(Condicional) Defina seu validationLevel como strict.

Se o validationLevel da sua coleção ainda não for strict, siga o procedimento para especificar validação estrita.

Prepare a coleção para o nível constraint.

Execute o collMod com prepareConstraintValidationLevel definido como true:

db.runCommand( {   collMod: "movies",   prepareConstraintValidationLevel: true} )

Este comando prepara a coleção para a atualização bloqueando bypassDocumentValidation e impedindo alterações no validador. Para aprender como o MongoDB restringe o bypass, consulte Bypass validação de esquema.

Defina o nível de validação como constraint.

Execute collMod para definir validationLevel como constraint. O validationAction deve ser error ou errorAndLog:

db.runCommand( {   collMod: "movies",   validationLevel: "constraint",   validationAction: "error"} )

Você não pode alterar o validator na mesma operação collMod que atualiza o validationLevel para o constraint. Defina as regras de validação antes de executar este comando. Para alterar as regras mais tarde, rebaixe o nível para strict, modifique as regras e, em seguida, atualize novamente para constraint.

Como o validationLevel é constraint, o MongoDB aplica as regras de validação a todas as inserções e ao atualizar documentos, independentemente de um documento existente atender às regras antes da atualização.

Ao definir o nível como constraint, o MongoDB verifica todos os documentos existentes na coleção e falha na operação collMod se qualquer documento violar o validador. Essa verificação pode ser computacionalmente cara para coleções grandes. Se a operação falhar, atualize os documentos violadores para passar pelo validador antes de continuar.

Insert a valid document.

O comando de inserção a seguir adiciona um documento que inclui um campo title com um valor de string, o que satisfaz a regra de validação:

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

Observe os resultados.

A inserção é bem-sucedida porque o documento satisfaz as regras de validação. O MongoDB gera uma saída semelhante ao seguinte:

{  acknowledged: true,  insertedId: ...}