0

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?

1 Resposta 1

2

filter

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

Qual a diferença entre eles?

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.


Leituras recomendadas

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .