Поиск по ключевым словам и пагинация
В этой главе вы научитесь реализовывать комбинированный поиск с SQLAlchemy и использовать offset/limit для пагинации.
ilike поиск без учета регистра
Пример
posts = db.query(Post).filter(Post.title.ilike(f'%{keyword}%')).all()
# Комбинированный поиск по нескольким полям (связь OR)
from sqlalchemy import or_
posts = db.query(Post).filter(
or_(
Post.title.ilike(f'%{keyword}%'),
Post.summary.ilike(f'%{keyword}%')
)
).all()
Пагинация offset/limit
Flask-SQLAlchemy предоставляет удобный.paginate()метод.
FastAPI использует нативный SQLAlchemy, поэтому вам нужно использоватьoffset + limitВручную реализовать пагинацию.
| Метод пагинации | Flask-SQLAlchemy | FastAPI (нативный SQLAlchemy) |
|---|---|---|
| Получить данные текущей страницы | .paginate(page, per_page).items | .offset(skip).limit(per_page).all() |
| Общее количество записей | pagination.total | query.count() |
| Общее количество страниц | pagination.pages | Вручную вычислить math.ceil(total / per_page) |
Формула расчёта пагинации
Пример
from fastapi import Query
def get_pagination(page: int = 1, size: int = 6):
"""
Вычислить параметры пагинации
page: номер текущей страницы (начиная с 1)
size: количество элементов на странице
"""
skip = (page - 1) * size # Количество пропущенных записей
return skip, size
# Пример использования
skip, limit = get_pagination(page=2, size=6)
# skip = 6, limit = 6 → пропустить первые 6, получить элементы 7-12
Полное представление поиска + пагинации
Пример
from sqlalchemy import or_
from math import ceil
from fastapi import APIRouter, Depends, Request, Запрос
@router.get("/", name="index")
def index(
request: Request,
category: str | None = Query(None),
q: str | None = Query(None, description=“Ключевые слова для поиска”),
page: int = Query(1, ge=1, description="Номер страницы"),
size: int = Query(6, ge=1, le=50, description="Элементов на страницу"),
db: Session = Depends(get_db)
):
"""Главная: фильтрация по категориям + поиск по ключевым словам + пагинация"""
posts_query = db.query(Post).order_by(Post.created_at.desc())
# Фильтр по категории
if category:
posts_query = posts_query.join(Category).filter(Category.slug == category)
# Поиск по ключевым словам
if q:
keyword = f'%{q.strip()}%'
posts_query = posts_query.filter(
or_(
Post.title.ilike(keyword),
Post.summary.ilike(keyword)
)
)
# Пагинация
total = posts_query.count()
total_pages = ceil(total / size)
skip = (page - 1) * size
posts = posts_query.offset(skip).limit(size).all()
return templates.TemplateResponse("index.html", {
"request": request,
"posts": posts,
"categories": db.query(Category).all(),
"category_slug": category or "",
"keyword": q или "",
"page": page,
"total_pages": total_pages,
"total": total
})
Query(1, ge=1)inge— это сокращение для «больше или равно». Параметры запроса FastAPI поддерживают полный набор числовых ограничений: ge, le, gt, lt. Если пользователь передаст page=0, FastAPI автоматически вернёт ошибку 422.
Навигация по страницам в шаблонах
Пример
{% if total_pages > 1 %}
<div class="pagination">
{% if page > 1 %}
<a href="/?page={{ page - 1 }}&category={{ category_slug }}&q={{ keyword }}">← Предыдущая страница</a>
{% endif %}
<span class="page-info">Страница {{ page }} / {{ total_pages }} страниц</span>
{% if page < total_pages %}
<a href="/?page={{ page + 1 }}&category={{ category_slug }}&q={{ keyword }}">Следующая страница →</a>
{% endif %}
</div>
{% endif %}
Итоги главы
В этой главе вы реализовали практические функции для страницы списка: поиск ilike без учёта регистра, комбинированный поиск по нескольким полям с or_(), ручная пагинация offset/limit (заменяющая Flask's paginate) и Query() для ограничения диапазонов параметров запроса.
Поиск + фильтрация по категориям + пагинация можно комбинировать в любом порядке, и условия не потеряются.
Другие расширения