MongoDB'de şema doğrulaması nasıl çalışır?

Question

Accepted Answer

MongoDB varsayılan olarak esnek olmakla birlikte, veritabanı düzeyinde **şema doğrulaması**'nı destekler — belgelerin karşılaması gereken kurallar (gerekli alanlar, türler, değer kısıtlamaları) tanımlayabilirsiniz. Bu, MongoDB içinde veri bütünlüğü sağlar (yalnızca uygulama kodunda değil), esnekliği tutarlılıkla dengeleyerek.

## Doğrulama kurallarını tanımlama

```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, doğrulama kurallarını tanımlamak için **JSON Schema** kullanır — gerekli alanlar, türler, desenler, aralıklar — belgeler eklendiğinde veya güncellendiğinde veritabanı tarafından uygulanır.

## Doğrulama seviyeleri ve eylemler

```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` hangi belgelerin kontrol edileceğini belirler; `validationAction` ihlallerin hata verip (reddet) ya da sadece uyarı verip vermeyeceğini belirler.

## Neden veritabanında doğrulama yapılır (sadece uygulamada değil)?

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

## Esnekliği ve yapıyı dengelemek

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

## Neden önemli

MongoDB şema doğrulamasını anlamak, **MongoDB'nin esnekliğini veri bütünlüğüyle dengelemek** için değerlidir, bu nedenle güvenilir MongoDB uygulamaları geliştirmek için faydalı bir bilgidir.

MongoDB'nin şemasız esnekliği büyük bir avantaj olsa da (değişken ve çeşitli veriler için uygun), **kontrol edilmeyen esneklik tutarsız veriye yol açabilir** (eksik alanlar, yanlış türler, geçersiz değerler) — veri kalitesi için gerçek bir endişe.

Şema doğrulaması bunu kuralları (JSON Schema aracılığıyla gerekli alanlar, türler, desenler, aralıklar) **veritabanı düzeyinde** uygulamak suretiyle ele alır, böylece belgeler bunları karşılamalıdır.

**Veritabanı düzeyindeki doğrulama**'nın (yalnızca uygulama düzeyinden farklı) temel değeri, verileri yazan hangi uygulama, hizmet, betik veya manuel işlem olursa olsun uygulanması — tutarlı bir bütünlük garantisi ve uygulama doğrulaması atlanırsa veya hatalıysa bile bir güvenlik ağı sağlama (SQL kısıtlamalarıyla aynı mantık: veritabanı son savunma hattı olarak).

**Doğrulama seviyeleri ve eylemlerini** (hangi belgelerin kontrol edileceğini ve ihlallerin reddet mi yoksa uyar mı olacağını kontrol ederek) anlamak esnek benimsemeyi sağlar.

En önemlisi, **esnekliği ve yapıyı dengelemek** — tutarlılığın önemli olduğu yerlerde doğrulama eklerken başka yerlerde esnekliği korumak, genellikle esnek başlayıp şema stabilize oldukça doğrulama eklemek — olgun MongoDB kullanımını yansıtır ve kritik veri bütünlüğünü feda etmeden esnekliğin avantajlarını alır.

Doğrulamanın genellikle uygulama katmanında da yapıldığını bilmek (örn. Mongoose şemaları) da ilgilidir.

Veri bütünlüğü esnek veritabanlarında bile önemli olduğundan ve MongoDB'nin şema doğrulaması, gerekli olduğu yerlerde yapı uygulamaya (güçlü bir garanti için veritabanı düzeyinde) izin verirken esnekliği koruyabildiğinden, şema doğrulamasını anlamak — nasıl çalıştığı, veritabanı düzeyindeki uygulama faydaları ve esnekliği yapıyla dengeleme — MongoDB uygulamaları geliştirmek için değerli, pratik olarak uygun bir bilgidir ve veri kalitesini korur, esnek şemalı veritabanlarında tutarsız verinin yaygın endişesini ele alan faydalı bir yetkinlik.