MongoDB $objectToArray

No MongoDB, o $objectToArray operador de pipeline de agregação converte um documento em uma matriz.

A matriz produzida por $objectToArray contém um elemento para cada par campo/valor no documento original. Cada elemento é um documento que contém um k campo e um v campo:

O k field contém o nome do campo no documento original.
O v campo contém o valor do campo no documento original.

Exemplo

Suponha que tenhamos uma coleção chamada dogs com o seguinte documento:

{
	"_id" : 1,
	"name" : "Fetch",
	"specs" : {
		"height" : 400,
		"weight" : 55,
		"color" : "brown"
	}
}

Podemos usar o $objectToArray operador para retornar as specs campo como uma matriz:

db.dogs.aggregate(
   [
     { $match: { _id: { $in: [ 1 ] } } },
     { $project: { 
        _id: 0,
        result: { $objectToArray: "$specs" } } 
         }
   ]
).pretty()

Resultado:

{
	"result" : [
		{
			"k" : "height",
			"v" : 400
		},
		{
			"k" : "weight",
			"v" : 55
		},
		{
			"k" : "color",
			"v" : "brown"
		}
	]
}

Documentos aninhados

O $objectToArray operador só se aplica ao campo de nível superior. Ele não se aplica recursivamente a nenhum documento incorporado.

Suponha que temos um documento como este:

{
	"_id" : 2,
	"name" : "Wag",
	"specs" : {
		"height" : 50,
		"weight" : 5,
		"color" : {
			"eyes" : "brown",
			"coat" : "black"
		}
	}
}

Veja o que acontece quando aplicamos $objectToArray a esse documento:

db.dogs.aggregate(
   [
     { $match: { _id: { $in: [ 2 ] } } },
     { $project: { 
        _id: 0,
        result: { $objectToArray: "$specs" } } 
         }
   ]
).pretty()

Resultado:

{
	"result" : [
		{
			"k" : "height",
			"v" : 50
		},
		{
			"k" : "weight",
			"v" : 5
		},
		{
			"k" : "color",
			"v" : {
				"eyes" : "brown",
				"coat" : "black"
			}
		}
	]
}

Neste caso, o documento de nível superior é convertido para o k /v formato, mas o documento incorporado permanece o mesmo que no documento original.

Tipo errado

O argumento fornecido para $objectToArray pode ser qualquer expressão válida, desde que resolva para um objeto de documento.

Se o argumento não for resolvido para um objeto de documento, ocorrerá um erro.

Suponha que temos o seguinte documento:

{ "_id" : 3, "name" : "Fetch", "specs" : "None" }

As specs campo contém uma string.

Veja o que acontece quando aplicamos $objectToArray a esse documento:

db.dogs.aggregate(
   [
     { $match: { _id: { $in: [ 3 ] } } },
     { $project: { 
        _id: 0,
        result: { $objectToArray: "$specs" } } 
         }
   ]
)

Resultado:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$objectToArray requires a document input, found: string",
	"code" : 40390,
	"codeName" : "Location40390"
} : 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

Como o erro indica, $objectToArray requires a document input .

Valores nulos

Fornecendo null resulta em null .

Suponha que temos o seguinte documento:

{ "_id" : 4, "name" : "Fetch", "specs" : null }

E aplicamos $objectToArray :

db.dogs.aggregate(
   [
     { $match: { _id: { $in: [ 4 ] } } },
     { $project: { 
        _id: 0,
        result: { $objectToArray: "$specs" } } 
         }
   ]
)

Resultado:

{ "result" : null }

Campos ausentes

Se o campo estiver ausente, o resultado será null .

Suponha que temos o seguinte documento:

{ "_id" : 5, "name" : "Fetch" }

E aplicamos $objectToArray :

db.dogs.aggregate(
   [
     { $match: { _id: { $in: [ 5 ] } } },
     { $project: { 
        _id: 0,
        result: { $objectToArray: "$specs" } } 
         }
   ]
)

Resultado:

{ "result" : null }