$zip (agregação)

Definição

$zip

Transpõe uma array de arrays de entrada de modo que o primeiro elemento da array de saída seria uma array contendo, o primeiro elemento da primeira array de entrada, o primeiro elemento da segunda array de entrada etc.

Por exemplo, $zip transformaria [ [ 1, 2, 3 ], [ "a", "b", "c" ] ] em [ [ 1, "a" ], [ 2, "b" ], [ 3, "c" ] ].

$zip tem a seguinte sintaxe:

{
    $zip: {
        inputs: [ <array expression1>,  ... ],
        useLongestLength: <boolean>,
        defaults:  <array expression>
    }
}

Operando	Descrição
inputs	Uma array de expressões que resulta em arrays. Os elementos destes arrays de entrada combinam-se para formar os arrays do array de saída. Se qualquer uma das arrays inputs resultar em um valor de null ou se referir a um campo ausente, $zip retornará null. Se qualquer uma das arrays inputs não resulta em uma array ou null nem se referir a um campo ausente, $zip retornará um erro.
useLongestLength	Um booleano que especifica se o comprimento da array mais longa determina o número de arrays na array de saída. O valor padrão é false: o menor comprimento da array determina o número de arrays na array de saída.
defaults	Uma array de valores de elemento padrão para utilizar se os arrays de entrada tiverem comprimentos diferentes. Você deve especificar useLongestLength: true junto com esse campo, caso contrário, $zip retornará um erro. Se useLongestLength: true mas defaults estiver vazio ou não for especificado, $zip usará null como valor padrão. Se especificar um defaults não vazio, você deverá especificar um padrão para cada array de entrada, caso contrário $zip retornará um erro.

Comportamento

Os arrays de entrada não precisam ter o mesmo comprimento. Por padrão, a array de saída tem o comprimento da array de entrada mais curta, mas a opção useLongestLength instrui $zip a gerar uma array tão longa quanto a array de entrada mais longa.

{ $zip: { inputs: [ [ "a" ], [ "b" ], [ "c" ] ] }

[ [ "a", "b", "c" ] ]

{ $zip: { inputs: [ [ "a" ], [ "b", "c" ] ] } }

[ [ "a", "b" ] ]

{
  $zip: {
     inputs: [ [ 1 ], [ 2, 3 ] ],
     useLongestLength: true
  }
}

[ [ 1, 2 ], [ null, 3 ] ]

{
  $zip: {
     inputs: [ [ 1 ], [ 2, 3 ], [ 4 ] ],
     useLongestLength: true,
     defaults: [ "a", "b", "c" ]
  }
}

Exemplo

db.matrices.insertMany([
  { matrix: [[1, 2], [2, 3], [3, 4]] },
  { matrix: [[8, 7], [7, 6], [5, 4]] },
])

db.matrices.aggregate([{
  $project: {
    _id: false,
    transposed: {
      $zip: {
        inputs: [
          { $arrayElemAt: [ "$matrix", 0 ] },
          { $arrayElemAt: [ "$matrix", 1 ] },
          { $arrayElemAt: [ "$matrix", 2 ] },
        ]
      }
    }
  }
}])

{ "transposed" : [ [ 1, 2, 3 ], [ 2, 3, 4 ] ] }
{ "transposed" : [ [ 8, 7, 5 ], [ 7, 6, 4 ] ] }

db.pages.save( {
  "category": "unix",
  "pages": [
    { "title": "awk for beginners", reviews: 5 },
    { "title": "sed for newbies", reviews: 0 },
    { "title": "grep made simple", reviews: 2 },
] } )

db.pages.aggregate([{
  $project: {
    _id: false,
    pages: {
      $filter: {
        input: {
          $zip: {
            inputs: [ "$pages", { $range: [0, { $size: "$pages" }] } ]
          }
        },
        as: "pageWithIndex",
        cond: {
          $let: {
            vars: {
              page: { $arrayElemAt: [ "$$pageWithIndex", 0 ] }
            },
            in: { $gte: [ "$$page.reviews", 1 ] }
          }
        }
      }
    }
  }
}])

{
  "pages" : [
    [ { "title" : "awk for beginners", "reviews" : 5 }, 0 ],
    [ { "title" : "grep made simple", "reviews" : 2 }, 2 ] ]
}