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
kenthalten Feld und einvFeld, wo daskfield enthält den Feldnamen und denvFeld 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 :
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
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 :
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
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 :
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
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
$arrayToObjectverwendet 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
$arrayToObjectverwendet 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
$arrayToObjectverwendet den letzten Wert für dieses Feld. Für 3.4.0-3.4.19 hängt der verwendete Wert vom Treiber ab.