Pagination διαιρεί ένα μεγάλο σύνολο αποτελεσμάτων σε διακριτές σελίδες, ώστε να μην φορτώνετε χιλιάδες εγγραφές ταυτόχρονα. Είναι απαραίτητο για την απόδοση και τη χρηστικότητα. Το Django παρέχει μια κλάση Paginator για templates/views, και το DRF προσφέρει ενσωματωμένο pagination για APIs.
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 %}
Ο Paginator κόβει ένα queryset σε σελίδες και ο get_page() επιστρέφει ένα page object με βοηθητικές πληροφορίες πλοήγησης (has_next, next_page_number, κτλ.) — σημειώστε ότι προσθέτει LIMIT/OFFSET στο query, ώστε να ανακτάται μόνο μία σελίδα από τη βάση δεδομένων.
# 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 κάνει pagination τα list endpoints αυτόματα μόλις ρυθμιστεί, επιστρέφοντας metadata σελίδας (count, next/previous links) μαζί με τα αποτελέσματα — οι clients πλοηγούνται μέσω των παρεχόμενων URLs.
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.
Το Pagination είναι απαραίτητο για την κατασκευή αποδοτικών και χρήσιμων εφαρμογών που χειρίζονται πραγματικούς όγκους δεδομένων — χωρίς αυτό, τα listing endpoints και οι σελίδες που φορτώνουν ολόκληρους πίνακες (δυνητικά χιλιάδες ή εκατομμύρια σειρές) γίνονται αργές, απαιτούν πολλή μνήμη και είναι αχρήστιμες, τόσο καταπονώντας τη βάση δεδομένων όσο και συντριβάνοντας τους χρήστες και τους clients.
Η κατανόηση του pagination είναι γνώση της καθημερινής πρακτικής: ο Paginator του Django χειρίζεται παραδοσιακές views/templates (κόβοντας querysets σε σελίδες με βοηθητικές πληροφορίες πλοήγησης, ανακτώντας αποδοτικά μόνο μία σελίδα μέσω LIMIT/OFFSET), και το ενσωματωμένο pagination του DRF χειρίζεται APIs (κάνοντας αυτόματα pagination τα list endpoints με metadata και navigation links μόλις ρυθμιστεί) — και τα δύο χρειάζονται ανάλογα με το αν χτίζετε server-rendered σελίδες ή APIs.
Η ικανότητα να εφαρμόσετε pagination και στα δύο περιβάλλοντα είναι απαραίτητη για σχεδόν οποιαδήποτε λειτουργία listing δεδομένων.
Η performance nuance είναι ιδιαίτερα πολύτιμη γνώση σε επίπεδο senior: το τυπικό OFFSET-βασισμένο pagination υποβαθμίζεται σε βαθιές σελίδες πολύ μεγάλων πινάκων (η βάση δεδομένων πρέπει να παραλείψει όλες τις προηγούμενες σειρές), οπότε το cursor (keyset) pagination είναι η αποδοτική επιλογή για τεράστια ή γρήγορα μεταβαλλόμενα σύνολα δεδομένων, και η ταξινόμηση βάσει σταθερού πεδίου είναι απαραίτητη για να αποφύγετε ασυνεπή ή διπλότυπα αποτελέσματα σε σελίδες.
Η κατανόηση τόσο της βασικής μηχανικής (Paginator, DRF pagination classes) όσο και αυτών των ζητημάτων απόδοσης (OFFSET έναντι cursor pagination, συνεπής ταξινόμηση) είναι σημαντική για την κατασκευή εφαρμογών που παραμένουν γρήγορες και σωστές καθώς τα δεδομένα αυξάνονται — το pagination είναι μια παντοχρήστος απαίτηση, και το να το κάνετε καλά, ιδίως σε μεγάλη κλίμακα, είναι μια πρακτική δεξιότητα που επηρεάζει άμεσα την απόδοση της εφαρμογής και την εμπειρία του χρήστη.