Docs 菜单

Docs 主页 → 开发应用程序 → MongoDB Manual

$slice（投影）

在此页面上

  • 定义
  • 语法
  • 行为
  • 举例

定义

$slice

$slice投影操作符指定数组中要在查询结果中返回的元素数。

注意

消歧

关于在使用 $push 更新期间限制数组大小的信息，请参阅 $slice 修改器。

有关聚合操作符，请参阅 $slice 聚合操作符。

语法

$slice采用以下语法形式之一：

db.collection.find(
   <query>,
   { <arrayField>: { $slice: <number> } }
);

或

db.collection.find(
   <query>,
   { <arrayField>: { $slice: [ <number>, <number> ] } }
);
值
说明
$slice: <number>

指定了要在 <arrayField> 中返回的元素数。对于 <number>：

  • 指定正数 n 以返回前 n 个元素。

  • 指定一个负数 n 以返回最后的 n 个元素。

如果 <number> 大于数组元素数，此查询则会返回所有数组元素。

$slice: [ <number to skip>, <number to return> ]

指定从第一个元素开始跳过指定数量的元素后要在 <arrayField> 中返回的元素数量。必须同时指定这两个元素。

对于 <number to skip>：

  • 指定一个正数 n 以从数组开头跳过 n 个元素；即第 0 个索引位置。基于从零开始的数组索引，1 表示第二个元素的起始位置，依此类推。如果 n 大于数组元素的数量，则查询将为 <arrayField> 返回一个空数组。

  • 指定一个负数 n 可从数组开头向后跳过 n 个元素；即，第 0 个索引位置。针对从零开始的数组索引（即，第一个元素位于索引 0），-1 表示最后一个元素的起始位置。如果此负数的绝对值大于数组元素数，则起始位置为数组的起始位置。

对于 <number to return>，您必须指定一个正数 n，以返回在跳过指定数字之后的接下来 n 个元素。

行为

$slice 嵌入式数组

当投影是包含投影的一部分时，嵌套文档中数组的$slice投影不再返回嵌套文档中的其他字段。

例如，考虑一个文档集合 inventory，其中的文档包含 size 字段：

{ item: "socks", qty: 100, details: { colors: [ "blue", "red" ], sizes: [ "S", "M", "L"] } }

以下操作仅使用colors数组的指定切片来项目_id字段（默认情况下）、 qty字段和details字段：

db.inventory.find( { }, { qty: 1, "details.colors": { $slice: 1 } } )

换言之，该操作会返回以下文档：

{ "_id" : ObjectId("5ee92a6ec644acb6d13eedb1"), "qty" : 100, "details" : { "colors" : [ "blue" ] } }

如果$slice投影是排除投影的一部分，则该操作将继续返回嵌套文档中的其他字段。也就是说，以下投影是排除投影。投影会排除_id字段以及colors数组中位于指定切片之外的元素，并返回所有其他字段。

db.inventory.find( { }, { _id: 0, "details.colors": { $slice: 1 } } )
{ "item" : "socks", "qty" : 100, "details" : { "colors" : [ "blue" ], "sizes" : [ "S", "M", "L" ] } }

$slice投影本身被视为排除。

在以前的版本中， $slice投影还包括嵌套文档中的其他字段，无论投影是包含投影还是排除投影。

查看限制

db.collection.find()视图$slice 上的 操作不支持 投影操作符。

$ 位置操作符和$slice限制

find和findAndModify投影不能包含$slice投影表达式作为$投影表达式的一部分。

例如，以下操作无效：

db.inventory.find( { "instock.qty": { $gt: 25 } }, { "instock.$": { $slice: 1 } } )

在之前的版本中，MongoDB 返回instock数组中符合查询条件的第一个元素（ instock.$）；即位置投影"instock.$"优先，而$slice:1是无需操作。"instock.$": { $slice: 1 }不排除任何其他文档字段。

路径冲突：数组和嵌入式字段的$slice

find和findAndModify投影不能同时包含数组的$slice和嵌入在该数组中的字段。

例如，考虑包含数组字段 instock 的集合 inventory：

