Різниця між filter і filter_by в SQLAlchemy

Чи може хтось пояснити різницю між функціями filterта filter_byфункціями в SQLAlchemy? Яким я повинен користуватися?

filter_by використовується для простих запитів до імен стовпців, використовуючи звичайні kwargs, наприклад

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

Те ж саме можна зробити і з filterвикористанням не kwargs, а замість цього оператора рівності '==', який був перевантажений об'єктом db.users.name:

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

Ви також можете писати більш потужні запити, використовуючи filterтакі вирази, як:

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

Ми насправді їх спочатку об'єднали разом, тобто був метод, подібний до фільтру, який прийняв, *argsі **kwargsде можна було передавати аргументи SQL або ключові слова (або обидва). Я насправді вважаю це набагато зручнішим, але люди завжди збентежили це, оскільки вони зазвичай все ще долають різницю між column == expressionі keyword = expression. Тому ми їх розкололи.

filter_byвикористовує аргументи ключових слів, тоді як filterдозволяє пітонічні фільтруючі аргументи типуfilter(User.name=="john")

Це синтаксичний цукор для швидшого написання запиту. Її реалізація в псевдокоді:

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

Для І ви можете просто написати:

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'))

можна записати як

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

Також ви можете отримати об'єкт безпосередньо ПК через getметод:

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

При використанні getвипадку важливо, щоб об'єкт можна було повернути без запиту бази даних, з identity mapякого можна використовувати кеш (пов'язаний з транзакцією)