Lewati ke isi

Kueri database dengan ormar

Setelan Query

Setiap model secara otomatis terdaftar dengan satu set pertanyaan yang mewakili kueri yang mendasari dan pilihannya.

Sebagian besar metode juga dapat menerapkan hubungan kunci asing terbalik melalui hubungan banyak-ke-banyak dan melalui antarmuka QuerysetProxy.

!!!Info Untuk melihat hubungan mana yang didukung dan bagaimana membangunnya, kunjungi Hubungan.

Demi kesederhanaan, metode yang tersedia untuk memperoleh data dan menyimpannya ke database dibagi menjadi beberapa kategori berdasarkan fungsionalitas yang mereka implementasikan.

Harap dicatat bahwa beberapa fungsi / metode termasuk dalam beberapa kategori.

Demi kelengkapan, model dan metode relasional dicantumkan.

Untuk mempelajari lebih lanjut tentang bagian atau fitur tertentu, lihat subhalaman detail.

Masukkan data ke dalam database

Pembuatan* (**kwargs) - > model

  • get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) -> Tuple[Model, bool]

  • update_or_create(**kwargs) -> Model

  • bulk_create(objects: List[Model]) -> None

  • model

    • Model.save () metode
    • Metode pemodelan ()
    • Model.save\ _ lated ()

    • Agen Setelan Kueri

    • QuerysetProxy.create(**kwargs) metode

    • QuerysetProxy.get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) metode
    • QuerysetProxy.update_or_create(**kwargs) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fungsi ini, kunjungi bagian Buat.

Baca data dari database

  • mendapatkan (**kwargs) - > model

  • get_or_none(**kwargs) -> Optional[Model]

  • get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) -> Tuple[Model, bool]

  • Model pertama () - >

  • all(**kwargs) -> List[Optional[Model]]

  • model

    • Metode model.load ()
    • Agen Setelan Kueri

    Metode QuerysetProxy.get (**kwargs) * QuerysetProxy.get_or_none(**kwargs) metode * QuerysetProxy.get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) metode * QuerysetProxy.first () metode Metode QuerysetProxy.all (**kwargs)

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, silakan kunjungi bagian membaca.

Baca sumber data asli dari database

Model mengembalikan sumber data asli sebagai kamus atau daftar tuple, bukan ormar.

  • values(fields = None, exclude_through = False) -> List[Dict]

  • values_list(fields = None, exclude_through = False, flatten = False) -> List

  • Agen Setelan Kueri

    • QuerysetProxy.values(fields = None, exclude_through = False) metode
    • QuerysetProxy.values_list(fields = None, exclude_through= False, flatten = False) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fungsi ini, kunjungi bagian sumber data asli.

Perbarui data dalam database

  • update(each: bool = False, **kwargs) -> int

  • update_or_create(**kwargs) -> Model

  • bulk_update(objects: List[Model], columns: List[str] = None) -> None

  • model

    • Metode pemograman ()
    • Metode pemodelan ()
    • Model.save\ _ lated ()

    • Agen Setelan Kueri

    • QuerysetProxy.update_or_create(**kwargs) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, kunjungi bagian Pembaruan.

Hapus data dari database

  • delete(each: bool = False, **kwargs) -> int

  • model

    • Metode penghapusan model ()

    • Agen Setelan Kueri

    • QuerysetProxy.remove () metode

    • QuerysetProxy.clear () metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, kunjungi bagian Penghapusan.

Bergabung dan mengajukan

  • select_related(related: Union[List, str]) -> QuerySet

  • prefetch_related(related: Union[List, str]) -> QuerySet

  • model

    • Metode model.load ()

    • Agen Setelan Kueri

    • QuerysetProxy.select_related(related: Union[List, str]) metode

    • QuerysetProxy.prefetch_related(related: Union[List, str]) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fungsi ini, kunjungi bagian Bergabung dan Subkueri.

Penyaringan dan penyortiran

Filter* (**kwargs) - > set kueri

Pengecualian* (**kwargs) - > set kueri

  • order_by(columns:Union[List, str]) -> QuerySet

  • mendapatkan (**kwargs) - > model

  • get_or_none(**kwargs) -> Optional[Model]

  • get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) -> Tuple[Model, bool]

  • all(**kwargs) -> List[Optional[Model]]

  • Agen Setelan Kueri

    • QuerysetProxy.filter(**kwargs) metode
    • QuerysetProxy.exclude(**kwargs) metode
    • QuerysetProxy.order_by(columns:Union[List, str]) metode Metode* QuerysetProxy.get (**kwargs)
    • QuerysetProxy.get_or_none(**kwargs) metode
    • QuerysetProxy.get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) metode Metode* QuerysetProxy.all (**kwargs)

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, kunjungi bagian Penyaringan dan Penyortiran.

pilih kolom

  • fields(columns: Union[List, str, set, dict]) -> QuerySet

  • exclude_fields(columns: Union[List, str, set, dict]) -> QuerySet

  • Agen Setelan Kueri

    • QuerysetProxy.fields(columns: Union[List, str, set, dict]) metode
    • QuerysetProxy.exclude_fields(columns: Union[List, str, set, dict]) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, kunjungi bagian Kolom Pilih.

Halaman dan baris

  • paginate(page: int) -> QuerySet

  • limit(limit_count: int) -> QuerySet

  • offset(offset: int) -> QuerySet

  • Dapatkan () - > Model

  • Model pertama () - >

  • Agen Setelan Kueri

    • QuerysetProxy.paginate(page: int) metode
    • QuerysetProxy.limit(limit_count: int) metode
    • QuerysetProxy.offset(offset: int) metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fitur ini, kunjungi bagian Paging.

fungsi agregat

  • count(distinct: bool = True) -> int

  • Keberadaan () - > Boolean

  • Agen Setelan Kueri

    • QuerysetProxy.count(distinct=True) metode
    • QuerysetProxy.there () metode

!!!Untuk mempelajari lebih lanjut tentang salah satu atau semua fungsi ini, kunjungi bagian Agregasi.