定义
5.0 版本中的更改。
返回一组文档中最后一个文档的 表达式的结果。仅当文档按定义的顺序排列时才有意义。
$last 可在以下阶段使用:
- $setWindowFields(从 MongoDB 5.0 开始提供)
语法
$last 事务语法:
{ $last: <expression> } 
行为
定义文档顺序
数组操作符
如果该表达式解析为一个数组:
- 对于一组文档,与 - $group和- $setWindowFields阶段一样,- $last返回最后一个文档的整个数组。 它不遍历数组元素。
- 对于单份文档,与 - $addFields阶段一样,- $last返回数组的最后一个元素。
缺失的值
群组中的文档可能缺失字段,或者可能具有缺失值的字段。
- 如果前一个管道阶段没有文档,则 - $group阶段将不返回任何内容。
- 如果 - $last累加器正在处理的字段缺失,则- $last返回- null。
- 与 - $setWindowFields一起使用时,- $last对于空窗口,返回- null。例如,当分区的第一个文档上有一个- { documents: [ -1, -1] }- documents窗口时。
有关更多信息,请参阅本主题后文的缺失数据示例。
示例
在 $group 阶段中使用
请考虑包含以下文档的 sales 集合:
db.sales.insertMany( [    { _id : 1, "item" : "abc", "date" : ISODate("2014-01-01T08:00:00Z"), "price" : 10, "quantity" : 2 },    { _id : 2, "item" : "jkl", "date" : ISODate("2014-02-03T09:00:00Z"), "price" : 20, "quantity" : 1 },    { _id : 3, "item" : "xyz", "date" : ISODate("2014-02-03T09:05:00Z"), "price" : 5, "quantity" : 5 },    { _id : 4, "item" : "abc", "date" : ISODate("2014-02-15T08:00:00Z"), "price" : 10, "quantity" : 10 },    { _id : 5, "item" : "xyz", "date" : ISODate("2014-02-15T09:05:00Z"), "price" : 5, "quantity" : 10 },    { _id : 6, "item" : "xyz", "date" : ISODate("2014-02-15T12:05:10Z"), "price" : 5, "quantity" : 5 },    { _id : 7, "item" : "xyz", "date" : ISODate("2014-02-15T14:12:12Z"), "price" : 5, "quantity" : 10 } ] ) 
以下操作首先按 item 和 date 对文档进行排序,然后在接下来的 $group 阶段,按 item 字段对现已排序的文档进行分组,并使用 $last 累加器计算每个项目的最后销售日期:
db.sales.aggregate(    [      { $sort: { item: 1, date: 1 } },      {        $group:          {            _id: "$item",            lastSalesDate: { $last: "$date" }          }      }    ] ) 
操作返回以下结果:
{ "_id" : "xyz", "lastSalesDate" : ISODate("2014-02-15T14:12:12Z") } { "_id" : "jkl", "lastSalesDate" : ISODate("2014-02-03T09:00:00Z") } { "_id" : "abc", "lastSalesDate" : ISODate("2014-02-15T08:00:00Z") } 
在 $setWindowFields 阶段中使用
版本 5.0 中的新增功能。
创建cakeSales集合,其中包含加利福尼亚州 ( CA ) 和华盛顿州 ( WA ) 的蛋糕销售情况:
db.cakeSales.insertMany( [    { _id: 0, type: "chocolate", orderDate: new Date("2020-05-18T14:10:30Z"),      state: "CA", price: 13, quantity: 120 },    { _id: 1, type: "chocolate", orderDate: new Date("2021-03-20T11:30:05Z"),      state: "WA", price: 14, quantity: 140 },    { _id: 2, type: "vanilla", orderDate: new Date("2021-01-11T06:31:15Z"),      state: "CA", price: 12, quantity: 145 },    { _id: 3, type: "vanilla", orderDate: new Date("2020-02-08T13:13:23Z"),      state: "WA", price: 13, quantity: 104 },    { _id: 4, type: "strawberry", orderDate: new Date("2019-05-18T16:09:01Z"),      state: "CA", price: 41, quantity: 162 },    { _id: 5, type: "strawberry", orderDate: new Date("2019-01-08T06:12:03Z"),      state: "WA", price: 43, quantity: 134 } ] ) 
此示例在 $setWindowFields 阶段使用 $last 输出每个 state 的最后一个蛋糕销售订单 type:
db.cakeSales.aggregate( [    {       $setWindowFields: {          partitionBy: "$state",          sortBy: { orderDate: 1 },          output: {             lastOrderTypeForState: {                $last: "$type",                window: {                   documents: [ "current", "unbounded" ]                }             }          }       }    } ] ) 
在示例中:
- partitionBy: "$state"按- state对集合中的文档分区。- CA和- WA都有分区。
- sortBy: { orderDate: 1 }按- orderDate以升序 (- 1) 对每个分区中的文档进行排序,因此最早的- orderDate位于最前面。
- output将- lastOrderTypeForState字段设置为- documents窗口中的最后一个订单- type。- window包含介于- current下限(输出中的当前文档)和- unbounded上限之间的文档。这意味着- $last返回当前文档与分区末尾之间的文档的最后一个顺序- type。
在此输出中,CA 和 WA 的最后一个订单 type 值在 lastOrderTypeForState 字段中示出:
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"),   "state" : "CA", "price" : 41, "quantity" : 162, "lastOrderTypeForState" : "vanilla" } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"),   "state" : "CA", "price" : 13, "quantity" : 120, "lastOrderTypeForState" : "vanilla" } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"),   "state" : "CA", "price" : 12, "quantity" : 145, "lastOrderTypeForState" : "vanilla" } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"),   "state" : "WA", "price" : 43, "quantity" : 134, "lastOrderTypeForState" : "chocolate" } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"),   "state" : "WA", "price" : 13, "quantity" : 104, "lastOrderTypeForState" : "chocolate" } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"),   "state" : "WA", "price" : 14, "quantity" : 140, "lastOrderTypeForState" : "chocolate" }