Hvordan paginerer du resultater i Django og DRF?

Question

Accepted Answer

**Pagination** opdeler et stort sæt resultater i diskrete sider, så du ikke indlæser tusindvis af poster på én gang. Det er afgørende for ydeevne og brugervenlighed. Django leverer en `Paginator`-klasse til templates/views, og DRF tilbyder indbygget pagination for API'er. ## Problemet, som pagination løser ```python # ❌ loading everything — slow, memory-heavy, bad UX with thousands of rows articles = Article.objects.all() # could be 100,000 records ``` ## Djangos Paginator (til traditionelle views/templates) ```python from django.core.paginator import Paginator def article_list(request): articles = Article.objects.all().order_by("-created_at") # ORDER matters for consistent pages paginator = Paginator(articles, 20) # 20 items per page page_number = request.GET.get("page") # ?page=2 page_obj = paginator.get_page(page_number) # the requested page return render(request, "list.html", {"page_obj": page_obj}) ``` ```html {% for article in page_obj %}

{% endfor %} {% if page_obj.has_previous %}Prev{% endif %} Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }} {% if page_obj.has_next %}Next{% endif %} ``` `Paginator` opdeler et queryset i sider, og `get_page()` returnerer et sideobjekt med navigationshælpere (`has_next`, `next_page_number` osv.) — bemærk at det tilføjer `LIMIT`/`OFFSET` til forespørgslen, så kun én side hentes fra databasen. ## DRF pagination (til API'er) ```python # global default in settings.py REST_FRAMEWORK = { "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination", "PAGE_SIZE": 20, } # now list endpoints are automatically paginated, returning: # { "count": 1000, "next": "...?page=3", "previous": "...?page=1", "results": [...] } ``` DRF paginerer list-endpoints automatisk, når det er konfigureret, og returnerer sidemetadata (count, next/previous-links) sammen med resultaterne — klienter navigerer via de leverede URL'er. ## DRF pagination-stile ```text PageNumberPagination → ?page=2 (simple page numbers) LimitOffsetPagination → ?limit=20&offset=40 (flexible offsets) CursorPagination → opaque cursor; consistent & performant for large/changing data (avoids OFFSET performance issues on huge datasets) ``` ## Ydelsesfinesensen ```text ⚠️ OFFSET-based pagination (page/offset) gets SLOWER on deep pages of huge tables (the DB must skip OFFSET rows). For very large datasets, CURSOR pagination (keyset, using a WHERE on an indexed column) is far more efficient. ⚠️ Always ORDER BY a stable field, or pages can be inconsistent/repeat items. ``` ## Hvorfor det betyder noget Pagination er afgørende for at bygge performante, brugbare applikationer, der håndterer rigtige datamængder — uden det bliver list-endpoints og sider, der indlæser hele tabeller (potentielt tusindvis eller millioner af rækker), langsomme, hukommelseskrævende og ubrugelige, både ved at belaste databasen og overvælde brugere og klienter. Forståelse af pagination er hverdagspraktisk viden: Djangos **Paginator** håndterer traditionelle views/templates (opdeling af querysets i sider med navigationshælpere, effektiv indlæsning af kun én side via LIMIT/OFFSET), og DRF's **indbyggede pagination** håndterer API'er (automatisk pagination af list-endpoints med metadata og navigationlinks, når det er konfigureret) — begge er nødvendige afhængigt af, om du bygger server-rendererede sider eller API'er. At vide, hvordan man implementerer pagination i begge kontekster, er nødvendigt for næsten enhver data-list-funktion. **Ydelsesfinesensen** er særlig værdifuld seniorlevel-viden: standard OFFSET-baseret pagination forringes på dybe sider af meget store tabeller (databasen skal springe alle foregående rækker over), så **cursor (keyset) pagination** er det effektive valg for enorme eller hurtigt skiftende datasæt, og **sortering efter et stabilt felt** er altid nødvendig for at undgå ukonsekvente eller duplikerede resultater på tværs af sider. Forståelse af både basismekkanikken (Paginator, DRF pagination-klasser) og disse ydelsesvurderinger (OFFSET vs cursor pagination, konsistent sortering) er vigtig for at bygge applikationer, der forbliver hurtige og korrekte, når data vokser — pagination er et allestedsnærværende krav, og at gøre det godt, især i stor skala, er en praktisk færdighed, der direkte påvirker applikationens ydeevne og brugeroplevelse.