Menerapkan skema

Pengantar MongoDB di Python

Filip Schouwenaars

Machine Learning Researcher

Dari skema fleksibel ke tervalidasi

MongoDB memungkinkan penyimpanan data tanpa skema tetap
Sangat baik untuk prototipe cepat dan pengembangan model data

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
})

Saat skema sudah jelas, penting untuk mengonfigurasi validasi

Terapkan skema dengan pydantic

Pustaka validasi data
Definisikan field yang diharapkan beserta tipenya
Cetak biru untuk setiap dokumen

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

Menyisipkan dengan model data bertipe

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

# Tidak ada output

Tidak ada pemeriksaan format data

# Sekarang
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

Salah ketik dan field hilang tertangkap sebelum masuk koleksi

Memperbaiki kesalahan kita

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

# Kumpulan field dan nilai yang benar
new_movie = Movie(
  title = "knives out",
  genre = ["comedy", "crime", "drama"],
  release_year = 2019,
  rating = 7.9,
)


mov.insert_one(dict(new_movie))

InsertOneResult(...)

Validasi skema bawaan MongoDB

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" }
      }
    }
  }
)

Menguji validasi skema bawaan MongoDB

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'}

Validasi skema di level database
Berlaku untuk semua aplikasi yang mengakses MongoDB

Ringkasan

Validasi sisi aplikasi: pydantic.BaseModel
Validasi sisi database: validasi skema bawaan MongoDB
Mencegah kesalahan
Menegakkan struktur

Ayo berlatih!

Pengantar MongoDB di Python