Django Academy · Aula

Objetos Q para filtros complexos

Combine condições com AND, OR e NOT

Objetos Q para filtros complexos é uma aula grátis de Django Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Django Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Django Academy inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Beyond Simple filter()

Stacking keyword arguments in filter always means AND. To express OR or NOT, you need a richer tool.

Meet the Q Object

A Q object wraps a condition so you can combine conditions with boolean operators inside a single query.

from django.db.models import Q

OR with the Pipe

Combine two Q objects with the pipe operator to build an OR, matching rows that satisfy either condition.

Book.objects.filter(Q(title__icontains="django") | Q(title__icontains="flask"))

AND with the Ampersand

The ampersand joins Q objects with AND, useful when you want explicit grouping rather than plain keyword stacking.

Book.objects.filter(Q(price__lt=20) & Q(in_stock=True))

Negate with the Tilde

Put a tilde in front of a Q object to express NOT, matching every row that fails the condition.

Book.objects.filter(~Q(author__name="Anon"))

Mixing Q and Keywords

You may pass Q objects and plain keyword arguments together, but every positional Q must come before any keyword.

Book.objects.filter(Q(price__lt=20) | Q(on_sale=True), in_stock=True)

Grouping with Parentheses

Wrap combined Q objects in parentheses to control precedence, just like grouping conditions in raw SQL.

Book.objects.filter((Q(a=1) | Q(b=2)) & Q(c=3))

Build Filters Dynamically

Because Q objects are values, you can build them up conditionally in Python before passing the result to filter.

q = Q(active=True)
if term:
    q &= Q(name__icontains=term)
User.objects.filter(q)

Combine Many with reduce

Need an OR across a list of terms? Fold them together with operator.or_ to produce one combined Q.

from functools import reduce
import operator
reduce(operator.or_, [Q(tag=t) for t in tags])

Still One SQL Query

However complex the logic, Django compiles your Q tree into a single WHERE clause, so there is no extra round trip.

When to Use Q

Reach for Q whenever a filter needs OR, NOT, or logic assembled at runtime; plain keywords stay fine for simple ANDs.

Quick Check

You want books whose title contains django OR flask. Which filter expresses that?

Recap

Q objects unlock OR, AND, and NOT logic you can group and build dynamically, all compiled into one query. 🧩

Perguntas Frequentes

A aula “Objetos Q para filtros complexos” é grátis?

Sim — o texto completo de “Objetos Q para filtros complexos” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Django Academy, atualize para CoddyKit PRO. O curso de Django Academy inclui 4 aulas no total.

O que vou aprender em “Objetos Q para filtros complexos”?

Combine condições com AND, OR e NOT Você pratica Django Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Django Academy?

Nenhuma experiência prévia é necessária. Django Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.

Quanto tempo leva a aula “Objetos Q para filtros complexos”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Django Academy?

Sim. Cada aula de Django Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Django Academy