Il-paginazzjoni taqsam sett kbir ta' riżultati f'paġni diskréti, sabiex ma jtaħħadx elf ta' rekords f'daqqa. Hija essenzjali għall-prestazzjoni u l-usabilità. Django jipprovdi klassi Paginator għat-templates/views, u DRF joffri paginazzjoni integrata għall-APIs.
# ❌ loading everything — slow, memory-heavy, bad UX with thousands of rows
articles = Article.objects.()
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})
<!-- in the template -->
{% for article in page_obj %}
<h2>{{ article.title }}</h2>
{% endfor %}
{% if page_obj.has_previous %}<a href="?page={{ page_obj.previous_page_number }}">Prev</a>{% endif %}
Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}
{% if page_obj.has_next %}<a href="?page={{ page_obj.next_page_number }}">Next</a>{% endif %}
Il-Paginator jaqta' queryset f'paġni u get_page() jirritorna oġġett paġna bi helpers ta' navigazzjoni (has_next, next_page_number, eċċ.) — nota li juża LIMIT/OFFSET mal-query, allura biss paġna waħda titħadda mill-bażi ta' dejta.
# 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 jpagina l-list endpoints awtomatikament meta tkun ikonfiggrata, u tirritorna metadata tal-paġna (count, next/previous links) flimkien mal-riżultati — il-clients jnaviġaw permezz tal-URLs ipprovduti.
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)
⚠️ 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.
Il-paginazzjoni hija essenzjali għall-bnija ta' applikazzjonijiet performanti u usable li jħaddlu volumi ta' dejta reali — mingħajrha, list endpoints u paġni li jtaħħadu tabelli sħaħ (potenzjalment eluf jew miljuni ta' ringieli) jibdew bil-mod, jiskolafu l-memorja, u jibqgħu inutilizzabbli, kemm jistgħu jkollhom pressjoni fuq il-bażi ta' dejta kif ukoll jipprezentaw sfida lin-nies u l-clients. /l-fehim tal-paginazzjoni huwa għarfien pratiku ta' kuljum: il-Paginator ta' Django jimmaniġġja views/templates tradizzjonali (jaqta' querysets f'paġni bi helpers ta' navigazzjoni, jiflifil b'mod effiċjenti biss paġna waħda permezz ta' LIMIT/OFFSET), u l-paginazzjoni integrata ta' DRF jimmaniġġja APIs (autopagina għall-list endpoints bi metadata u links ta' navigazzjoni meta tkun ikonfiggrata) — it-tnejn huma meħtieġa skond jekk qed tibni paġni li jipprocessa l-server jew APIs.
Il-għarfien ta' kif tirrealizza l-paginazzjoni f'ż-żewġ kontesti hija meħtieġa għal bħal kwalunkwe feature ta' data-listing.
In-nuance tal-prestazzjoni hija ħarsa valuwuza ta' għarfien senior: paginazzjoni standard bażata fuq OFFSET tiddegrada fuq paġni fond ta' tabelli ħafna kbar (il-bażi ta' dejta trid taqbeż kollha l-ringieli preċedenti), allura cursor (keyset) pagination hija l-għażla effiċjenti għal datasets enormi jew li jinbidlu b'veloċità, u dejjem għandek tordna permezz ta' field stabbli hija meħtieġa biex tindira ri riżultati inkonsistenti jew dupplikati fuq paġni. /L-fehim tat-tnejn il-mekkaniċi bażiċi (Paginator, klassi ta' paginazzjoni DRF) u dawk il-kunsiderazzjonijiet tal-prestazzjoni (OFFSET vs cursor pagination, ordinament konsistenti) huwa importanti għall-bnija ta' applikazzjonijiet li jibqgħu veloċi u korretti hekk kif jogħla d-dejta — il-paginazzjoni hija rekwiżit omniprezent, u għaliex tagħmilha tajjeb, speċjalment f'skala, hija skill pratiku li għandha diretta influwenza fuq il-prestazzjoni tal-applikazzjoni u l-esperienza tal-utent.