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
k
och env
fältet, därk
fältet innehåller fältnamnet ochv
fä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 : [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
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 : [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
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 : [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
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,
$arrayToObject
anvä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
$arrayToObject
anvä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
$arrayToObject
anvä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.