MongoDB $concatArrays

No MongoDB, o $concatArrays operador de pipeline de agregação concatena duas ou mais matrizes e retorna a matriz concatenada.

Exemplo

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

{ "_id" : 1, "a" : [ 1, 2, 3 ], "b" : [ 4, 5, 6 ] }

Podemos usar o $concatArrays operador para concatenar o array do a campo com a matriz do b campo:

db.data.aggregate([
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        result: { $concatArrays: [ "$a", "$b" ] }
        }
    }
])

Resultado:

{ "result" : [ 1, 2, 3, 4, 5, 6 ] }

Matrizes vazias

Concatenar um array com um array vazio não muda nada.

Suponha que nossa coleção também contenha o seguinte documento:

{ "_id" : 2, "a" : [ 1, 2, 3 ], "b" : [ ] }

Vamos aplicar $concatArrays para isso::

db.data.aggregate([
    { $match: { _id: 2 } },
    { $project: { 
        _id: 0,
        result: { $concatArrays: [ "$a", "$b" ] }
        }
    }
])

Resultado:

{ "result" : [ 1, 2, 3 ] }

Acabamos com o primeiro array sem nenhuma alteração.

Campos ausentes

Tentar concatenar um campo com um campo que não existe retorna null .

Imagine que nossa coleção também contém o seguinte documento:

{ "_id" : 3, "a" : [ 1, 2, 3 ] }

Veja o que acontece quando aplicamos $concatArrays para o a campo e um campo inexistente:

db.data.aggregate([
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        result: { $concatArrays: [ "$a", "$b" ] }
        }
    }
])

Resultado:

{ "result" : null }

Outros tipos de dados

Cada expressão fornecida para $concatArrays pode ser qualquer expressão válida, desde que resolva para uma matriz.

Se não resolver para uma matriz, um erro será retornado.

Suponha que temos o seguinte documento:

{ "_id" : 4, "a" : [ 1, 2, 3 ], "b" : 4 }

Veja o que acontece se tentarmos concatenar o a e b Campos:

db.data.aggregate([
    { $match: { _id: 4 } },
    { $project: { 
        _id: 0,
        result: { $concatArrays: [ "$a", "$b" ] }
        }
    }
])

Resultado:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$concatArrays only supports arrays, not double",
	"code" : 28664,
	"codeName" : "Location28664"
} : 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:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1

Neste exemplo, tentei concatenar um array com um double, mas recebi um erro informando que $concatArrays suporta apenas arrays, não double .