Definición
Devuelve un arreglo de valores únicos para una expresión evaluada en todos los documentos de un grupo. El orden de los elementos en el arreglo es indefinido.
$addToSet está disponible en estas etapas:
Nota
Desambiguación
Esta página describe $addToSet cuando se utiliza como acumulador. Los acumuladores devuelven un único valor agregado como la suma, el máximo o el mínimo en un grupo de documentos de entrada.
También puede usar $addToSet en estos otros contextos:
$addToSet (window function), que se utiliza en la$setWindowFieldsetapa para devolver un arreglo de valores únicos de documentos en una ventana determinada.$addToSet (update operator), que añade elementos únicos a un campo de arreglo en un documento.
Sintaxis
{ $addToSet: <expression> }Para obtener más información sobre las expresiones, consulta Expresiones.
Comportamiento
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.
$addToSet no se pueden guardar archivos temporales en el disco. El parámetro de servidor internalQueryMaxAddToSetBytes controla el límite de memoria $addToSet y, si el arreglo acumulado supera ese límite, MongoDB devuelve un error incluso cuando allowDiskUse es true. Por defecto, el parámetro es 104857600 bytes (100 megabytes). Puedes aumentar el límite en tiempo de ejecución con el comando setParameter.
Para obtener más información sobre las restricciones de memoria de agregación, consulte Límites de la pipeline de agregación.
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 agrupa las películas por director y utiliza el acumulador $addToSet para recopilar los géneros únicos en los que ha trabajado cada director. Para mejorar la legibilidad, el pipeline limita los resultados a los cinco primeros directores en orden alfabético.
db.movies.aggregate( [ { $unwind: "$directors" }, { $unwind: "$genres" }, { $group: { _id: "$directors", genres: { $addToSet: "$genres" } } }, { $sort: { _id: 1 } }, { $limit: 5 }] )Esta pipeline devuelve estos resultados:
[ { _id: 'A. Dean Bell', genres: [ 'Crime', 'Drama' ] }, { _id: 'A. Karunakaran', genres: [ 'Romance' ] }, { _id: 'A. Vanichkin', genres: [ 'Animation', 'Fantasy' ] }, { _id: 'A.J. Edwards', genres: [ 'Biography', 'Drama', 'History' ] }, { _id: 'A.R. Murugadoss', genres: [ 'Drama', 'Sci-Fi', 'Thriller', 'Action', 'Mystery' ] }]