修饰符	说明
`$each`	向数组字段追加多个值。
`$slice`	限制数组元素的数量。需要使用 `$each` 修改器。
`$sort`	对数组元素进行排序。需要使用 `$each` 修饰符。
`$position`	指定大量中插入新元素的位置。需要使用`$each` 修饰符。如果没有`$position` 修饰符，`$push` 会将元素附加到大量的末尾。

与修饰符一起使用时，$push 操作符采用以下格式：

{ $push: { <field1>: { <modifier1>: <value1>, ... }, ... } }

$push无论修饰符出现的顺序如何，带有修饰符的操作的处理都会按以下顺序进行：

更新数组以在正确的位置添加元素。
如果已指定，则应用排序。
对数组进行切片（如果已指定）。
存储数组。

示例

本页上的示例使用sample_mflix示例数据集中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载示例数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。

将值追加到数组

以下示例使用 $push 操作符将 "Classic" 追加到匹配的电影文档中的 genres 数组中：

db.movies.updateOne(
   { title: "The Dark Knight" },
   { $push: { genres: "Classic" } }
)

操作返回以下结果：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

在多个文档中向数组追加值

以下示例使用$push 操作符将"Acclaimed" genres附加到所有匹配电影文档中的大量：

db.movies.updateMany(
   { "imdb.rating": { $gt: 9 } },
   { $push: { genres: "Acclaimed" } }
)

操作返回以下结果：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: '...',
  modifiedCount: '...',
  upsertedCount: 0
}

向数组追加多个值

使用$push 和$each 修饰符将多个值附加到大量字段。

db.movies.updateOne(
   { title: "The Dark Knight" },
   { $push: { genres: { $each: [ "Modern Classic", "Award-Winning" ] } } }
)

操作返回以下结果：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

`$push`使用带有多个修饰符的操作符

将以下文档添加到 students 集合中：

db.students.insertOne(
   {
      "_id" : 5,
      "quizzes" : [
         { "wk": 1, "score" : 10 },
         { "wk": 2, "score" : 8 },
         { "wk": 3, "score" : 5 },
         { "wk": 4, "score" : 6 }
      ]
   }
)

以下$push 操作使用：

$each 修饰符将多个文档添加到 quizzes 数组，
$sort 修改器，按 score 字段降序对修改后 quizzes 数组的所有元素进行排序，以及
$slice 修饰符仅保留 quizzes 数组的前三个排序元素。

db.students.updateOne(
   { _id: 5 },
   {
     $push: {
       quizzes: {
          $each: [ { wk: 5, score: 8 }, { wk: 6, score: 7 }, { wk: 7, score: 6 } ],
          $sort: { score: -1 },
          $slice: 3
       }
     }
   }
)

操作后，数组中只有三个得分最高的测验：

{
  "_id" : 5,
  "quizzes" : [
     { "wk" : 1, "score" : 10 },
     { "wk" : 2, "score" : 8 },
     { "wk" : 5, "score" : 8 }
  ]
}

提示

$push（更新操作符）

定义

兼容性

语法

行为

Modifiers

示例

将值追加到数组

在多个文档中向数组追加值

向数组追加多个值

$push使用带有多个修饰符的 操作符

`$push`使用带有多个修饰符的操作符