¿Cómo funciona la validación de esquemas en MongoDB?

Question

Accepted Answer

Aunque MongoDB es flexible por defecto, soporta **validación de esquemas** a nivel de base de datos — definiendo reglas (campos requeridos, tipos, restricciones de valores) que los documentos deben satisfacer. Esto agrega integridad de datos *dentro* de MongoDB mismo (no solo en código de aplicación), equilibrando flexibilidad con consistencia.

## Por qué es 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 usa **JSON Schema** para definir reglas de validación — campos requeridos, tipos, patrones, rangos — aplicados por la base de datos cuando los documentos se insertan o actualizan.

## Niveles de validación y acciones

```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` controla qué documentos se verifican; `validationAction` controla si las violaciones generan error (rechazo) o solo advierten.

## ¿Por qué validar en la base de datos (vs solo en la 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.
```

## Equilibrando flexibilidad y estructura

```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.)
```

## Por qué es importante

Comprender la validación de esquemas en MongoDB es valioso para **equilibrar la flexibilidad de MongoDB con la integridad de datos**, por lo que es conocimiento útil para construir aplicaciones MongoDB confiables.

Aunque la flexibilidad sin esquema de MongoDB es una ventaja importante (adecuada para datos en evolución y variados), **la flexibilidad incontrolada puede llevar a datos inconsistentes** (campos faltantes, tipos incorrectos, valores inválidos) — una preocupación real para la calidad de datos.

La validación de esquemas aborda esto permitiéndote aplicar reglas (campos requeridos, tipos, patrones, rangos vía JSON Schema) **a nivel de base de datos**, para que los documentos deban satisfacerlas.

El valor clave de **validación a nivel de base de datos** (en lugar de solo a nivel de aplicación) es que se aplica independientemente de cuál aplicación, servicio, script u operación manual escriba los datos — proporcionando una garantía de integridad consistente y una red de seguridad incluso si la validación de la aplicación es omitida o tiene errores (el mismo razonamiento que las restricciones SQL: la base de datos como la última línea de defensa).

Comprender los **niveles de validación y acciones** (controlando qué documentos se verifican y si las violaciones rechazan o advierten) permite una adopción flexible.

Más importante aún, comprender cómo **equilibrar flexibilidad y estructura** — agregando validación donde importa la consistencia mientras se mantiene flexibilidad en otros lugares, a menudo comenzando flexible y agregando validación a medida que el esquema se estabiliza — refleja uso maduro de MongoDB que obtiene los beneficios de la flexibilidad sin sacrificar la integridad de datos crítica.

Saber que la validación a menudo también se hace en la capa de aplicación (por ejemplo, esquemas de Mongoose) también es relevante.

Puesto que la integridad de datos importa incluso en bases de datos flexibles, y puesto que la validación de esquemas de MongoDB te permite aplicar estructura donde sea necesario (a nivel de base de datos para una garantía fuerte) mientras se preserva flexibilidad, comprender validación de esquemas — cómo funciona, beneficios de validación a nivel de base de datos, y equilibrar flexibilidad con estructura — es conocimiento valioso y prácticamente relevante para construir aplicaciones MongoDB que mantengan calidad de datos, una capacidad útil que aborda la preocupación común de datos inconsistentes en bases de datos con esquema flexible.