从查询返回的项目字段
默认情况下,MongoDB中的查询返回匹配文档中的所有字段。 要限制MongoDB发送给应用程序的数据量,可以包含一个projection
文档以指定或限制要返回的字段。
本页提供使用mongo
shell中的db.collection.find()
方法进行projection
的查询操作示例。 此页面上的示例使用inventory收集。 要填充inventory收集,请运行以下命令:
db.inventory.insertMany( [
{ item: "journal", status: "A", size: { h: 14, w: 21, uom: "cm" }, instock: [ { warehouse: "A", qty: 5 } ] },
{ item: "notebook", status: "A", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "C", qty: 5 } ] },
{ item: "paper", status: "D", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "A", qty: 60 } ] },
{ item: "planner", status: "D", size: { h: 22.85, w: 30, uom: "cm" }, instock: [ { warehouse: "A", qty: 40 } ] },
{ item: "postcard", status: "A", size: { h: 10, w: 15.25, uom: "cm" }, instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] }
]);
返回匹配文档中的所有字段
如果未指定projection文档,则 db.collection.find()
方法将返回匹配文档中的所有字段。
下面的例子返回inventory集合中状态为“A”的所有文档中的所有字段:
db.inventory.find( { status: "A" } )
该操作对应于以下SQL语句:
SELECT * from inventory WHERE status = "A"
仅返回指定的字段和_id字段
通过将投影文档中的<field
>设置为1,投影可以显式包括多个字段。 以下操作返回与查询匹配的所有文档。在结果集中,只有项目、状态和_id字段(默认情况下)在匹配的文档中返回。
db.inventory.find( { status: "A" }, { item: 1, status: 1 } )
该操作对应于以下SQL语句:
SELECT _id, item, status from inventory WHERE status = "A"
禁止_id
Field
您可以通过在投影中将_id字段设置为0来从结果中删除,如下面的示例所示:
db.inventory.find( { status: "A" }, { item: 1, status: 1, _id: 0 } )
该操作对应于以下SQL语句:
SELECT item, status from inventory WHERE status = "A"
[success] Note
除了_id字段之外,您不能在projection文档中合并包含和排除语句。
返回除了被排除的字段之外的所有字段
您可以使用projection来排除特定的字段,而不是列出要在匹配的文档中返回的字段。下面的例子将返回匹配文档中除了status和instock字段之外的所有字段:
db.inventory.find( { status: "A" }, { status: 0, instock: 0 } )
注意
除了_id字段之外,您不能在projection文档中合并包含和排除语句。
返回嵌入式文档中的特定字段
您可以返回嵌入式文档中的特定字段。 使用点表示法引用嵌入式字段,并在投影文档中将其设置为1。
以下示例返回:
_id字段(默认情况下返回).
项目字段.
状态字段.
大小文档中的uom字段.
uom字段仍然嵌入在size文档中。
db.inventory.find(
{ status: "A" },
{ item: 1, status: 1, "size.uom": 1 }
)
从MongoDB 4.4开始,你也可以使用嵌套的形式指定嵌入的字段,例如{item: 1, status: 1, size: {uom: 1}}。
禁止嵌入文档中的特定字段
您可以隐藏嵌入式文档中的特定字段。 使用点表示法引用projection文档中的嵌入字段并将其设置为0。
以下示例指定一个投影,以排除size文档内的uom字段。 其他所有字段均在匹配的文档中返回:
db.inventory.find(
{ status: "A" },
{ "size.uom": 0 }
)
从MongoDB 4.4开始,你也可以使用嵌套的形式指定嵌入的字段,例如{size: {uom: 0}}。
数组中嵌入式文档的Projection
使用点表示法可将特定字段projection在嵌入数组的文档中。
以下示例指定要返回的projection:
- _id字段(默认情况下返回)
- 项目字段
- 状态字段
instock数组中嵌入的文档中的数量字段
db.inventory.find( { status: "A" }, { item: 1, status: 1, "instock.qty": 1 } )
返回数组中的项目特定数组元素
对于包含数组的字段,MongoDB提供以下用于操纵数组的投影运算符:
$elemMatch
,$slice
和$
。
以下示例使用$slice
projection运算符返回instock数组中的最后一个元素:
db.inventory.find( { status: "A" }, { item: 1, status: 1, instock: { $slice: -1 } } )
$elemMatch
,$slice
和$
是projection要包含在返回数组中的特定元素的唯一方法。 例如,您不能使用数组索引来投影特定的数组元素。 例如 {“ instock.0”:1}projection不会projection第一个元素的数组。
额外的注意事项
从MongoDB 4.4开始,MongoDB对projections施加了额外的限制。有关详细信息,请参阅Projection Restrictions
。
另请参考:
译者:杨帅
校对:杨帅
参见