I MongoDB, $arrayToObject aggregeringspipeline-operatör konverterar en array till ett dokument.
Arrayen som tillhandahålls till $arrayToObject måste vara i något av följande två format:
- En matris med tvåelementsmatriser där det första elementet är fältnamnet och det andra elementet är fältvärdet.
- En uppsättning dokument som innehåller en
koch envfältet, därkfältet innehåller fältnamnet ochvfältet innehåller värdet.
Format 1
Anta att vi har en samling som heter test med följande dokument:
{
"_id" : 1,
"data" : [
[
"name",
"Fetch"
],
[
"type",
"Dog"
]
]
}
Vi kan använda $arrayToObject operatör för att returnera data fält som ett dokumentobjekt:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
{ "result" : { "name" : "Fetch", "type" : "Dog" } } Format 2
Anta att vi har ett dokument som detta:
{
"_id" : 2,
"data" : [
{
"k" : "name",
"v" : "Fetch"
},
{
"k" : "type",
"v" : "Dog"
}
]
}
I det här fallet är k fälten innehåller nycklarna och v fälten innehåller värdena.
Här är vad som händer när vi använder $arrayToObject till det dokumentet:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 2 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
{ "result" : { "name" : "Fetch", "type" : "Dog" } } Vi kan se att detta resulterade i samma dokument som producerades i föregående exempel.
Icke-överensstämmande matriser
Argumentet som tillhandahålls till $arrayToObject kan vara vilket giltigt uttryck som helst så länge det löser sig till en array av tvåelements arrayer eller array av dokument som innehåller k och v fält.
Om argumentet inte följer detta, uppstår ett fel.
Anta att vi har följande dokument:
{ "_id" : 3, "data" : [ [ "name", "Fetch", "Dog" ] ] } Denna array innehåller tre element.
Här är vad som händer när vi använder $arrayToObject till det dokumentet:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 3 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
uncaught exception: Error: command failed: {
"ok" : 0,
"errmsg" : "$arrayToObject requires an array of size 2 arrays,found array of size: 3",
"code" : 40397,
"codeName" : "Location40397"
} : 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
Som felet anger kräver $arrayToObject requires an array of size 2 arrays .
Här är ett annat dokument som innehåller en icke-överensstämmande array:
{ "_id" : 4, "data" : [ { "a" : "name", "b" : "Fetch" } ] }
I det här fallet använder dokumentet i arrayen a och b fält istället för k och v .
Här är vad som händer när vi använder $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
uncaught exception: Error: command failed: {
"ok" : 0,
"errmsg" : "$arrayToObject requires an object with keys 'k' and 'v'. Missing either or both keys from: {a: \"name\", b: \"Fetch\"}",
"code" : 40393,
"codeName" : "Location40393"
} : 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
I det här fallet anger felet att $arrayToObject requires an object with keys 'k' and 'v' .
Fel typ
På samma sätt, om argumentet inte ens är en array, uppstår ett fel.
Anta att vi har följande dokument:
{ "_id" : 5, "data" : "None" }
data fältet innehåller en sträng.
Här är vad som händer när vi använder $arrayToObject till det dokumentet:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
uncaught exception: Error: command failed: {
"ok" : 0,
"errmsg" : "$arrayToObject requires an array input, found: string",
"code" : 40386,
"codeName" : "Location40386"
} : 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
Som felet säger kräver $arrayToObject requires an array input .
Nullvärden
Tillhandahåller null resulterar i null .
Anta att vi har följande dokument:
{ "_id" : 6, "data" : null }
Och vi tillämpar $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
{ "result" : null } Fält saknas
Om fältet saknas är resultatet null .
Anta att vi har följande dokument:
{ "_id" : 7 }
Och vi tillämpar $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 7 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultat:
{ "result" : null } Upprepade fältnamn
Enligt MongoDB-dokumentationen, om namnet på ett fält upprepas i arrayen:
- Från och med 4.0.5,
$arrayToObjectanvänder det sista värdet för det fältet. För 4.0.0-4.0.4 beror värdet som används på drivrutinen. - Från och med 3.6.10
$arrayToObjectanvänder det sista värdet för det fältet. För 3.6.0-3.6.9 beror värdet som används på drivrutinen. - Från och med 3.4.19
$arrayToObjectanvänder det sista värdet för det fältet. För 3.4.0-3.4.19 beror värdet som används på drivrutinen.