Różnica między filtrem a filter_by w SQLAlchemy

Czy ktoś może wyjaśnić różnicę między filteri filter_byfunkcje w SQLAlchemy? Którego powinienem używać?

filter_by służy do prostych zapytań o nazwy kolumn przy użyciu zwykłych kwargs, takich jak

db.users.filter_by(name='Joe')

To samo można osiągnąć filter, nie używając kwargs, ale zamiast tego używając operatora równości „==”, który został przeciążony na obiekcie db.users.name:

db.users.filter(db.users.name=='Joe')

Możesz także pisać bardziej rozbudowane zapytania filter, takie jak wyrażenia takie jak:

db.users.filter(or_(db.users.name=='Ryan', db.users.country=='England'))

Tak naprawdę pierwotnie je scaliliśmy, tzn. Istniała metoda podobna do „filtru”, która zaakceptowała *argsi **kwargs, gdzie można było przekazać wyrażenie SQL lub argumenty słowa kluczowego (lub oba). Uważam, że jest to o wiele wygodniejsze, ale ludzie zawsze byli tym zdezorientowani, ponieważ zwykle wciąż przekraczają różnicę między column == expressioni keyword = expression. Więc podzieliliśmy je.

filter_byużywa argumentów słów kluczowych, natomiast filterpozwala na filtrowanie argumentów pythonicznych, takich jakfilter(User.name=="john")

Jest to cukier składniowy do szybszego pisania zapytań. Jego implementacja w pseudokodzie:

def filter_by(self, **kwargs):
    return self.filter(sql.and_(**kwargs))

Dla AND możesz po prostu napisać:

session.query(db.users).filter_by(name='Joe', surname='Dodson')

btw

session.query(db.users).filter(or_(db.users.name=='Ryan', db.users.country=='England'))

można zapisać jako

session.query(db.users).filter((db.users.name=='Ryan') | (db.users.country=='England'))

Możesz także uzyskać obiekt bezpośrednio przez PK getmetodą:

Users.query.get(123)
# And even by a composite PK
Users.query.get(123, 321)

W getprzypadku użycia przypadku ważne jest, aby obiekt mógł zostać zwrócony bez żądania bazy danych, z identity mapktórego można go wykorzystać jako pamięć podręczną (powiązaną z transakcją)