MongoDB $arrayToObject

Dans MongoDB, le $arrayToObject L'opérateur de pipeline d'agrégation convertit un tableau en document.

Le tableau fourni à $arrayToObject doit être dans l'un des deux formats suivants :

• Un tableau de tableaux à deux éléments où le premier élément est le nom du champ et le second élément est la valeur du champ.
• Un tableau de documents contenant un k champ et un v champ, où le k champ contient le nom du champ et le v le champ contient la valeur.

Format 1

Supposons que nous ayons une collection appelée test avec le document suivant :

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

Nous pouvons utiliser le $arrayToObject opérateur pour renvoyer les data champ en tant qu'objet document :

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

Résultat :

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

Format 2

Supposons que nous ayons un document comme celui-ci :

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

Dans ce cas, le k les champs contiennent les clés et le v les champs contiennent les valeurs.

Voici ce qui se passe lorsque nous appliquons $arrayToObject à ce document :

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

Résultat :

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

Nous pouvons voir que cela a abouti au même document que celui produit dans l'exemple précédent.

Matrices non conformes

L'argument fourni à $arrayToObject peut être n'importe quelle expression valide tant qu'elle se résout en un tableau de tableaux à deux éléments ou un tableau de documents contenant k et v champs.

Si l'argument ne respecte pas cela, une erreur se produit.

Supposons que nous ayons le document suivant :

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

Ce tableau contient trois éléments.

Voici ce qui se passe lorsque nous appliquons $arrayToObject à ce document :

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

Résultat :

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

Comme l'indique l'erreur, $arrayToObject requires an array of size 2 arrays .

Voici un autre document qui contient un tableau non conforme :

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

Dans ce cas, le document dans le tableau utilise a et b champs au lieu de k et v .

Voici ce qui se passe lorsque nous appliquons $arrayToObject :

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

Résultat :

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

Dans ce cas, l'erreur indique que $arrayToObject requires an object with keys 'k' and 'v' .

Mauvais type

De même, si l'argument n'est même pas un tableau, une erreur se produit.

Supposons que nous ayons le document suivant :

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

Les data le champ contient une chaîne.

Voici ce qui se passe lorsque nous appliquons $arrayToObject à ce document :

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

Résultat :

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

Comme l'indique l'erreur, $arrayToObject requires an array input .

Valeurs nulles

Fournir null donne null .

Supposons que nous ayons le document suivant :

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

Et nous appliquons $arrayToObject :

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

Résultat :

{ "result" : null }

Champs manquants

Si le champ est manquant, le résultat est null .

Supposons que nous ayons le document suivant :

{ "_id" : 7 }

Et nous appliquons $arrayToObject :

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

Résultat :

{ "result" : null }

Répétition des noms de champ

D'après la documentation de MongoDB, si le nom d'un champ se répète dans le tableau :

• Depuis la version 4.0.5, $arrayToObject utilise la dernière valeur de ce champ. Pour 4.0.0-4.0.4, la valeur utilisée dépend du pilote.
• Depuis la version 3.6.10, $arrayToObject utilise la dernière valeur de ce champ. Pour 3.6.0-3.6.9, la valeur utilisée dépend du pilote.
• Depuis la version 3.4.19, $arrayToObject utilise la dernière valeur de ce champ. Pour 3.4.0-3.4.19, la valeur utilise dépend du pilote.