In MongoDB ist das $arrayToObject
Der Aggregations-Pipeline-Operator konvertiert ein Array in ein Dokument.
Das für $arrayToObject
bereitgestellte Array muss in einem der beiden folgenden Formate vorliegen:
- Ein Array aus Arrays mit zwei Elementen, wobei das erste Element der Feldname und das zweite Element der Feldwert ist.
- Ein Array von Dokumenten, die ein
k
enthalten Feld und einv
Feld, wo dask
field enthält den Feldnamen und denv
Feld enthält den Wert.
Format 1
Angenommen, wir haben eine Sammlung namens test
mit folgendem Dokument:
{ "_id" : 1, "data" : [ [ "name", "Fetch" ], [ "type", "Dog" ] ] }
Wir können das $arrayToObject
verwenden -Operator, um die data
zurückzugeben Feld als Dokumentobjekt:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
{ "result" : { "name" : "Fetch", "type" : "Dog" } }
Format 2
Angenommen, wir haben ein Dokument wie dieses:
{ "_id" : 2, "data" : [ { "k" : "name", "v" : "Fetch" }, { "k" : "type", "v" : "Dog" } ] }
In diesem Fall das k
Felder enthalten die Schlüssel und den v
Felder enthalten die Werte.
Folgendes passiert, wenn wir $arrayToObject
anwenden zu diesem Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 2 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
{ "result" : { "name" : "Fetch", "type" : "Dog" } }
Wir können sehen, dass dies zu demselben Dokument führte, das im vorherigen Beispiel erstellt wurde.
Nicht konforme Arrays
Das für $arrayToObject
bereitgestellte Argument kann ein beliebiger gültiger Ausdruck sein, solange er in ein Array von Arrays mit zwei Elementen oder ein Array von Dokumenten aufgelöst wird, das k
enthält und v
Felder.
Hält sich das Argument nicht daran, tritt ein Fehler auf.
Angenommen, wir haben das folgende Dokument:
{ "_id" : 3, "data" : [ [ "name", "Fetch", "Dog" ] ] }
Dieses Array enthält drei Elemente.
Folgendes passiert, wenn wir $arrayToObject
anwenden zu diesem Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 3 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
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
Wie der Fehler besagt, erfordert $arrayToObject requires an array of size 2 arrays
.
Hier ist ein weiteres Dokument, das ein nicht konformes Array enthält:
{ "_id" : 4, "data" : [ { "a" : "name", "b" : "Fetch" } ] }
In diesem Fall verwendet das Dokument innerhalb des Arrays a
und b
Felder statt k
und v
.
Folgendes passiert, wenn wir $arrayToObject
anwenden :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
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
In diesem Fall besagt der Fehler, dass $arrayToObject requires an object with keys 'k' and 'v'
.
Falscher Typ
Ebenso tritt ein Fehler auf, wenn das Argument nicht einmal ein Array ist.
Angenommen, wir haben das folgende Dokument:
{ "_id" : 5, "data" : "None" }
Die data
Feld enthält eine Zeichenkette.
Folgendes passiert, wenn wir $arrayToObject
anwenden zu diesem Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
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
Wie der Fehler besagt, erfordert $arrayToObject requires an array input
.
Nullwerte
Bereitstellung von null
ergibt null
.
Angenommen, wir haben das folgende Dokument:
{ "_id" : 6, "data" : null }
Und wir wenden $arrayToObject
an :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
{ "result" : null }
Fehlende Felder
Wenn das Feld fehlt, ist das Ergebnis null
.
Angenommen, wir haben das folgende Dokument:
{ "_id" : 7 }
Und wir wenden $arrayToObject
an :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 7 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
)
Ergebnis:
{ "result" : null }
Wiederkehrende Feldnamen
Laut der MongoDB-Dokumentation, wenn sich der Name eines Felds im Array wiederholt:
- Ab 4.0.5
$arrayToObject
verwendet den letzten Wert für dieses Feld. Für 4.0.0-4.0.4 hängt der verwendete Wert vom Treiber ab. - Ab 3.6.10
$arrayToObject
verwendet den letzten Wert für dieses Feld. Für 3.6.0-3.6.9 hängt der verwendete Wert vom Treiber ab. - Ab 3.4.19
$arrayToObject
verwendet den letzten Wert für dieses Feld. Für 3.4.0-3.4.19 hängt der verwendete Wert vom Treiber ab.