查找文档
您可以使用 方法查询集合中的单个文档。findOne()
方法使用您提供的一份查询文档,仅仅匹配该集合中与该查询匹配的文档的子集。如果未提供查询文档或提供空文档,MongoDB 会匹配该集合中的所有文档。findOne()
操作只返回第一份匹配的文档。有关查询 MongoDB 的更多信息,请参阅查询文档资料。
您还可以定义其他查询选项(例如排序和投影)来配置返回的文档。 您可以在作为findOne
方法的第二个参数传递的options
对象中指定其他选项。 有关详细的参考文档,请参阅 collection.findOne()。
兼容性
您可以使用 Node.js 驱动程序连接到以下环境中托管的部署并对其使用 findOne()
方法:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
MongoDB Enterprise:基于订阅、自行管理的 MongoDB 版本
MongoDB Community:source-available、免费使用且可自行管理的 MongoDB 版本
要详细了解如何在 Atlas 用户界面中为 MongoDB Atlas 托管的部署查找文件,请参阅创建、查看、更新和删除文档。
例子
以下代码段查找 movies
集合中的单个文档。它使用以下参数:
一个查询文档,用于配置查询,仅返回标题与文本
'The Room'
完全相同的电影。一种排序方式,它可按评分降序排列匹配的文档;因此,如果查询能匹配多个文档,返回的文档则是评分最高的文档。
一个投影,它会从返回的文档中显式排除
_id
字段并显式仅包含title
和imdb
对象(及其嵌入式字段)。
注意
可以使用此示例连接到 MongoDB 实例,并与包含样本数据的数据库进行交互。如需了解有关连接到 MongoDB 实例和加载样本数据集的更多信息,请参阅使用示例指南。
运行前一示例应能看到以下输出:
{ title: 'The Room', imdb: { rating: 3.5, votes: 25673, id: 368226 } }