В MongoDB, $objectToArray
Операторът на конвейера за агрегиране преобразува документ в масив.
Масивът, създаден от $objectToArray
съдържа елемент за всяка двойка поле/стойност в оригиналния документ. Всеки елемент е документ, който съдържа k
поле и v
поле:
k
полето съдържа името на полето в оригиналния документ.v
поле съдържа стойността на полето в оригиналния документ.
Пример
Да предположим, че имаме колекция, наречена dogs
със следния документ:
{ "_id" : 1, "name" : "Fetch", "specs" : { "height" : 400, "weight" : 55, "color" : "brown" } }
Можем да използваме $objectToArray
оператор за връщане на specs
поле като масив:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
).pretty()
Резултат:
{ "result" : [ { "k" : "height", "v" : 400 }, { "k" : "weight", "v" : 55 }, { "k" : "color", "v" : "brown" } ] }
Вложени документи
$objectToArray
операторът се отнася само за полето от най-високо ниво. Не се прилага рекурсивно към вградени документи.
Да предположим, че имаме документ като този:
{ "_id" : 2, "name" : "Wag", "specs" : { "height" : 50, "weight" : 5, "color" : { "eyes" : "brown", "coat" : "black" } } }
Ето какво се случва, когато приложим $objectToArray
към този документ:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 2 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
).pretty()
Резултат:
{ "result" : [ { "k" : "height", "v" : 50 }, { "k" : "weight", "v" : 5 }, { "k" : "color", "v" : { "eyes" : "brown", "coat" : "black" } } ] }
В този случай документът от най-високо ниво се преобразува в k
/v
формат, но вграденият документ остава същият като в оригиналния документ.
Грешен тип
Аргументът, предоставен на $objectToArray
може да бъде всеки валиден израз , стига да се разрешава до обект на документ.
Ако аргументът не се разреши до обект на документ, възниква грешка.
Да предположим, че имаме следния документ:
{ "_id" : 3, "name" : "Fetch", "specs" : "None" }
specs
полето съдържа низ.
Ето какво се случва, когато приложим $objectToArray
към този документ:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 3 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
Резултат:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$objectToArray requires a document input, found: string", "code" : 40390, "codeName" : "Location40390" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:639:17 [email protected]/mongo/shell/assert.js:729:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1058:12 @(shell):1:1
Както гласи грешката, $objectToArray requires a document input
.
Нулеви стойности
Предоставяне на null
води до null
.
Да предположим, че имаме следния документ:
{ "_id" : 4, "name" : "Fetch", "specs" : null }
И ние прилагаме $objectToArray
:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
Резултат:
{ "result" : null }
Липсващи полета
Ако полето липсва, резултатът е null
.
Да предположим, че имаме следния документ:
{ "_id" : 5, "name" : "Fetch" }
И ние прилагаме $objectToArray
:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
Резултат:
{ "result" : null }