В 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 :
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:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/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 }