MongoDB $arrayToObject

I MongoDB er $arrayToObject aggregeringspipeline-operatør konverterer et array til et dokument.

Det array, der leveres til $arrayToObject skal være i et af de to følgende formater:

En matrix af to-element-arrays, hvor det første element er feltnavnet, og det andet element er feltværdien.
En række dokumenter, der indeholder en k felt og en v felt, hvor k feltet indeholder feltnavnet og v feltet indeholder værdien.

Format 1

Antag, at vi har en samling kaldet test med følgende dokument:

{
	"_id" : 1,
	"data" : [
		[
			"name",
			"Fetch"
		],
		[
			"type",
			"Dog"
		]
	]
}

Vi kan bruge $arrayToObject operatør for at returnere data felt som et dokumentobjekt:

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 1 ] } } },
     { $project: { 
        _id: 0,
        result: { $arrayToObject: "$data" } } 
         }
   ]
)

Resultat:

{ "result" : { "name" : "Fetch", "type" : "Dog" } }

Format 2

Antag, at vi har et dokument som dette:

{
	"_id" : 2,
	"data" : [
		{
			"k" : "name",
			"v" : "Fetch"
		},
		{
			"k" : "type",
			"v" : "Dog"
		}
	]
}

I dette tilfælde er k felter indeholder nøglerne og v felter indeholder værdierne.

Her er, hvad der sker, når vi anvender $arrayToObject til det dokument:

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 2 ] } } },
     { $project: { 
        _id: 0,
        result: { $arrayToObject: "$data" } } 
         }
   ]
)

Resultat:

{ "result" : { "name" : "Fetch", "type" : "Dog" } }

Vi kan se, at dette resulterede i det samme dokument, som blev produceret i det foregående eksempel.

Ikke-overensstemmende arrays

Argumentet givet til $arrayToObject kan være et hvilket som helst gyldigt udtryk, så længe det løses til et array af to-element arrays eller array af dokumenter, der indeholder k og v felter.

Hvis argumentet ikke overholder dette, opstår der en fejl.

Antag, at vi har følgende dokument:

{ "_id" : 3, "data" : [ [ "name", "Fetch", "Dog" ] ] }

Dette array indeholder tre elementer.

Her er, hvad der sker, når vi anvender $arrayToObject til det dokument:

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 fejlen angiver, kræver $arrayToObject requires an array of size 2 arrays .

Her er et andet dokument, der indeholder et ikke-overensstemmende array:

{ "_id" : 4, "data" : [ { "a" : "name", "b" : "Fetch" } ] }

I dette tilfælde bruger dokumentet i arrayet a og b felter i stedet for k og v .

Her er, hvad der sker, når vi anvender $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 dette tilfælde angiver fejlen, at $arrayToObject requires an object with keys 'k' and 'v' .

Forkert type

På samme måde, hvis argumentet ikke engang er et array, opstår der en fejl.

Antag, at vi har følgende dokument:

{ "_id" : 5, "data" : "None" }

data feltet indeholder en streng.

Her er, hvad der sker, når vi anvender $arrayToObject til det dokument:

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 fejlen angiver, kræver $arrayToObject requires an array input .

Nul-værdier

Giver null resulterer i null .

Antag, at vi har følgende dokument:

{ "_id" : 6, "data" : null }

Og vi anvender $arrayToObject :

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 6 ] } } },
     { $project: { 
        _id: 0,
        result: { $arrayToObject: "$data" } } 
         }
   ]
)

Resultat:

{ "result" : null }

Manglende felter

Hvis feltet mangler, er resultatet null .

Antag, at vi har følgende dokument:

{ "_id" : 7 }

Og vi anvender $arrayToObject :

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 7 ] } } },
     { $project: { 
        _id: 0,
        result: { $arrayToObject: "$data" } } 
         }
   ]
)

Resultat:

{ "result" : null }

Gentagende feltnavne

Ifølge MongoDB-dokumentationen, hvis navnet på et felt gentages i arrayet:

Startende i 4.0.5, $arrayToObject bruger den sidste værdi for det felt. For 4.0.0-4.0.4 afhænger den anvendte værdi af driveren.
Fra og med 3.6.10 $arrayToObject bruger den sidste værdi for det felt. For 3.6.0-3.6.9 afhænger den anvendte værdi af driveren.
Fra og med 3.4.19 $arrayToObject bruger den sidste værdi for det felt. For 3.4.0-3.4.19 afhænger værdien af driveren.