Pagination membagi hasil dalam jumlah besar menjadi halaman-halaman terpisah, sehingga Anda tidak memuat ribuan records sekaligus. Ini sangat penting untuk performa dan usability. Django menyediakan kelas Paginator untuk templates/views, dan DRF menawarkan built-in pagination untuk 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 %}
Paginator memotong queryset menjadi halaman-halaman dan get_page() mengembalikan page object dengan navigation helpers (has_next, next_page_number, dll.) — catat bahwa ini menambahkan LIMIT/OFFSET ke query, jadi hanya satu halaman yang diambil dari database.
# 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 melakukan pagination list endpoints secara otomatis setelah dikonfigurasi, mengembalikan page metadata (count, next/previous links) bersama dengan hasil — clients menavigasi melalui URL yang disediakan.
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 sangat penting untuk membangun aplikasi yang performan dan usable yang menangani volume data nyata — tanpanya, list endpoints dan halaman yang memuat seluruh tabel (berpotensi ribuan atau jutaan baris) menjadi lambat, memory-intensive, dan tidak dapat digunakan, baik membebani database maupun membanjiri users dan clients.
Memahami pagination adalah practical knowledge sehari-hari: Paginator Django menangani traditional views/templates (memotong querysets menjadi halaman dengan navigation helpers, efficiently mengambil hanya satu halaman melalui LIMIT/OFFSET), dan built-in pagination DRF menangani APIs (secara otomatis melakukan pagination list endpoints dengan metadata dan navigation links setelah dikonfigurasi) — keduanya diperlukan tergantung pada apakah Anda membangun server-rendered pages atau APIs.
Mengetahui cara mengimplementasikan pagination di kedua konteks adalah necessary untuk hampir semua data-listing feature.
Performance nuance adalah particularly valuable senior-level knowledge: standard OFFSET-based pagination merosot pada deep pages dari very large tables (database harus skip semua preceding rows), jadi cursor (keyset) pagination adalah efficient choice untuk huge atau rapidly-changing datasets, dan selalu ordering by a stable field diperlukan untuk menghindari inconsistent atau duplicated results across pages.
Memahami kedua-duanya, basic mechanics (Paginator, DRF pagination classes) dan performance considerations ini (OFFSET vs cursor pagination, consistent ordering), penting untuk membangun aplikasi yang tetap cepat dan correct saat data berkembang — pagination adalah ubiquitous requirement, dan melakukannya dengan baik, terutama dalam skala besar, adalah practical skill yang secara langsung mempengaruhi application performance dan user experience.