指定返回字段

本页内容

概述

示例数据
投影类型
指定包含字段
排除_id字段
指定排除字段
故障排除
“在包含投影中不能排除字段 <field>”
更多信息
API文档

概述

在本指南中，您可以学习如何使用投影来指定从读取操作中返回的字段。投影是一个文档，用于指定MongoDB从查询中返回哪些字段。

示例数据

本指南中的示例使用来自sample_restaurants.restaurants 集合的Atlas 示例数据集。要了解如何创建免费的 MongoDB Atlas 集群并加载数据集，请参阅使用 PyMongo 入门指南。使用 PyMongo 入门指南。

投影类型

您可以使用投影来指定要包含在返回文档中的字段，或指定要排除的字段。除非您正在排除 _id 字段，否则您不能在单个投影中组合包含和排除语句。

指定要包含的字段

使用以下语法指定要在结果中包含的字段

{ "<Field Name>": 1 }

以下示例使用 find() 方法查找所有名称字段值为 "Emerald Pub" 的餐厅。然后使用投影只返回返回文档中的 name、cuisine 和 borough 字段。

results = restaurants.find({ "name" : "Emerald Pub"}, {"name": 1, "cuisine": 1, "borough": 1})
for restaurant in results:
    print(restaurant)

{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'}
{'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}

当你使用投影指定要包含在返回文档中的字段时，默认情况下也会包含 _id 字段。所有其他字段都隐式排除。要从返回文档中删除 _id 字段，你必须显式排除它。

排除 `_id` 字段

在指定要包含的字段时，您还可以从返回文档中排除 _id 字段。

以下示例执行与前面示例相同的查询，但排除投影中的 _id 字段

results = restaurants.find({ "name" : "Emerald Pub"}, {"_id": 0, "name": 1, "cuisine": 1, "borough": 1})
for restaurant in results:
    print(restaurant)

{'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'}
{'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}

指定要排除的字段

使用以下语法指定要排除的结果中的字段

{ "<Field Name>": 0 }

以下示例使用find()方法来查找所有名为"Emerald Pub"的餐厅。然后使用投影来排除返回文档中的grades和address字段。

results = restaurants.find({ "name" : "Emerald Pub"}, {"grades": 0, "address": 0} )
for restaurant in results:
    print(restaurant)

{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40367329'}
{'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American',
'name': 'Emerald Pub', 'restaurant_id': '40668598'}

当使用投影指定要排除的字段时，任何未指定的字段都将隐式包含在返回文档中。

故障排除

以下各节描述了使用投影时可能会看到的错误。

'在包含投影中不能排除字段 <field>'

如果您尝试在单个投影中包含和排除字段，驱动程序将返回带有此消息的OperationFailure。请确保您的投影只指定要包含的字段或要排除的字段。

概述