Sayfalandırma, büyük bir sonuç setini ayrık sayfalar halinde böler, böylece binlerce kaydı bir seferde yüklemezsiniz. Performans ve kullanılabilirlik açısından gereklidir. Django, şablonlar/görünümler için Paginator sınıfı sağlar ve DRF, API'ler için yerleşik sayfalandırma sunar.
# ❌ 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, bir queryset'i sayfalar halinde böler ve get_page() bir sayfa nesnesi döndürür ve bu nesne navigasyon yardımcılarına sahiptir (has_next, next_page_number, vb.) — bunu not edin, sorguya LIMIT/OFFSET ekler, bu nedenle veritabanından sadece bir sayfa getirilir.
# 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, yapılandırıldığında liste uç noktalarını otomatik olarak sayfalandırır ve sayfa meta verileri (sayı, sonraki/önceki bağlantılar) sonuçlarla birlikte döndürür — istemciler sağlanan URL'ler aracılığıyla gezinir.
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.
Sayfalandırma, gerçek veri hacimleriyle başa çıkan performanslı, kullanılabilir uygulamalar oluşturmak için gereklidir — olmadan, liste uç noktaları ve tüm tabloları yükleyen sayfalar (potansiyel olarak binlerce veya milyonlarca satır) yavaş, bellek yoğun ve kullanılamaz hale gelir, hem veritabanına yük bindirir hem de kullanıcıları ve istemcileri bunaltır.
Sayfalandırmayı anlamak günlük pratik bilgidir: Django'nun Paginator'ü geleneksel görünümleri/şablonları işler (queryset'leri sayfalar halinde böler ve navigasyon yardımcılarıyla, LIMIT/OFFSET aracılığıyla verimli bir şekilde sadece bir sayfayı getirir) ve DRF'nin yerleşik sayfalandırması API'leri işler (yapılandırıldığında liste uç noktalarını otomatik olarak meta veri ve navigasyon bağlantılarıyla sayfalandırır) — her ikisi de sunucu tarafında render edilen sayfalar mı yoksa API'ler mi oluşturduğunuza bağlı olarak gereklidir.
Her iki bağlamda da sayfalandırmayı uygulamayı bilmek, neredeyse her veri listeleme özelliği için gereklidir.
Performans nüansı, özellikle üst düzey bilgidir: standart OFFSET tabanlı sayfalandırma, çok büyük tabloların derin sayfalarında kötüleşir (veritabanı önceki tüm satırları atlamalıdır), bu nedenle imleç (keyset) sayfalandırması çok büyük veya hızla değişen veri setleri için verimli seçimdir ve her zaman kararlı bir alana göre sıralama sayfalar arasında tutarsız veya tekrarlanan sonuçlar önlemek için gereklidir.
Hem temel mekanikler (Paginator, DRF sayfalandırma sınıfları) hem de bu performans değerlendirmeleri (OFFSET vs imleç sayfalandırması, tutarlı sıralama) anlamak, veriler büyüdüğünde hızlı ve doğru kalan uygulamalar oluşturmak için önemlidir — sayfalandırma, her yerde bulunan bir gereksinimdir ve bunu iyi yapma, özellikle ölçekte, uygulama performansını ve kullanıcı deneyimini doğrudan etkileyen pratik bir yetenektir.