Conas a dhéanann tú torthaí a leathánú in Django agus DRF?

Question

Accepted Answer

**Leathánú** a roinnt sraith mhór torthaí ina leathanaigh ar leith, ionas nach dtógann tú na mílte taighdean ar an am amháin. Tá sé riachtanach do thorthaí agus do inúsáidtacht. Soláthraíonn Django an aicme `Paginator` do themplaidí/amhairc, agus soláthraíonn DRF leathánú fothairgthe do APIs. ## An fhadhb a réitíonn leathánú ```python # ❌ loading everything — slow, memory-heavy, bad UX with thousands of rows articles = Article.objects.all() # could be 100,000 records ``` ## Paginator Django (do amhairc/themplaidí traidisiúnta) ```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 %} ``` Déanann an `Paginator` sníomh ar queryset ina leathanaigh agus tugann `get_page()` ar ais réad leathanaigh le cuiditheoir nascleanúna (`has_next`, `next_page_number`, etc.) — tabhair faoi deara go gcuireann sé `LIMIT`/`OFFSET` leis an fhiosrú, mar sin ní bhfuarthar ach leathach amháin ó an bunachar sonraí. ## Leathánú DRF (do APIs) ```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": [...] } ``` Leathánú DRF ag pointí liosta go huachtar nuair a bhíonn sé cumraithe, ag filleadh meiteashonraí leathanaigh (comhaireamh, naisc thosaigh/roimhe) in éineacht leis na torthaí — cuirtear na cliant ar foluain trí na URLs a sholáthraítear. ## Stíleanna leathánú DRF ```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) ``` ## An nuance feidhmíochta ```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. ``` ## Cén fáth go dtabhair sé spéis Tá leathánú riachtanach chun feidhmchláir feidhmíochta, inúsáidtacht a thógáil a láimhseálann méideanna sonraí fíor — gan é, éiríonn pointí liosta agus leathanaigh a luchtaíonn táblaí iomlána (ar dhóigh na mílte nó na milliúin línte) go mall, ináirimh-dhian, agus neamhúsáideach, ag cur brú ar an bhunachar sonraí agus ag ró-infhollain do úsáideoirí agus do chliaint. An leathánú a thuiscint an t-eolas praiticiúil laethúil: láimhseálann **Paginator** Django amhairc/themplaidí traidisiúnta (ag snámh querysets ina leathanaigh le cuiditheoir nascleanúna, ag fáil go héifeachtach ach leathach amháin trí LIMIT/OFFSET), agus láimhseálann **leathánú fothairgthe** DRF APIs (ag leathánú go huachtar ag pointí liosta le meiteashonraí agus naisc nascleanúna nuair a bhíonn sé cumraithe) — tá an dá cheann ag teastáil ag brath ar cibé an bhfuil tú ag togáil leathanaigh a thaifeadtar ar an fhreastalaí nó ar APIs. Is gá a bheith ar eolas agat conas leathánú a chur i bhfeidhm in an dá chosúlacht. Tá an **nuance feidhmíochta** an fhaisnéis speisialta leibhéal shinseartha go háirithe: laghdaíonn leathánú bunaithe ar OFFSET ar leathanaigh dhomhain de tháblaí an-mhór (caithfidh an bunachar sonraí gach líne roimhe a scipeáil), mar sin is rogha éifeachtach **leathánú cúrsóra (keyset)** do thacair ollmhóir nó athruithe tapa, agus is gá i gcónaí **ordúchán de réir réimse cobhsaí** chun torthaí neamh-chomhsheasmhach nó dúbailte a sheachaint ar fud leathanaigh. A thuiscint an méanicí bunúsach (Paginator, ranganna leathánú DRF) agus na bhreithiúntas feidhmíochta seo (OFFSET vs leathánú cúrsóra, ordúchán comhsheasmhach) tábhachtach le haghaidh feidhmchláir a thógáil a fhanann gasta agus ceart agus sonraí a fhás — is éileamh doshéachta leathánú, agus é a dhéanamh go maith, go háirithe ag scála, ní scil dhraíochta atá riachtanach go díreach do fheidhmíochta agus do thaithí an úsáideora.