Di MongoDB, $in operator pipa agregasi mengembalikan boolean yang menunjukkan apakah nilai yang ditentukan ada dalam larik.
$in operator pipa agregasi jangan bingung dengan $in operator kueri, yang memilih dokumen yang nilai bidangnya sama dengan nilai apa pun dalam larik yang ditentukan.
Contoh
Misalkan kita memiliki koleksi yang disebut products dengan dokumen sebagai berikut:
{ "_id" : 1, "prod" : "Bat", "sizes" : [ "S", "M", "XL", "XXL" ] }
{ "_id" : 2, "prod" : "Hat", "sizes" : [ "S", "L", "XL" ] }
{ "_id" : 3, "prod" : "Cap", "sizes" : [ "XS", "S", "M", "L", "XL" ] }
Kita dapat menggunakan $in operator untuk mengetahui apakah sizes kolom berisi nilai L .
Contoh:
db.products.aggregate(
[
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
) Hasil:
{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : true }
{ "_id" : 3, "hasLarge" : true } Argumen Kedua Harus Diselesaikan ke Array
Argumen kedua dari $in operator harus menyelesaikan ke array. Jika tidak, kesalahan akan ditampilkan.
Misalkan kita menambahkan dokumen berikut ke koleksi:
{ "_id" : 4, "prod" : "Shirt", "sizes" : "L" }
Perhatikan bahwa sizes field bukan array – ini adalah string.
Ayo terapkan $in ke dokumen itu:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
) Hasil:
Error: command failed: {
"ok" : 0,
"errmsg" : "$in requires an array as a second argument, found: string",
"code" : 40081,
"codeName" : "Location40081"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1
Dalam hal ini, sizes bidang berisi string., dan oleh karena itu kesalahan dikembalikan.
Dalam contoh ini, saya juga menggunakan $in dengan $match operator untuk memfilter dokumen hanya yang saya minati. Perhatikan bahwa ini menggunakan $in sintaks operator kueri, yang menerima satu argumen, dan tidak bingung dengan sintaks dua argumen.
Nilai Null
Hal yang sama akan terjadi jika argumen kedua adalah null .
Mari tambahkan dokumen berikut ke koleksi:
{ "_id" : 5, "prod" : "Jeans", "sizes" : null }
Inilah yang terjadi jika kita mencoba menggunakan $in dengan dokumen itu:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
) Hasil:
Error: command failed: {
"ok" : 0,
"errmsg" : "$in requires an array as a second argument, found: null",
"code" : 40081,
"codeName" : "Location40081"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
DB.prototype._runAggregaexample@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1 Kesalahan yang sama.
Bidang Tidak Ada
Sama halnya dengan bidang yang hilang.
Misalkan kita menambahkan dokumen berikut ke koleksi kita:
{ "_id" : 6, "prod" : "Shorts" }
Dan sekarang kami mencoba menerapkan $in ke (tidak ada) sizes bidang:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
) Hasil:
Error: command failed: {
"ok" : 0,
"errmsg" : "$in requires an array as a second argument, found: missing",
"code" : 40081,
"codeName" : "Location40081"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1 Ekspresi Reguler
Berbeda dengan $in operator kueri, $in operator pipa agregasi tidak mendukung penggunaan ekspresi reguler.
Oleh karena itu, kode berikut tidak menghasilkan kecocokan:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
hasLarge: { $in: [ /^X/, "$sizes" ] }
}
}
]
) Hasil:
{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : false }
{ "_id" : 3, "hasLarge" : false }
Hasil untuk semua dokumen adalah false , meskipun sizes bidang di ketiga dokumen memang berisi elemen larik yang dimulai dengan huruf besar X .