Bir şemayı zorunlu kılma

Python ile MongoDB'ye Giriş

Filip Schouwenaars

Machine Learning Researcher

Esnekten doğrulanmış şemaya

MongoDB, sabit bir şema olmadan veri saklamanıza izin verir
Hızlı prototipleme ve gelişen veri modelleri için idealdir

mov.insert_one({
    "title": "knives out",
    "genre": ["comedy", "crime", "drama"],
    "year": 2019, # oops
    "rating": 7.9,
})


mov.find_one({
  "title": "knives out",
  "release_year": 2019
})

Şema netleştiğinde doğrulamayı yapılandırmak önemlidir

pydantic ile şema zorunlu kılma

Veri doğrulama kütüphanesi
Beklenen alanları ve türlerini tanımlayın
Her belge için bir plan

from pydantic import BaseModel
from typing import Optional

class Movie(BaseModel):
    title: str
    genre: list[str]
    release_year: int
    rating: float
    won_oscar: Optional[bool] = None

Türlü veri modelleriyle ekleme

# Önce
new_movie = {
  "title": "knives out",
  "genre": ["comedy", "crime", "drama"],
  "year": 2019, # oops
  "rating": 7.9,
}

# Çıktı yok

Veri biçimi için kontrol yok

# Şimdi
new_movie = Movie(
  title = "knives out",
  genre = ["comedy", "crime", "drama"],
  year = 2019, # oops
  rating = 7.9,
)

pydantic.error_wrappers.ValidationError:
1 validation error for Movie
release_year: field required

Yazım hataları ve eksik alanlar koleksiyona girmeden yakalanır!

Hatayı düzeltme

from pydantic import BaseModel
from typing import Optional

class Movie(BaseModel):
    title: str
    genre: list[str]
    release_year: int
    rating: float
    won_oscar: Optional[bool] = None

# Doğru alan seti ve değerler
new_movie = Movie(
  title = "knives out",
  genre = ["comedy", "crime", "drama"],
  release_year = 2019,
  rating = 7.9,
)


mov.insert_one(dict(new_movie))

InsertOneResult(...)

MongoDB’nin yerleşik şema doğrulaması

client.film.create_collection(
  "movies_v2",
  validator={
    "$jsonSchema": {
      "required": ["title", "genre", "release_year", "rating"],
      "properties": {
        "title": { "bsonType": "string" },
        "genre": { 
          "bsonType": "array",
          "items": { "bsonType": "string" }
        },
        "release_year": { "bsonType": "int" },
        "rating": { "bsonType": "double" },
        "won_oscar": { "bsonType": "bool" }
      }
    }
  }
)

MongoDB’nin yerleşik şema doğrulamasını test etme

client.film.movies_v2.insert_one({
  "title": "knives out",
  "genre": ["comedy", "crime", "drama"],
  "year": 2019, # oops
  "rating": 7.9,
})

pymongo.errors.WriteError: Document failed validation, [...]
'missingProperties': ['release_year'], 'errmsg': 'Document failed validation'}

Veritabanı düzeyinde şema doğrulaması
MongoDB’ye erişen tüm uygulamalarda geçerlidir

Özet

Uygulama tarafı doğrulama: pydantic.BaseModel
Veritabanı tarafı doğrulama: MongoDB’nin yerleşik şema doğrulaması
Hataları önler
Yapıyı zorunlu kılar

Ayo berlatih!

Python ile MongoDB'ye Giriş