“文档” 菜单
文档首页
/
MongoDB Manual
/
聚合操作
/
聚合参考资料
/
聚合操作符

$arrayElemAt（聚合）

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 行为
  • 例子
  • 另请参阅

定义

$arrayElemAt

返回位于指定数组索引处的元素。

兼容性

可以使用 $arrayElemAt 查找托管在以下环境中的部署：

  • MongoDB Atlas ：用于在云中部署 MongoDB 的完全托管服务

  • MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

  • MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

$arrayElemAt 通过以下语法实现：

{ $arrayElemAt: [ <array>, <idx> ] }

<array> 表达式可为能解析为数组的任意有效表达式。

<idx> 表达式可为能解析为整数的任意有效表达式。

有关表达式的更多信息，请参阅表达式运算符。

行为

  • 如果<idx>表达式解析为零或正整数， $arrayElemAt则会返回位于idx位置（从数组的开头算起）的元素。

  • 如果 <idx> 表达式解析为负整数，$arrayElemAt 会返回位于 idx 位置（从数组末尾算起）的元素。

  • 如果idx超过数组边界，则$arrayElemAt不会返回结果。

  • 如果<array>表达式解析为未定义的数组，则$arrayElemAt返回null 。

例子
结果
{ $arrayElemAt: [ [ 1, 2, 3 ], 0 ] }
1
{ $arrayElemAt: [ [ 1, 2, 3 ], -2 ] }
2
{ $arrayElemAt: [ [ 1, 2, 3 ], 15 ] }
{ $arrayElemAt: [ "$undefinedField", 0 ] }
null

例子

一个名为 users 的集合包含以下文档：

{ "_id" : 1, "name" : "dave123", favorites: [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", favorites: [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", favorites: [ "pears", "pecans", "chocolate", "cherries" ] }
{ "_id" : 4, "name" : "ty", favorites: [ "ice cream" ] }

以下示例将返回 favorites 数组中的第一个和最后一个元素：

db.users.aggregate([
   {
     $project:
      {
         name: 1,
         first: { $arrayElemAt: [ "$favorites", 0 ] },
         last: { $arrayElemAt: [ "$favorites", -1 ] }
      }
   }
])

操作返回以下结果：

{ "_id" : 1, "name" : "dave123", "first" : "chocolate", "last" : "apples" }
{ "_id" : 2, "name" : "li", "first" : "apples", "last" : "pie" }
{ "_id" : 3, "name" : "ahn", "first" : "pears", "last" : "cherries" }
{ "_id" : 4, "name" : "ty", "first" : "ice cream", "last" : "ice cream" }

另请参阅

后退

$anyElementTrue（聚合）

来年

$arrayToObject（聚合）

在此页面上