$addToSet (aggregation)
在本页面
Definition
$addToSet- 返回所有唯一值的数组，该值是通过将表达式应用于按键共享同一组文档的一组文档中的每个文档而得出的。未指定输出数组中元素的 Sequences。
$addToSet具有以下语法：
{ $addToSet: <expression> }
有关表达式的更多信息，请参见Expressions。
Behavior
Array Expression
如果表达式的值是一个数组，则$addToSet将整个数组附加为单个元素。
Document Expression
如果表达式的值是一个文档，则如果数组中的另一个文档与要添加的文档完全匹配，则 MongoDB 会确定该文档是重复的。即现有文档具有完全相同的字段和值，且 Sequences 完全相同。
Memory Restrictions
从 3.6.17 开始，即使db.collection.aggregate()与allowDiskUse: true一起运行，$addToSet的内存限制也为 100 MiB(100 * 1024 * 1024)。
有关更多信息，请参见聚集管线限制。
Example
考虑包含以下文档的sales集合：
{ "_id" : 1, "item" : "abc", "price" : 10, "quantity" : 2, "date" : ISODate("2014-01-01T08:00:00Z") }
{ "_id" : 2, "item" : "jkl", "price" : 20, "quantity" : 1, "date" : ISODate("2014-02-03T09:00:00Z") }
{ "_id" : 3, "item" : "xyz", "price" : 5, "quantity" : 5, "date" : ISODate("2014-02-03T09:05:00Z") }
{ "_id" : 4, "item" : "abc", "price" : 10, "quantity" : 10, "date" : ISODate("2014-02-15T08:00:00Z") }
{ "_id" : 5, "item" : "xyz", "price" : 5, "quantity" : 10, "date" : ISODate("2014-02-15T09:12:00Z") }
按date字段的日期和年份对文档进行分组，以下操作使用$addToSet累加器计算每个组出售的唯一商品的列表：
db.sales.aggregate(
[
{
$group:
{
_id: { day: { $dayOfYear: "$date"}, year: { $year: "$date" } },
itemsSold: { $addToSet: "$item" }
}
}
]
)
该操作返回以下结果：
{ "_id" : { "day" : 46, "year" : 2014 }, "itemsSold" : [ "xyz", "abc" ] }
{ "_id" : { "day" : 34, "year" : 2014 }, "itemsSold" : [ "xyz", "jkl" ] }
{ "_id" : { "day" : 1, "year" : 2014 }, "itemsSold" : [ "abc" ] }