$concatArrays (agregação)

Definição

$concatArrays

Concatena arrays para retornar a array concatenada.

$concatArrays tem a seguinte sintaxe:

{ $concatArrays: [ <array1>, <array2>, ... ] }

As expressões do <array> podem ser qualquerexpressão do válida desde que resolvam para uma array. Para obter mais informações sobre expressões, consulte Operadores de expressão.

Caso algum argumento seja resolvido com um valor null ou caso algum fragmento seja destinado a um campo ausente, $concatArrays retornará null.

Comportamento

{ $concatArrays: [
   [ "hello", " "], [ "world" ]
] }

[ "hello", " ", "world" ]

{ $concatArrays: [
   [ "hello", " "],
   [ [ "world" ], "again"]
] }

[ "hello", " ", [ "world" ], "again" ]

Exemplo

Crie uma coleção denominada warehouses com os seguintes documentos:

db.warehouses.insertMany( [
   { _id : 1, instock: [ "chocolate" ], ordered: [ "butter", "apples" ] },
   { _id : 2, instock: [ "apples", "pudding", "pie" ] },
   { _id : 3, instock: [ "pears", "pecans" ], ordered: [ "cherries" ] },
   { _id : 4, instock: [ "ice cream" ], ordered: [ ] }
] )

O exemplo a seguir concatena as arrays instock e ordered :

db.warehouses.aggregate( [
   { $project: { items: { $concatArrays: [ "$instock", "$ordered" ] } } }
] )

{ _id : 1, items : [ "chocolate", "butter", "apples" ] }
{ _id : 2, items : null }
{ _id : 3, items : [ "pears", "pecans", "cherries" ] }
{ _id : 4, items : [ "ice cream" ] }