Пагинация разделяет большой набор результатов на отдельные страницы, чтобы не загружать сразу тысячи записей. Это критично для производительности и удобства использования. Django предоставляет класс Paginator для представлений/шаблонов, а DRF предлагает встроенную пагинацию для API.
# ❌ 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 разбивает queryset на страницы, а get_page() возвращает объект страницы с вспомогательными функциями навигации (has_next, next_page_number и т. д.) — учтите, что он добавляет LIMIT/OFFSET в запрос, поэтому из базы данных загружается только одна страница.
# 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 автоматически пагинирует list endpoints после настройки, возвращая метаданные страницы (count, ссылки next/previous) наряду с результатами — клиенты навигируют через предоставленные URL.
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.
Пагинация необходима для построения производительных и удобных приложений, которые работают с реальными объёмами данных — без неё endpoints листинга и страницы, загружающие целые таблицы (потенциально тысячи или миллионы строк), становятся медленными, требуют много памяти и неудобны в использовании, одновременно перегружая базу данных и пользователей с клиентами.
Понимание пагинации — это повседневное практическое знание: Paginator в Django справляется с традиционными представлениями/шаблонами (разбивает querysets на страницы с вспомогательными функциями навигации, эффективно загружая только одну страницу через LIMIT/OFFSET), а встроенная пагинация DRF справляется с API (автоматически пагинирует list endpoints с метаданными и ссылками навигации после настройки) — оба нужны в зависимости от того, строите ли вы серверные страницы или API.
Умение реализовать пагинацию в обоих контекстах необходимо практически для любой функции листинга данных.
Нюанс производительности — особенно ценное знание уровня senior: стандартная OFFSET-based пагинация деградирует на глубоких страницах очень больших таблиц (база данных должна пропустить все предыдущие строки), поэтому cursor (keyset) пагинация — эффективный выбор для огромных или быстро меняющихся наборов данных, и всегда необходимо сортировать по стабильному полю, чтобы избежать несогласованных или дублирующихся результатов на разных страницах.
Понимание как базовых механик (Paginator, классы пагинации DRF), так и соображений производительности (OFFSET vs cursor пагинация, консистентная сортировка) важно для создания приложений, которые остаются быстрыми и корректными при росте данных — пагинация — повсеместное требование, и её правильная реализация, особенно в масштабе, — это практический навык, который напрямую влияет на производительность приложения и пользовательский опыт.