Di MongoDB, $or
operator pipeline agregasi mengevaluasi satu atau beberapa ekspresi dan mengembalikan true
jika ada evaluasi ke true
. Jika tidak, ia mengembalikan false
.
Sintaks
Sintaksnya seperti ini:
{ $or: [ <expression1>, <expression2>, ... ] }
Contoh
Misalkan kita memiliki koleksi yang disebut data
dengan dokumen berikut:
{ "_id" : 1, "a" : 10, "b" : 2, "c" : 20 }
Inilah yang terjadi ketika kita menggunakan $or
untuk menguji dua kondisi terhadap dokumen itu:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] },
{ $lt: [ "$b", 1 ] }
] }
}
}
]
)
Hasil:
{ "a" : 10, "b" : 2, "result" : true }
Kita dapat melihat bahwa $or
mengembalikan true
, meskipun salah satu ekspresi berubah menjadi false
. Ini karena mengembalikan true
jika ada ekspresi adalah true
.
Ini dia lagi, tetapi dengan kedua ekspresi berubah menjadi false
.
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [
{ $gt: [ "$a", 20 ] },
{ $lt: [ "$b", 1 ] }
] }
}
}
]
)
Hasil:
{ "a" : 10, "b" : 2, "result" : false }
Lebih dari Dua Argumen
Seperti disebutkan, $or
menerima satu atau lebih ekspresi. Contoh sebelumnya menggunakan dua ekspresi. Berikut ini contoh yang menggunakan tiga:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
c: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] },
{ $lt: [ "$b", 3 ] },
{ $gt: [ "$c", 30 ] }
] }
}
}
]
)
Hasil:
{ "a" : 10, "b" : 2, "c" : 20, "result" : true }
Dalam hal ini hasilnya adalah true
, meskipun nilai ketiga bernilai false
.
Satu Argumen
Mengingat $or
menerima satu atau lebih ekspresi, dimungkinkan untuk memberikan satu argumen.
Contoh:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] }
] }
}
}
]
)
Hasil:
{ "a" : 10, "result" : true }
Nilai Nol, Null, dan Tidak Terdefinisi
$or
operator mengevaluasi 0
, null
, dan undefined
sebagai false
.
Misalkan kita memiliki dokumen berikut:
{ "_id" : 2, "a" : 0, "b" : 2 } { "_id" : 3, "a" : 10, "b" : 0 } { "_id" : 4, "a" : 0, "b" : 0 } { "_id" : 5, "a" : null, "b" : 2 } { "_id" : 6, "a" : 10, "b" : null } { "_id" : 7, "a" : null, "b" : null } { "_id" : 8, "a" : undefined, "b" : 2 } { "_id" : 9, "a" : 10, "b" : undefined } { "_id" : 10, "a" : undefined, "b" : undefined }
Inilah yang terjadi ketika kita menerapkan $or
:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ] } } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [ "$a", "$b" ] } }
}
]
)
Hasil:
{ "a" : 0, "b" : 2, "result" : true } { "a" : 10, "b" : 0, "result" : true } { "a" : 0, "b" : 0, "result" : false } { "a" : null, "b" : 2, "result" : true } { "a" : 10, "b" : null, "result" : true } { "a" : null, "b" : null, "result" : false } { "a" : undefined, "b" : 2, "result" : true } { "a" : 10, "b" : undefined, "result" : true } { "a" : undefined, "b" : undefined, "result" : false }
Di sini, saya hanya menggunakan bidang sebagai ekspresi.
Berikut tampilannya saat kita menerapkan hanya satu argumen ke kolom yang berisi 0
, null
, dan undefined
:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 4, 7, 10 ] } } },
{ $project: {
_id: 0,
a: 1,
result: { $or: [ "$a" ] } }
}
]
)
Hasil:
{ "a" : 0, "result" : false } { "a" : null, "result" : false } { "a" : undefined, "result" : false }
Semua bidang mengembalikan false
.
Panggil $or
tanpa Argumen
Saat dipanggil tanpa argumen, $or
operator mengevaluasi ke false
.
Contoh:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $or: [ ] } }
}
]
)
Hasil:
{ "result" : false }