Schlagwortsuche und Paginierung

In diesem Kapitel lernst du, wie du die kombinierte Suche mit SQLAlchemy implementierst und offset/limit für die Paginierung verwendest.


ilike-Suche ohne Beachtung der Groß-/Kleinschreibung

Beispiel

# Einzelfeldsuche
posts = db.query(Post).filter(Post.title.ilike(f'%{keyword}%')).all()

# Kombinierte Suche über mehrere Felder (ODER-Beziehung)
from sqlalchemy import or_
posts = db.query(Post).filter(
    or_(
        Post.title.ilike(f'%{keyword}%'),
        Post.summary.ilike(f'%{keyword}%')
    )
).all()

offset/limit-Paginierung

Flask-SQLAlchemy bietet eine komfortable.paginate()Methode.

FastAPI verwendet natives SQLAlchemy, daher müssen Sieoffset + limitverwenden. Paginierung manuell implementieren.

PaginierungsmethodeFlask-SQLAlchemyFastAPI (native SQLAlchemy)
Aktuelle Seitendaten abrufen.paginate(page, per_page).items.offset(skip).limit(per_page).all()
Gesamtzahl der Datensätzepagination.totalquery.count()
Gesamtzahl der Seitenpagination.pagesManuell berechnen math.ceil(total / per_page)

Berechnungsformel für die Paginierung

Beispiel

import math
from fastapi import Query

def get_pagination(page: int = 1, size: int = 6):
    """
Paginierungsparameter berechnen
page: aktuelle Seitennummer (beginnend bei 1)
size: Anzahl der Elemente pro Seite
    """

    skip = (page - 1) size    # Übersprungene Anzahl
    return skip, size

# Verwendungsbeispiel
skip, limit = get_pagination(page=2, size=6)
# skip = 6, limit = 6 → die ersten 6 überspringen, Elemente 7-12 abrufen

Vollständige Suche + Paginierungsansicht

Beispiel

# Dateipfad: routers/posts.py (erweitert die Index-Route)
from sqlalchemy import or_
from math import ceil
from fastapi import APIRouter, Depends, Request, Abfrage

@router.get("/", name="index")
def index(
    request: Request,
    category: str | None = Query(None),
    q: str | None = Query(None, description=“Suchbegriffe”),
    page: int = Query(1, ge=1, description="Seitennummer"),
    size: int = Query(6, ge=1, le=50, description="Elemente pro Seite"),
    db: Session = Depends(get_db)
):
    """Startseite: Kategoriefilter + Stichwortsuche + Paginierung"""
    posts_query = db.query(Post).order_by(Post.created_at.desc())

    # Kategoriefilter
    if category:
        posts_query = posts_query.join(Category).filter(Category.slug == category)

    # Stichwortsuche
    if q:
        keyword = f'%{q.strip()}%'
        posts_query = posts_query.filter(
            or_(
                Post.title.ilike(keyword),
                Post.summary.ilike(keyword)
            )
        )

    # Paginierung
    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 oder "",
        "page": page,
        "total_pages": total_pages,
        "total": total
    })

Query(1, ge=1)ingeist die Abkürzung für größer oder gleich. FastAPIs Query-Parameter unterstützen vollständige numerische Einschränkungen: ge, le, gt, lt. Wenn ein Benutzer page=0 übergibt, gibt FastAPI automatisch einen 422-Fehler zurück.


Paginierungsnavigation in Templates

Beispiel

<!-- Paginierungsnavigation unter der Artikelliste in index.html anhängen -->
{% if total_pages > 1 %}
<div class="pagination">
    {% if page > 1 %}
    <a href="/?page={{ page - 1 }}&category={{ category_slug }}&q={{ keyword }}">← Vorherige Seite</a>
    {% endif %}

    <span class="page-info">Seite {{ page }} / {{ total_pages }} Seiten</span>

    {% if page < total_pages %}
   <a href="/?page={{ page + 1 }}&category={{ category_slug }}&q={{ keyword }}">Nächste Seite →</a>
    {% endif %}
</div>
{% endif %}

Kapitelzusammenfassung

In diesem Kapitel haben Sie praktische Funktionen für die Listenseite implementiert: ilike-Suche ohne Beachtung der Groß-/Kleinschreibung, or_() kombinierte Suche über mehrere Felder, manuelle offset/limit-Paginierung (ersetzt Flasks paginate) und Query() zur Einschränkung von Abfrageparameterbereichen.

Suche + Kategoriefilterung + Paginierung können in beliebiger Reihenfolge kombiniert werden, und die Bedingungen gehen nicht verloren.

Weitere Erweiterungen