$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" }