$ addToSet_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 更新运算符 > 数组更新运算符 > $ addToSet

在本页面

定义
行为
例子

定义¶

$addToSet¶

的$addToSet操作者，除非值已经存在，在这种情况下增加了一个值到一个数组$addToSet无助于该阵列。

该$addToSet运营商的形式为：

复制

{ $addToSet: { <field1>: <value1>, ... } }

要<field>在嵌入式文档或数组中指定，请使用点符号。

行为¶

$addToSet仅确保没有重复项添加到集合中，并且不影响现有重复项。 $addToSet不保证修改集中元素的特定顺序。

缺少字段¶

如果$addToSet在文档中不存在的字段上进行更新，请$addToSet使用指定值作为元素创建数组字段。

字段不是数组¶

如果$addToSet在不是数组的字段上使用，该操作将失败。例如，考虑foo包含非数组字段的集合中的文档 colors。

复制

{ _id: 1, colors: "blue,green,red" }

$addToSet对非数组字段的以下操作 colors失败：

复制

db.foo.update(
   { _id: 1 },
   { $addToSet: { colors: "c" } }
)

要添加的值是一个数组¶

如果该值为数组，$addToSet则将整个数组作为单个元素附加。

考虑test包含数组字段的集合中的文档letters：

复制

{ _id: 1, letters: ["a", "b"] }

以下操作将数组追加到字段：[ "c", "d" ]letters

复制

db.test.update(
   { _id: 1 },
   { $addToSet: { letters: [ "c", "d" ] } }
)

的letters阵列现在包括数组作为元素：[ "c", "d" ]

复制

{ _id: 1, letters: [ "a", "b", [ "c", "d" ] ] }

小费

要添加的值中的每个元素分别，使用 $each修饰符$addToSet。有关详细信息，请参见 $ each修饰符。

要添加的值是一个文档¶

如果值为文档，则如果数组中的现有文档与要添加的文档完全匹配，则MongoDB会确定该文档为重复文档；也就是说，现有文档具有完全相同的字段和值，并且字段的顺序相同。因此，字段顺序很重要，您不能指定MongoDB仅比较文档中字段的子集来确定文档是否与现有数组元素重复。

例子¶

考虑inventory包含以下文档的集合：

复制

{ _id: 1, item: "polarizing_filter", tags: [ "electronics", "camera" ] }

添加到阵列¶

由于数组中不存在此元素"accessories"，因此以下操作将其添加到数组中：tags"accessories"

复制

db.inventory.update(
   { _id: 1 },
   { $addToSet: { tags: "accessories" } }
)

价值已经存在¶

以下$addToSet操作无效，因为 "camera"它已经是tags数组的元素：

复制

db.inventory.update(
   { _id: 1 },
   { $addToSet: { tags: "camera"  } }
)

`$each`修饰符¶

您可以将$addToSet运算符与 $each修饰符一起使用。所述$each改性剂允许 $addToSet操作员多个值添加到阵列字段。

集合inventory具有以下文档：

复制

{ _id: 2, item: "cable", tags: [ "electronics", "supplies" ] }

然后，以下操作将$addToSet运算符与$each修饰符一起使用，以将多个元素添加到 tags数组中：

复制

db.inventory.update(
   { _id: 2 },
   { $addToSet: { tags: { $each: [ "camera", "electronics", "accessories" ] } } }
 )

操作仅增加"camera"以及"accessories"对 tags数组，因为"electronics"数组中已经存在：

复制

{
  _id: 2,
  item: "cable",
  tags: [ "electronics", "supplies", "camera", "accessories" ]
}

也可以看看

db.collection.update()， db.collection.findAndModify()，$push