Operadores lógicos: $and, $or, $nor, $not
Combine várias condições com operadores lógicos para expressar uma lógica de filtragem composta.
Operadores lógicos: $and, $or, $nor, $not é uma aula grátis de MongoDB Academy no CoddyKit. Esta é a aula 2 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 MongoDB Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MongoDB Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Why Logical Operators Are Needed
Most query filters involve conditions on multiple fields, and not all of them should be combined with a simple AND. Sometimes you want documents that meet any of several conditions, or you want to exclude documents matching a pattern. MongoDB's logical operators—$and, $or, $nor, and $not—give you full boolean control over your filter conditions.
Understanding when to use each operator—and knowing the implicit AND shortcut—makes your queries more readable and performant.
Implicit AND: The Default
When you list multiple field conditions in a single filter object, MongoDB applies them as an implicit AND—all conditions must be true for a document to match. This is the default and most common case.
The implicit AND is both more concise and slightly more efficient than the explicit $and operator because MongoDB can optimize field-level conditions independently. Use implicit AND whenever your conditions target different fields with no ambiguity.
// Implicit AND - all three conditions must be true
db.users.find({
age: { $gte: 18 },
active: true,
role: 'user'
});
// Equivalent to: age >= 18 AND active = true AND role = 'user'
// Same with explicit $and (more verbose, same result)
db.users.find({
$and: [
{ age: { $gte: 18 } },
{ active: true },
{ role: 'user' }
]
});When You Need Explicit $and
Explicit $and is required in one specific situation: when you need to apply multiple conditions to the same field using different operators, and you cannot express them in a single object (because JavaScript objects cannot have duplicate keys).
The most common case is combining two $or conditions that both reference the field. However, range conditions on a single field ({ price: { $gte: 20, $lte: 100 } }) work fine in one object—explicit $and is only needed when the expressions cannot be combined into one field value.
// Explicit $and: two $or conditions that cannot be merged
db.products.find({
$and: [
{ $or: [{ category: 'Electronics' }, { category: 'Computers' }] },
{ $or: [{ brand: 'Apple' }, { brand: 'Samsung' }] }
]
});
// (category is Electronics OR Computers)
// AND (brand is Apple OR Samsung)
// If you just wrote { $or: [...], $or: [...] }
// JS would only keep the last $or!$or: At Least One Condition
$or takes an array of filter conditions and matches documents where at least one of the conditions is true. It is the MongoDB equivalent of SQL's OR keyword.
Use $or when you have alternative paths to the same result—for example, finding users who are either admins or have been active in the last 30 days. One important performance note: if each condition is indexed separately, MongoDB can use index union to satisfy the query—but a single compound index covering all conditions is often faster.
// Find users who are admins OR have been recently active
const recentDate = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
db.users.find({
$or: [
{ role: 'admin' },
{ lastLoginAt: { $gte: recentDate } }
]
});
// Find products on sale OR low in stock
db.products.find({
$or: [
{ onSale: true },
{ stock: { $lt: 5 } }
]
});$nor: None of the Conditions
$nor matches documents where none of the given conditions is true—it is the complement of $or. A document must fail ALL conditions in the $nor array to be returned.
$nor is less common than $or but useful for exclusion logic: 'find products that are neither discontinued nor out of stock nor in the archived category.' It also matches documents where the queried fields are absent, since absent fields do not match any positive condition.
// Exclude multiple status values
db.orders.find({
$nor: [
{ status: 'cancelled' },
{ status: 'refunded' },
{ status: 'archived' }
]
});
// Matches orders where status is NONE of the above
// (equivalent to status NOT IN [...])
// Could also write as:
db.orders.find({ status: { $nin: ['cancelled', 'refunded', 'archived'] } });$not: Negate a Single Operator
$not inverts the result of a single field-level operator expression. Unlike $nor (which takes an array of full filter conditions), $not wraps a single operator or regex: { price: { $not: { $gt: 100 } } }.
$not also matches documents where the field does not exist. It is often redundant with $ne or $nin, but is specifically useful for negating regular expressions: { name: { $not: /^admin/i } }—there is no $ne equivalent for regex patterns.
// $not with a comparison operator
db.products.find({
price: { $not: { $gt: 100 } }
});
// Matches: price <= 100 AND documents where price field is absent
// $not with a regex - negate a pattern
db.users.find({
username: { $not: /^admin/i }
});
// Users whose username does NOT start with 'admin' (case-insensitive)
// Negating $in
db.items.find({
status: { $not: { $in: ['draft', 'archived'] } }
});Combining $and, $or, and $not
Logical operators can be nested to express arbitrarily complex boolean logic. Think of building a logic tree: outer $and conditions are connected at the top level, and $or sub-expressions express alternatives within a branch.
Complex nested boolean queries can be hard to read—consider breaking them into named JavaScript variables or building the filter object programmatically from user input, rather than nesting them five levels deep in one object literal.
// Complex: (premium OR admin) AND (active) AND NOT (suspended)
db.users.find({
$and: [
{ $or: [{ role: 'premium' }, { role: 'admin' }] },
{ active: true },
{ suspended: { $not: { $eq: true } } }
]
});
// Programmatic filter building (cleaner)
const filter = {};
if (roles.length > 0) filter['$or'] = roles.map(r => ({ role: r }));
if (activeOnly) filter.active = true;
db.users.find(filter);$or Performance Considerations
$or queries have specific index usage behavior. MongoDB evaluates each branch of $or independently and merges results:
- If each branch can use an index, MongoDB performs an index union—efficient
- If any branch cannot use an index, MongoDB falls back to a collection scan for that branch—potentially slow
For best performance, ensure every branch of $or has a matching index. When $or conditions can be rewritten as $in on the same field ({ status: { $in: ['a','b'] } }), do so—$in is more efficient than a two-branch $or on the same field.
// Inefficient: $or that prevents index use
db.products.find({
$or: [
{ price: { $lt: 50 } },
{ description: { $regex: 'sale' } } // Regex on unindexed field = COLLSCAN
]
});
// The regex branch causes a full scan for all matched documents
// Better: use $in when possible (same field, multiple values)
db.products.find({ category: { $in: ['A', 'B', 'C'] } });
// Single index lookup is more efficient than 3-branch $orLogical Operators in the Aggregation Pipeline
In aggregation pipeline stages like $match, the same logical operators work exactly as they do in find(). Place $match with your logical conditions as early as possible in the pipeline to reduce the number of documents processed by subsequent stages.
Inside pipeline expression operators (like $project or $addFields), logical operators have a slightly different syntax: { $and: [expr1, expr2] } as expression operators rather than query operators. The query ($match) and expression ($project) contexts use the same operator names but different syntaxes.
// $match with logical operators in an aggregation pipeline
db.orders.aggregate([
{
$match: {
$or: [
{ status: 'shipped' },
{ status: 'delivered' }
],
createdAt: { $gte: new Date('2024-01-01') }
}
},
{ $group: { _id: '$customerId', totalOrders: { $sum: 1 } } }
]);Practical Filter Builder Pattern
In real applications, query filters are often built dynamically from user input (search forms, API query params). Build the filter object programmatically and only add conditions when the parameter is provided—do not add an $or: [] with empty arrays, which would match nothing.
Validate and sanitize all user-provided values before including them in a query. Never pass raw user strings directly to $regex without escaping—an attacker could inject a catastrophically slow regex pattern (ReDoS attack).
function buildProductFilter(params) {
const filter = {};
if (params.categories && params.categories.length > 0) {
filter.category = { $in: params.categories };
}
if (params.minPrice != null) {
filter.price = { ...filter.price, $gte: params.minPrice };
}
if (params.maxPrice != null) {
filter.price = { ...filter.price, $lte: params.maxPrice };
}
if (params.inStockOnly) {
filter.stock = { $gt: 0 };
}
return filter;
}
const results = await db.collection('products')
.find(buildProductFilter(req.query)).toArray();Short-Circuit Evaluation in MongoDB
MongoDB evaluates logical operator expressions but does NOT necessarily short-circuit like JavaScript. The query planner may reorder conditions for efficiency—for example, moving a condition that uses an index before one that does not, regardless of their order in the query document.
One important implication: in , if the first branch causes a full collection scan, the entire query may scan the collection even if the second branch is efficiently indexed. This is why ensuring every branch of is indexed is so critical for performance. Use explain() to verify the execution plan matches your expectations.
// MongoDB may reorder these conditions for efficiency:
db.products.find({
: [
{ category: 'Electronics' }, // If indexed: fast point lookup
{ description: /wireless/i } // Not indexed: slow scan
]
});
// Even though category (indexed) is listed first,
// if MongoDB cannot use index union, it may scan all docs.
// Always verify with .explain('executionStats')Quick Check
Test your understanding of MongoDB & NoSQL Databases concepts from this lesson.
Lesson Recap
In this lesson you learned: implicit AND is the default when listing multiple fields in one filter object—explicit $and is only needed when you cannot express conditions as unique keys (e.g., two $or blocks), $or matches any one condition and uses index union when each branch is indexed, and $not inverts a single operator and is especially useful for negating regex patterns where $ne does not apply. Next up we explore element operators like $exists and $type for handling optional and mixed-type fields.
Perguntas Frequentes
A aula “Operadores lógicos: $and, $or, $nor, $not” é grátis?
Sim — o texto completo de “Operadores lógicos: $and, $or, $nor, $not” é 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 MongoDB Academy, atualize para CoddyKit PRO. O curso de MongoDB Academy inclui 4 aulas no total.
O que vou aprender em “Operadores lógicos: $and, $or, $nor, $not”?
Combine várias condições com operadores lógicos para expressar uma lógica de filtragem composta. Você pratica MongoDB 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 MongoDB Academy?
Nenhuma experiência prévia é necessária. MongoDB 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 2 de 4.
Quanto tempo leva a aula “Operadores lógicos: $and, $or, $nor, $not”?
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 MongoDB Academy?
Sim. Cada aula de MongoDB 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
- Operadores de comparação: $eq, $gt, $lt, $in
- Operadores lógicos: $and, $or, $nor, $not
- Operadores de elementos e verificações de tipo
- Consultas com expressões regulares e correspondência de padrões