Existe alguma diferença entre a função filter
e filter_by
no SQLalchemy?
Se existe, quando devo usar cada uma delas de forma adequada?
Stack Overflow em Português é um site de perguntas e respostas para programadores profissionais e entusiastas. Leva apenas um minuto para se inscrever.
Inscreva-se para participar desta comunidadefilter
Se você verificar a documentação do método Query.filter(*criterions)
verá que ele recebe um número variável de parâmetros posicionais. Exemplos de uso seriam:
session.query(MyClass).filter(MyClass.name == 'some name')
session.query(MyClass).filter(MyClass.name == 'some name', MyClass.id > 5)
session.query(MyClass).filter(MyClass.name == 'some name',
MyClass.id > 5,
MyClass.other == 'teste')
Como você pode verificar, Query.filter
receberá uma sequência com os critérios de pesquisa.
filter_by
Agora, verificando a documentação do método Query.filter_by(**kwargs)
você já pode notar que ele recebe uma quantidade variável de parâmetros nomeados. Alguns exemplos de uso:
session.query(MyClass).filter_by(name='some name')
session.query(MyClass).filter_by(name='some name', id=5)
session.query(MyClass).filter_by(name='some name', id=5, other='teste')
A principal diferença é que filter
trabalha com expressões SQL e filter_by
trabalha apenas com a igualdade entre as chave e valores de seus argumentos.
Na prática, filter_by
só trabalha com comparação de igualdade entre as chaves e seus valores, enquanto filter
pode trabalhar com operadores mais versáteis.
session.query(MyClass).filter(MyClass.name == 'some name')
# seria o mesmo que
session.query(MyClass).filter_by(name='some name')
# Não possuem versão compatível usando `filter_by`
session.query(MyClass).filter(MyClass.id < 5)
session.query(MyClass).filter(MyClass.id != 8)
Isso se comprova quando você olha o código do método Query.filter_by
:
class Query(Generative):
def filter(self, *criterion):
...
def filter_by(self, **kwargs):
clauses = [
_entity_descriptor(self._joinpoint_zero(), key) == value
for key, value in kwargs.items()
]
return self.filter(*clauses)
Veja que o filter_by
por debaixo dos panos transforma os argumentos nomeados em expressões SQL de igualdade e passa para filter
.