Ga naar inhoud

Een database opvragen met ormar

Query instellen

Elk model wordt automatisch geregistreerd met een set query 's die de onderliggende query en de opties ervan vertegenwoordigen.

De meeste methoden kunnen ook omgekeerde relaties met buitenlandse sleutels implementeren via veel-op-veel relaties en via de QuerysetProxy-interface.

!!!Info Ga naar Relaties om te zien welke relaties worden ondersteund en hoe u deze kunt opbouwen.

Eenvoudigheidshalve zijn de beschikbare methoden voor het verkrijgen van gegevens en het opslaan ervan in een database onderverdeeld in verschillende categorieën op basis van de functionaliteit die ze implementeren.

Houd er rekening mee dat sommige functies / methoden tot meerdere categorieën behoren.

Voor de volledigheid worden modellen en relationele methoden opgesomd.

Raadpleeg de subpagina voor details voor meer informatie over een specifieke sectie of functie.

Gegevens invoegen in de database

  • -creatie (**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 () methode
    • Model.upsert () methode
    • Model.save\ _ lated () methode
    • Query instellen Agent

    • QuerysetProxy.create(**kwargs) werkwijze

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

!!!Ga naar de sectie Maken voor meer informatie over een of al deze functies.

Gegevens uit database lezen

  • krijgen (**kwargs) - > model

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

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

  • Het eerste () - > model

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

  • model

    • Model.load () methode
    • Query instellen Agent

    • QuerysetProxy.get (**kwargs) -methode

    • QuerysetProxy.get_or_none(**kwargs) werkwijze
    • QuerysetProxy.get_or_create(_defaults: Optional[Dict[str, Any]] = None, **kwargs) werkwijze
    • QuerysetProxy.first () methode
    • QuerysetProxy.all (**kwargs) methode

!!!Ga naar het leesgedeelte voor meer informatie over een of meer van deze functies.

Lees originele gegevensbron uit database

Het model retourneert de oorspronkelijke gegevensbron als een woordenboek of tupellijst, niet als een ormar.

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

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

  • Query instellen Agent

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

!!!Ga naar de sectie originele gegevensbronnen voor meer informatie over een of al deze functies.

De gegevens in de database bijwerken

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

  • update_or_create(**kwargs) -> Model

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

  • model

    • Model.update () methode
    • Model.upsert () methode
    • Model.save\ _ lated () methode
    • Query instellen Agent

    • QuerysetProxy.update_or_create(**kwargs) werkwijze

!!!Ga naar de sectie Updates voor meer informatie over een of meer van deze functies.

Gegevens uit de database verwijderen

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

  • model

    • Model.delete () methode
    • Query instellen Agent

    • QuerysetProxy.delete () methode

    • QuerysetProxy.clear () methode

!!!Ga naar de sectie Verwijderen voor meer informatie over een of meer van deze functies.

Deelnemingen en subqueries

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

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

  • model

    • Model.load () methode
    • Query instellen Agent

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

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

!!!Ga voor meer informatie over een of al deze functies naar de sectie Deelnames en subqueries.

Filteren en sorteren

  • filter (**kwargs) - > query instellen

Uitsluiting* (**kwargs) - > query-set

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

  • krijgen (**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]]

  • Query instellen Agent

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

!!!Ga naar de sectie Filteren en sorteren voor meer informatie over een of al deze functies.

selecteer kolom

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

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

  • Query instellen Agent

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

!!!Ga naar de sectie Kolommen selecteren voor meer informatie over een of al deze functies.

Pagina 's en lijnen

  • paginate(page: int) -> QuerySet

  • limit(limit_count: int) -> QuerySet

  • offset(offset: int) -> QuerySet

  • Krijgen () - > Model

  • Het eerste () - > model

  • Query instellen Agent

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

!!!Ga naar het gedeelte Paging voor meer informatie over een of meer van deze functies.

aggregaat functie

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

  • Bestaan () - > Booleaans

  • Query instellen Agent

    • QuerysetProxy.count(distinct=True) werkwijze
    • QuerysetProxy.bestaat () methode

!!!Ga naar de sectie Aggregaties voor meer informatie over een of al deze functies.