Especificar validação de JSON schema

Contexto

O MongoDB suporta rascunho 4 do JSON Schema, incluindo especificação principal e especificação de validação, com algumas diferenças. Para obter detalhes, consulte Extensões e Omissões.

Para mais informações sobre JSON schema, consulte o site oficial.

Restrições

Você não pode especificar a validação de esquema para:

• Collections nos bancos de dados admin, local e config

• Collections do sistema

Se você tiver a Client-Side Field Level Encryption ou a Queryable Encryption habilitadas em uma coleção, a validação estará sujeita às seguintes restrições:

• Para CSFLE, ao executar o collMod, a biblioteca libmongocrypt prefere o esquema de criptografia JSON especificado no comando. Essa preferência permite definir um esquema em uma coleção que ainda não tem um.

• Na Queryable Encryption, qualquer JSON schema que inclua um campo criptografado resulta em um erro de análise de consulta.

Passos

Neste exemplo, você cria uma coleta students com regras de validação e observa os resultados após tentar inserir um documento inválido.

db.createCollection("students", {
   validator: {
      $jsonSchema: {
         bsonType: "object",
         title: "Student Object Validation",
         required: [ "address", "major", "name", "year" ],
         properties: {
            name: {
               bsonType: "string",
               description: "'name' must be a string and is required"
            },
            year: {
               bsonType: "int",
               minimum: 2017,
               maximum: 3017,
               description: "'year' must be an integer in [ 2017, 3017 ] and is required"
            },
            gpa: {
               bsonType: [ "double" ],
               description: "'gpa' must be a double if the field exists"
            }
         }
      }
   }
} )

db.students.insertOne( {
   name: "Alice",
   year: Int32( 2019 ),
   major: "History",
   gpa: Double( 3.0 ),
   address: {
      city: "NYC",
      street: "33rd Street"
   }
} )

db.students.find()

[
  {
    _id: ...,
    name: 'Alice',
    year: 2019,
    major: 'History',
    gpa: 3,
    address: {
      city: 'NYC',
      street: '33rd Street'
    }
  }
]

Informações adicionais

Você pode combinar a validação de JSON schema com a validação do operador de query.

Por exemplo, considere uma collection sales com esta validação de esquema:

 db.createCollection("sales", {
   validator: {
     "$and": [
       // Validation with query operators
       {
         "$expr": {
           "$lt": ["$lineItems.discountedPrice", "$lineItems.price"]
         }
       },
       // Validation with JSON Schema
       {
         "$jsonSchema": {
           "properties": {
             "items": { "bsonType": "array" }
           }
          }
        }
      ]
    }
  }
)

A validação anterior força que os documentos na collection sales sigam estas regras:

• lineItems.discountedPrice deve ser menor que lineItems.price. Esta regra utiliza o operador $lt.

• O campo items deve ser um array. Esta regra utiliza $jsonSchema.

Saiba mais

• Para obter uma lista completa das palavras-chave JSON schema permitidas, consulte Palavras-chave disponíveis.

• Para restringir quais valores um determinado campo pode conter, consulte Especificar valores de campo permitidos.

• Para evitar problemas com a validação de JSON schema, consulte Dicas para a validação de JSON schema.