La validation des schémas

Pourquoi valider ?

Sans garde-fou, rien n'empêche d'insérer une campagne sans zone, ou avec un statut écrit « ouvert » au lieu de « OUVERTE ». La validation pose des règles minimales vérifiées à chaque insertion/mise à jour, tout en laissant les champs non listés libres.

Déclarer un validateur avec $jsonSchema

À la création d'une collection, on fournit un validator décrit par $jsonSchema : champs requis et propriétés attendues.

db.createCollection("campagnes", {
  validator: {
    $jsonSchema: {
      bsonType: "object",
      required: ["zone", "statut", "dateLimite"],
      properties: {
        zone:   { bsonType: "string" },
        statut: { bsonType: "string" }
      }
    }
  }
})

Types & contraintes

On précise le bsonType de chaque champ et des contraintes simples (min, max, longueur…).

properties: {
  litres:     { bsonType: "int", minimum: 500 },
  prixLitre:  { bsonType: "double" },
  commandes:  { bsonType: "array" }
}

Restreindre à des valeurs autorisées (enum)

enum limite un champ à une liste de valeurs — parfait pour un statut.

statut: {
  bsonType: "string",
  enum: ["OUVERTE", "CLOTUREE", "LIVREE"]
}

Une insertion invalide est refusée

Ajouter un validateur à une collection existante

Sur une collection déjà créée, on utilise collMod.

db.runCommand({
  collMod: "campagnes",
  validator: { $jsonSchema: { /* ... */ } }
})

Niveau & action de validation

Deux réglages ajustent la sévérité :

• validationLevel : strict (toutes les écritures) ou moderate (n'applique qu'aux documents déjà valides).
• validationAction : error (rejette) ou warn (accepte mais journalise).