Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

$set (estágio de agregação )

Observação

Desambiguação

A página seguinte se refere ao estágio de agregação $set. Para o operador de atualizar$set, consulte $set.

$set

Adiciona novos campos aos documentos. $set gera documentos que contêm todos os campos existentes dos documentos de entrada e os novos campos.

O estágio $set é um alias para $addFields.

Ambos os estágios são equivalentes a um estágio $project que especifica explicitamente todos os campos existentes nos documentos de entrada e adiciona os novos campos.

Você pode utilizar o $set 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

$set tem o seguinte formato:

{ $set: { <newField>: <expression>, ... } }

Especifique o nome de cada campo a ser adicionado e defina seu valor como uma expressão de agregação ou um objeto vazio.

Importante

Se o novo nome de campo corresponder a um nome de campo existente (incluindo _id), $set sobrescreve o valor desse campo com a expressão especificada.

  • $set anexa novos campos a documentos existentes. Você pode incluir um ou mais estágios $set em uma operação de aggregation.

  • Você pode usar $set com objetos incorporados. Você pode definir um valor para uma expressão de agregação ou para um objeto vazio. Por exemplo, os seguintes objetos aninhados são aceitos:

    {$set: { a: { b: { } } } }

    Para adicionar campos a documentos incorporados (incluindo documentos em arrays), use a notação de ponto. Veja exemplo.

  • Para adicionar um elemento a um campo de array existente com $set, utilize $concatArrays. Veja exemplo.

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar este conjunto de dados em sua implantação do MongoDB autogerenciado, consulte Carregar o conjunto de dados de amostra. Se você fez alguma modificação 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 operação a seguir usa dois estágios $set para incluir três novos campos nos documentos de saída:

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { imdbScoreScaled: { $multiply: [ "$imdb.rating", 10 ] }, runtimeHours: { $floor: { $divide: [ "$runtime", 60 ] } } } }, { $set: { totalScore: { $add: [ "$imdbScoreScaled", "$runtimeHours" ] } } }] )
[ { _id: ..., title: 'Baseball', runtime: 1140, imdbScoreScaled: 91, runtimeHours: 19, totalScore: 110 }, { _id: ..., title: 'Centennial', runtime: 1256, imdbScoreScaled: 85, runtimeHours: 20, totalScore: 105 }]...
Primeiro estágio ($set):
O primeiro estágio $set adiciona dois campos: imdbScoreScaled, que multiplica a classificação do IMDB por 10, e runtimeHours, que divide o tempo de execução por 60 e arredonda para baixo para o número inteiro mais próximo.
Segundo estágio ($set):
O segundo estágio $set adiciona totalScore, que soma imdbScoreScaled e runtimeHours calculados no estágio anterior.

Use a notação de pontos para adicionar novos campos a documentos incorporados.

A seguinte operação de agregação adiciona um novo campo normalizedRating ao documento incorporado imdb:

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { "imdb.normalizedRating": { $multiply: [ "$imdb.rating", 10 ] } } }] )
[ { _id: ..., title: 'Baseball', imdb: { '...': '...', normalizedRating: 91 } }, { _id: ..., title: 'Centennial', imdb: { '...': '...', normalizedRating: 85 } }]...

A seguinte operação $set substitui o campo rated:

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { rated: "UNRATED" } }] )
[ { _id: ..., title: 'Baseball', rated: 'UNRATED' }]...

Você pode substituir um campo por outro. A operação a seguir substitui _id pelo valor do campo title e, em seguida, define title como a string "movie":

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { _id: "$title", title: "movie" } }] )
[ { _id: 'Baseball', title: 'movie' }, { _id: 'Centennial', title: 'movie' }]...

Para adicionar um elemento a um campo de array existente, utilize $concatArrays com $set. A operação a seguir substitui o campo genres por um novo array que concatena o array atual genres com [ "Classic" ]:

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { genres: { $concatArrays: [ "$genres", [ "Classic" ] ] } } }] )
[ { _id: ..., title: 'Baseball', genres: [ 'Documentary', 'History', 'Sport', 'Classic' ] }]...

A operação de agregação a seguir adiciona um novo campo titleWithYear a cada documento que concatena o título do filme com seu ano de lançamento:

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { titleWithYear: { $concat: [ "$title", " (", { $toString: "$year" }, ")" ] } } }] )
[ { _id: ..., title: 'Baseball', titleWithYear: 'Baseball (1994)' }, { _id: ..., title: 'Centennial', titleWithYear: 'Centennial (1978)' }]...

Para estágios relacionados, consulte $addFields.