Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$set (fase de agregación)

Nota

Desambiguación

La siguiente página se refiere a la etapa de agregación $set. Para el operador de actualización $set, ve $set.

$set

Agrega nuevos campos a los documentos. $set produce documentos que contienen todos los campos existentes de los documentos de entrada y los campos recién añadidos.

La $set etapa es un alias de $addFields.

Ambas etapas son equivalentes a una $project etapa que especifica explícitamente todos los campos existentes en los documentos de entrada y agrega los nuevos campos.

Puedes usar $set para implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

$set tiene la siguiente forma:

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

Especifique el nombre de cada campo para agregar y establezca su valor en una expresión de agregación o un objeto vacío. Para obtener más información sobre las expresiones, consulte las Expresiones.

Importante

Si el nombre del nuevo campo es el mismo que el de un campo existente (incluido _id), $set sobrescribirá el valor existente de ese campo con el valor de la expresión especificada.

  • $set añade nuevos campos a documentos existentes. Puedes incluir una o más etapas $set en una operación de agregación.

  • $set acepta la incrustación de objetos donde se puede establecer un valor a una expresión de agregación o a un objeto vacío. Por ejemplo, se aceptan los siguientes objetos anidados:

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

    Para agregar campos a documentos incrustados (incluidos los documentos en arreglos) utiliza la notación de puntos. Consulta el ejemplo.

  • Para agregar un elemento a un campo de arreglo existente con $set, úsalo con $concatArrays. Consulta el ejemplo.

Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.

La siguiente operación utiliza dos $set etapas para incluir tres nuevos campos en los documentos de salida:

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 }]...
Primera etapa ($set):
La primera $set etapa añade dos campos: imdbScoreScaled, que multiplica la calificación de IMDB por 10, y runtimeHours, que divide la duración por 60 y redondea hacia abajo al número entero más cercano.
Segunda etapa ($set):
La segunda etapa $set agrega totalScore, que suma imdbScoreScaled y runtimeHours calculados en la etapa anterior.

Utilice la notación de puntos para agregar nuevos campos a los documentos incrustados.

La siguiente operación de agregación agrega un nuevo campo normalizedRating al documento incrustado 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 } }]...

Al especificar un nombre de campo existente en una operación de $set, se reemplaza el campo original.

La siguiente operación $set sobrescribe el campo rated:

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

Es posible reemplazar un campo por otro. En el siguiente ejemplo, el campo title sustituye al campo _id.

La siguiente operación de agregación utiliza $set para reemplazar el campo _id de cada documento con el valor del campo title y reemplaza el campo title con la string "movie":

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

Puede usar $set con una expresión $concatArrays para agregar un elemento a un campo de arreglo existente. La siguiente operación utiliza $set para reemplazar el campo genres con un nuevo arreglo cuyos elementos son el arreglo actual genres concatenado con otro arreglo que contiene un nuevo género [ "Classic" ]:

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

La siguiente operación de agregación agrega un nuevo campo titleWithYear a cada documento que concatena el título de la película con su año de lanzamiento:

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 aprender más sobre las etapas relacionadas del pipeline, consulta la guía $addFields.