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 às atualizações de documentos existentes que já atendem às regras.

Insert a valid document.

O seguinte comando de inserção adiciona um documento que inclui um campo title com um valor de string, 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 retorna uma saída semelhante a esta:

{
  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 documento .

Insert a valid document.

O seguinte comando de inserção adiciona um documento que inclui um campo title com um valor de string, 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 retorna uma saída semelhante a esta:

{
  acknowledged: true,
  insertedId: ...
}

(Condicional) Defina seu validationLevel como strict.

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

Prepare a collection para o nível constraint.

Execute collMod com prepareConstraintValidationLevel definido como true:

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

Este comando prepara a collection para a atualização bloqueando bypassDocumentValidation e evitando alterações no validador.

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

Não é possível alterar validator na mesma operação collMod que atualiza validationLevel para constraint. Defina as regras de validação antes de executar este comando. Para alterar as regras mais tarde, faça downgrade do nível para strict, modifique as regras e, em seguida, atualize de volta para constraint.

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

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

Insert a valid document.

O seguinte comando de inserção adiciona um documento que inclui um campo title com um valor de string, 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 retorna uma saída semelhante a esta:

{
  acknowledged: true,
  insertedId: ...
}