MongoDB

MongoDB kaynakları

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

MongoDB desteği PyMongo asenkron istemcisini kullanır. SQL databases yerine mongo_databases; SQL resources yerine mongo_resources tanımlanır.

{
  "mongo_databases": {
    "primary": {"uri": "$env:MONGO_URI", "database": "notes"}
  },
  "mongo_resources": [
    {
      "database": "primary", "collection": "notes", "path": "mongo-notes",
      "writable_fields": ["title", "status"],
      "allowed_filters": ["status"],
      "allowed_sort": ["title"],
      "permissions": {
        "list": "mongo.notes.list", "read": "mongo.notes.read",
        "create": "mongo.notes.create", "update": "mongo.notes.update", "delete": "mongo.notes.delete"
      }
    }
  ]
}

Uygulama rolüne bu izinlerin gerekenlerini ekleyin. Bu fragment MongoDB servisini kurmaz ve kullanıcı yetkilerini veritabanı tarafında kendiliğinden yönetmez.

Model farkları

Mongo kaynakları collection, allowlist, payload şemaları, hidden fields, pagination, tenant, owner ve soft-delete politikalarını kullanır. SQL kolon DDL modeli ve SQL statement transaction'ları buraya aynen uygulanmaz. ObjectId biçimli veya native string kimlikleri ilgili endpoint sözleşmesine göre kullanın.

Mongo filter operatörleri SQL setinden daha dardır: eq, ne, gt, gte, lt, lte, in. Keyfi Mongo operatörünü body/query içine geçirerek ham sorgu yetkisi verilmez.

Tenant/owner/soft-delete alanları server kontrollüdür. İstemci yazma listesine eklenmez. owner_actions ve bypass permission kuralı SQL kaynaklarına benzer güven amacı taşır; gerçek Mongo servisi ile çapraz kullanıcı/tenant testi gerekir.

İşletme

Pool boyutu, server selection timeout, bağlantı kimlik bilgileri ve network allowlist'leri açıkça yönetilmelidir. forge migrate genel bir MongoDB index/schema migration aracı değildir. Mongo index ve veri dönüşümlerini ayrıca sürümleyin. Gerçek Mongo entegrasyon testi, mock ile doğrulanamayan bağlantı/driver/CRUD davranışını yakalar.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/framework/mongo.py
• main/framework/config.py
• main/docs/15-MongoDB.md

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım