En MongoDB, el $arrayToObject El operador de canalización de agregación convierte una matriz en un documento.
La matriz proporcionada a $arrayToObject debe estar en uno de los dos formatos siguientes:
- Una matriz de matrices de dos elementos donde el primer elemento es el nombre del campo y el segundo elemento es el valor del campo.
- Una matriz de documentos que contienen un
kcampo y unavcampo, dondekEl campo contiene el nombre del campo y lavel campo contiene el valor.
Formato 1
Supongamos que tenemos una colección llamada test con el siguiente documento:
{
"_id" : 1,
"data" : [
[
"name",
"Fetch"
],
[
"type",
"Dog"
]
]
}
Podemos usar el $arrayToObject operador para devolver los data campo como un objeto de documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
{ "result" : { "name" : "Fetch", "type" : "Dog" } } Formato 2
Supongamos que tenemos un documento como este:
{
"_id" : 2,
"data" : [
{
"k" : "name",
"v" : "Fetch"
},
{
"k" : "type",
"v" : "Dog"
}
]
}
En este caso, el k campos contienen las claves y el v campos contienen los valores.
Esto es lo que sucede cuando aplicamos $arrayToObject a ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 2 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
{ "result" : { "name" : "Fetch", "type" : "Dog" } } Podemos ver que esto resultó en el mismo documento que se produjo en el ejemplo anterior.
Matrices no conformes
El argumento proporcionado a $arrayToObject puede ser cualquier expresión válida siempre que se resuelva en una matriz de matrices de dos elementos o una matriz de documentos que contenga k y v campos.
Si el argumento no se adhiere a esto, se produce un error.
Supongamos que tenemos el siguiente documento:
{ "_id" : 3, "data" : [ [ "name", "Fetch", "Dog" ] ] } Esta matriz contiene tres elementos.
Esto es lo que sucede cuando aplicamos $arrayToObject a ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 3 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
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
Como indica el error, $arrayToObject requires an array of size 2 arrays .
Aquí hay otro documento que contiene una matriz no conforme:
{ "_id" : 4, "data" : [ { "a" : "name", "b" : "Fetch" } ] }
En este caso, el documento dentro de la matriz usa a y b campos en lugar de k y v .
Esto es lo que sucede cuando aplicamos $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
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
En este caso, el error indica que $arrayToObject requires an object with keys 'k' and 'v' .
Tipo incorrecto
De manera similar, si el argumento ni siquiera es una matriz, se produce un error.
Supongamos que tenemos el siguiente documento:
{ "_id" : 5, "data" : "None" }
Los data el campo contiene una cadena.
Esto es lo que sucede cuando aplicamos $arrayToObject a ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
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
Como indica el error, $arrayToObject requires an array input .
Valores nulos
Proporcionar null da como resultado null .
Supongamos que tenemos el siguiente documento:
{ "_id" : 6, "data" : null }
Y aplicamos $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
{ "result" : null } Campos faltantes
Si falta el campo, el resultado es null .
Supongamos que tenemos el siguiente documento:
{ "_id" : 7 }
Y aplicamos $arrayToObject :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 7 ] } } },
{ $project: {
_id: 0,
result: { $arrayToObject: "$data" } }
}
]
) Resultado:
{ "result" : null } Nombres de campos repetidos
Según la documentación de MongoDB, si el nombre de un campo se repite en la matriz:
- A partir de 4.0.5,
$arrayToObjectusa el último valor para ese campo. Para 4.0.0-4.0.4, el valor utilizado depende del controlador. - A partir de 3.6.10,
$arrayToObjectusa el último valor para ese campo. Para 3.6.0-3.6.9, el valor utilizado depende del controlador. - A partir de 3.4.19,
$arrayToObjectusa el último valor para ese campo. Para 3.4.0-3.4.19, el valor que se usa depende del controlador.