Como funciona validação de schema no MongoDB?

Question

Accepted Answer

Embora o MongoDB seja flexível por padrão, ele suporta **validação de schema** no nível do banco de dados — definindo regras (campos obrigatórios, tipos, restrições de valor) que os documentos devem satisfazer. Isso adiciona integridade de dados *dentro* do MongoDB em si (não apenas no código da aplicação), equilibrando flexibilidade com consistência.

## Definindo regras de validação

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

O MongoDB usa **JSON Schema** para definir regras de validação — campos obrigatórios, tipos, padrões, intervalos — executadas pelo banco de dados quando documentos são inseridos ou atualizados.

## Níveis de validação e ações

```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 quais documentos são verificados; `validationAction` controla se violações rejeitam ou apenas advertem.

## Por que validar no banco de dados (vs apenas na 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 flexibilidade e estrutura

```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 que isso importa

Entender validação de schema no MongoDB é valioso para **equilibrar a flexibilidade do MongoDB com integridade de dados**, sendo um conhecimento útil para construir aplicações MongoDB confiáveis.

Enquanto a flexibilidade sem schema do MongoDB é uma grande vantagem (adequada para dados em evolução e variados), **flexibilidade incontrolada pode levar a dados inconsistentes** (campos faltantes, tipos errados, valores inválidos) — uma preocupação real para qualidade de dados.

Validação de schema aborda isso permitindo que você imponha regras (campos obrigatórios, tipos, padrões, intervalos via JSON Schema) **no nível do banco de dados**, para que documentos devam satisfazê-las.

O valor-chave da **validação em nível de banco de dados** (ao contrário de apenas em nível de aplicação) é que ela é executada independentemente de qual aplicação, serviço, script ou operação manual escreve os dados — fornecendo uma garantia de integridade consistente e uma rede de segurança mesmo se a validação da aplicação for contornada ou bugada (o mesmo raciocínio que SQL constraints: o banco de dados como última linha de defesa).

Entender os **níveis de validação e ações** (controlando quais documentos são verificados e se violações rejeitam ou advertem) permite adoção flexível.

Mais importante ainda, entender como **equilibrar flexibilidade e estrutura** — adicionando validação onde consistência importa enquanto mantém flexibilidade em outro lugar, frequentemente começando flexível e adicionando validação conforme o schema se estabiliza — reflete uso maduro do MongoDB que obtém os benefícios da flexibilidade sem sacrificar integridade de dados crítica.

Saber que validação é frequentemente feita também na camada de app (por exemplo Mongoose schemas) também é relevante.

Como integridade de dados importa mesmo em bancos de dados flexíveis, e como validação de schema do MongoDB permite impor estrutura onde necessário (em nível de banco de dados para uma garantia forte) enquanto preserva flexibilidade, entender validação de schema — como funciona, benefícios de execução em nível de banco de dados, e equilibrar flexibilidade com estrutura — é conhecimento valioso e praticamente relevante para construir aplicações MongoDB que mantêm qualidade de dados, uma capacidade útil que aborda a preocupação comum de dados inconsistentes em bancos de dados com schema flexível.