{ ..., instock: [ { warehouse: "A", qty: 35 }, { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ], ... }

以下操作失败并显示Path collision错误：

db.inventory.find( {}, { "instock": { $slice: 1 }, "instock.warehouse": 0 } )

在以前的版本中，投影应用两个投影并返回instock数组中的第一个元素 ($slice: 1)，但抑制投影元素中的warehouse字段。从 MongoDB 4.4 开始，要获得相同的结果，请使用具有两个独立 $project 阶段的 db.collection.aggregate() 方法。

提示

另请参阅：

投射

举例

创建一个包含以下文档的集合 posts：

db.posts.insertMany([
   {
     _id: 1,
     title: "Bagels are not croissants.",
     comments: [ { comment: "0. true" }, { comment: "1. croissants aren't bagels."} ]
   },
   {
     _id: 2,
     title: "Coffee please.",
     comments: [ { comment: "0. fooey" }, { comment: "1. tea please" }, { comment: "2. iced coffee" }, { comment: "3. cappuccino" }, { comment: "4. whatever" } ]
   }
])

返回包含前 3 个元素的数组

以下操作使用comments数组上的$slice投影操作符来返回该数组及其前三个元素。如果数组的元素少于三个，则返回数组中的所有元素。

db.posts.find( {}, { comments: { $slice: 3 } } )

该操作将返回以下文档：

{
   "_id" : 1,
   "title" : "Bagels are not croissants.",
   "comments" : [ { "comment" : "0. true" }, { "comment" : "1. croissants aren't bagels." } ]
}
{
   "_id" : 2,
   "title" : "Coffee please.",
   "comments" : [ { "comment" : "0. fooey" }, { "comment" : "1. tea please" }, { "comment" : "2. iced coffee" } ]
}

返回包含前 3 个元素的数组

以下操作使用comments数组上的$slice投影操作符来返回数组及其最后三个元素。如果数组的元素少于三个，则返回数组中的所有元素。

db.posts.find( {}, { comments: { $slice: -3 } } )

该操作将返回以下文档：

{
   "_id" : 1,
   "title" : "Bagels are not croissants.",
   "comments" : [ { "comment" : "0. true" }, { "comment" : "1. croissants aren't bagels." } ]
}
{
   "_id" : 2,
   "title" : "Coffee please.",
   "comments" : [ { "comment" : "2. iced coffee" }, { "comment" : "3. cappuccino" }, { "comment" : "4. whatever" } ]
}

跳过第一个元素后返回一个包含 3 个元素的数组

以下操作使用comments数组上的$slice投影操作符执行以下操作：

  • 跳过第一个元素，从而使第二个元素成为起点。

  • 然后，从起点开始返回三个元素。

如果跳转后数组中的元素少于三个，则会返回所有剩余元素。

db.posts.find( {}, { comments: { $slice: [ 1, 3 ] } } )

该操作将返回以下文档：

{
   "_id" : 1,
   "title" : "Bagels are not croissants.",
   "comments" : [ { "comment" : "1. croissants aren't bagels." } ]
}
{
   "_id" : 2,
   "title" : "Coffee please.",
   "comments" : [ { "comment" : "1. tea please" }, { "comment" : "2. iced coffee" }, { "comment" : "3. cappuccino" } ]
}

跳过最后一个元素后返回一个包含 3 个元素的数组

以下操作使用comments数组上的$slice投影操作符来

  • 从第一个元素向后跳转，从而以最后一个元素为起点。

  • 然后，从起点开始返回三个元素。

如果跳转后数组中的元素少于三个，则会返回所有剩余元素。

db.posts.find( {}, { comments: { $slice: [ -1, 3 ] } } )

该操作将返回以下文档：

{
   "_id" : 1,
   "title" : "Bagels are not croissants.",
   "comments" : [ { "comment" : "1. croissants aren't bagels." } ]
}
{
   "_id" : 2,
   "title" : "Coffee please.",
   "comments" : [ { "comment" : "4. whatever" } ]
}
← $elemMatch（投影）
其他查询操作符 →

在此页面上