Come funziona la convalida dello schema in MongoDB?

Question

Accepted Answer

Sebbene MongoDB sia flessibile per impostazione predefinita, supporta **la convalida dello schema** a livello di database — definendo regole (campi obbligatori, tipi, vincoli sui valori) che i documenti devono soddisfare. Questo aggiunge integrità dei dati *all'interno* di MongoDB stesso (non solo nel codice dell'applicazione), bilanciando flessibilità con coerenza.

## Perché è importante

```js
// add a JSON Schema validator when creating (or modifying) a collection
db.createCollection("users", {
  validator: {
    $jsonSchema: {
      bsonType: "object",
      required: ["name", "email"],            // required fields
      properties: {
        name: { bsonType: "string" },
        email: { bsonType: "string", pattern: "^.+@.+$" },   // type + pattern
        age: { bsonType: "int", minimum: 0, maximum: 120 }   // range
      }
    }
  }
});
// → documents that don't satisfy this are REJECTED on insert/update
```

MongoDB utilizza **JSON Schema** per definire le regole di convalida — campi obbligatori, tipi, pattern, intervalli — applicate dal database quando i documenti vengono inseriti o aggiornati.

## Livelli di convalida e azioni

```js
db.runCommand({
  collMod: "users",
  validator: { $jsonSchema: { ... } },
  validationLevel: "moderate",     // "strict" (all) or "moderate" (only valid existing docs)
  validationAction: "error"        // "error" (reject) or "warn" (log but allow)
});
```

`validationLevel` controlla quali documenti vengono controllati; `validationAction` controlla se le violazioni generano un errore (reject) o solo un avviso.

## Perché convalidare nel database (rispetto solo all'app)?

```text
✓ DATABASE-LEVEL guarantee — enforced regardless of which app/code writes data
  (multiple services, scripts, manual changes) → consistent data integrity
✓ A safety net even if application validation is bypassed or buggy
→ Similar reasoning to SQL constraints: the DB is the last line of defense for integrity.
```

## Bilanciare flessibilità e struttura

```text
MongoDB's flexibility is valuable, but UNCONTROLLED flexibility → inconsistent data.
Schema validation lets you add structure WHERE you need it:
  → enforce critical fields/types while keeping flexibility elsewhere
  → start flexible, add validation as the schema stabilizes
(Often validation is also/instead done in the app layer, e.g. via Mongoose schemas.)
```

## Perché è importante

Comprendere la convalida dello schema di MongoDB è prezioso per **bilanciare la flessibilità di MongoDB con l'integrità dei dati**, quindi è conoscenza utile per costruire applicazioni MongoDB affidabili.

Mentre la flessibilità senza schema di MongoDB è un vantaggio importante (adatta a dati in evoluzione e variati), **la flessibilità incontrollata può portare a dati incoerenti** (campi mancanti, tipi errati, valori non validi) — una vera preoccupazione per la qualità dei dati.

La convalida dello schema affronta questo problema permettendoti di applicare regole (campi obbligatori, tipi, pattern, intervalli tramite JSON Schema) **a livello di database**, in modo che i documenti debbano soddisfarle.

Il valore chiave della **convalida a livello di database** (rispetto solo a livello di applicazione) è che viene applicata indipendentemente da quale applicazione, servizio, script o operazione manuale scrive i dati — fornendo una garanzia di integrità coerente e una rete di sicurezza anche se la convalida dell'applicazione viene bypassata o contiene bug (lo stesso ragionamento dei vincoli SQL: il database come ultima linea di difesa).

Comprendere i **livelli di convalida e le azioni** (controllando quali documenti vengono controllati e se le violazioni rifiutano o avvertono) consente un'adozione flessibile.

Most importantly, understanding how to **balance flexibility and structure** — aggiungendo convalida dove la coerenza è importante mantenendo flessibilità altrove, spesso iniziando in modo flessibile e aggiungendo convalida man mano che lo schema si stabilizza — riflette un utilizzo maturo di MongoDB che ottiene i vantaggi della flessibilità senza sacrificare l'integrità critica dei dati.

Sapere che la convalida viene spesso eseguita anche nello strato di app (ad es. Mongoose schemas) è anche rilevante.

Poiché l'integrità dei dati è importante anche nei database flessibili, e poiché la convalida dello schema di MongoDB ti consente di applicare la struttura dove necessario (a livello di database per una garanzia forte) mantenendo la flessibilità, comprendere la convalida dello schema — come funziona, i vantaggi dell'applicazione a livello di database, e il bilanciamento tra flessibilità e struttura — è conoscenza preziosa e praticamente rilevante per costruire applicazioni MongoDB che mantengono la qualità dei dati, una capacità utile che affronta la preoccupazione comune dei dati incoerenti nei database con schema flessibile.