/ /

Expressões

Página inicial do Docs

Desenvolvimento

Linguagem de query

Expressões

Página inicial do Docs

Desenvolvimento

Linguagem de query

Expressões

$map (operador de expressão )

Definição

$map: Aplica uma expressão a cada item em uma array e retorna uma array com os resultados aplicados.

Compatibilidade

Você pode utilizar o $map para implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

A expressão $map tem a seguinte sintaxe:

{ $map: { input: <expression>, as: <string>, in: <expression> } }

Campo	Especificação
`input`	Uma expressão que se torna uma array. Se `input` resolver para `null` ou se referir a um campo ausente, `$map` retornará `null`. Se `input` resolver para um valor que não seja da array e não seja nulo, o pipeline será executado.
`as`	Opcional. Um nome para a variável que representa cada elemento individual da array `input`. Se nenhum nome for especificado, o nome da variável padrão será `this`.
`in`	Uma expressão aplicada a cada elemento da array `input` . A expressão referencia cada elemento individualmente com o nome da variável especificado em `as`.

Para mais informações sobre expressões, consulte Expressões.

Exemplos

Adicionar a cada elemento de uma array

Os exemplos nesta página utilizam dados do conjunto de dados de amostra sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

A seguinte operação de agregação usa $map com a expressão para $add adicionar 10 a cada elemento na location.geo.coordinates array:

db.theaters.aggregate( [
   {
      $match: {
         theaterId: { $in: [ 1000, 1003, 1008 ] }
      }
   },
   {
      $project: {
         _id: 0,
         theaterId: 1,
         adjustedCoordinates: {
            $map: {
               input: "$location.geo.coordinates",
               as: "coord",
               in: { $add: [ "$$coord", 10 ] }
            }
         }
      }
   },
   { $sort: { theaterId: 1 } }
] )

[
  { theaterId: 1000, adjustedCoordinates: [ -83.24565, 54.85466 ] },
  { theaterId: 1003, adjustedCoordinates: [ -66.512016, 48.29697 ] },
  { theaterId: 1008, adjustedCoordinates: [ -111.96328, 48.367649 ] }
]

Truncar cada elemento de array

A operação de agregação a seguir usa $map para cada elemento truncate na location.geo.coordinates array para seu inteiro:

db.theaters.aggregate( [
   {
      $match: {
         theaterId: { $in: [ 1000, 1003, 1008 ] }
      }
   },
   {
      $project: {
         _id: 0,
         theaterId: 1,
         integerCoordinates: {
            $map: {
               input: "$location.geo.coordinates",
               as: "coord",
               in: { $trunc: "$$coord" }
            }
         }
      }
   },
   { $sort: { theaterId: 1 } }
] )

[
  { theaterId: 1000, integerCoordinates: [ -93, 44 ] },
  { theaterId: 1003, integerCoordinates: [ -76, 38 ] },
  { theaterId: 1008, integerCoordinates: [ -121, 38 ] }
]

Aplique operadores aritméticos a cada elemento de array

A seguinte operação de agregação utiliza o estágio para adicionar um $addFields novo genreScores campo. A operação usa $map para aplicar $multiply e a cada elemento $add da genres array, calculando uma pontuação com base na contagem de caracteres de cada nome de gênero:

db.movies.aggregate( [
  {
     $match: { runtime: { $gt: 1000 } }
  },
  {
     $addFields: {
        genreScores: {
           $map: {
              input: "$genres",
              as: "genre",
              in: {
                 $add: [
                    { $multiply: [ { $strLenCP: "$$genre" }, 2 ] },
                    1
                 ]
              }
           }
        }
     }
  },
  { $project: { _id: 0, title: 1, genres: 1, genreScores: 1 } },
  { $sort: { title: 1 } }
] )

[
  {
    genres: [ 'Documentary', 'History', 'Sport' ],
    title: 'Baseball',
    genreScores: [ 23, 15, 11 ]
  },
  {
    genres: [ 'Action', 'Adventure', 'Drama' ],
    title: 'Centennial',
    genreScores: [ 13, 19, 11 ]
  }
]

Saiba mais

Para saber mais sobre as expressões usadas nos exemplos anteriores, consulte:

Voltar

$ltrim

$maxN-array-element