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.

$addToSet (función de ventana)

$addToSet

Devuelve un arreglo de todos los valores únicos de una ventana específica.

El orden de los elementos en el arreglo devuelto es indefinido.

Nota

Desambiguación

Esta página describe $addToSet cuando se utiliza como función de ventana.

También puede usar $addToSet en estos otros contextos:

{ $setWindowFields: { ... output: { <field>: { $addToSet: <expression> } } }}

Si el valor de la expresión es un arreglo, $addToSet añade todo el arreglo como un único elemento.

Si el valor de la expresión es un documento, MongoDB determina que el documento es un duplicado si otro documento del arreglo coincide exactamente con el documento que se va a agregar. En concreto, el documento existente tiene exactamente los mismos campos y valores en el mismo orden.

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.

Este ejemplo utiliza la función de ventana $addToSet para mostrar cómo se acumulan los géneros únicos en las películas a lo largo del tiempo. Las películas se ordenan alfabéticamente por título, y la función de ventana rastrea todos los géneros únicos que han aparecido en películas desde el principio del conjunto de resultados hasta e incluyendo la película actual.

db.movies.aggregate( [ { $match: { year: 2002, genres: { $exists: true, $ne: [] } } }, { $group: { _id: { year: "$year", title: "$title", genre: { $first: "$genres" } }, } }, { $setWindowFields: { sortBy: { "_id.title": 1 }, output: { genresSeenSoFar: { $addToSet: "$_id.genre", window: { documents: [ "unbounded", "current" ] } } } } }, { $project: { _id: 0, year: "$_id.year", title: "$_id.title", genre: "$_id.genre", genresSeenSoFar: 1, uniqueGenreCount: { $size: "$genresSeenSoFar" } } }, { $limit: 8 }] )

En el ejemplo:

  • La etapa $match filtro las películas de 2002 con información de género.

  • La etapa $group agrupa por año, título y el primer género en el arreglo genres.

  • La etapa $setWindowFields utiliza $addToSet con una ventana de unbounded a current para acumular géneros únicos desde el principio del conjunto de resultados hasta el documento actual.

  • La etapa $project remodela la salida y calcula uniqueGenreCount para mostrar cómo crece el tamaño del conjunto.

  • La etapa $limit limita la salida a 8 documentos.

La salida demuestra cómo $addToSet acumula géneros únicos en todos los documentos. Observe que genresSeenSoFar crece de 1 género a 7 géneros a medida que cada película añade su género al conjunto. El séptimo documento ('3 Extremes II') tiene el mismo uniqueGenreCount que el sexto porque su género (Terror) ya estaba en el conjunto. Esto demuestra que $addToSet solo añade valores únicos e ignora los duplicados.

Califique esta página

Documentación