db.collection.findOne()

定义

db.collection.findOne(query, projection, options)

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

有关数据库命令，请参阅 find 命令。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

在集合或视图中返回一个满足指定查询条件的文档。

返回的文档可能会有所不同，这取决于符合查询条件的文档数量和使用的查询计划：

匹配文档的数量	查询计划	结果
0	Any	该方法返回 null
1	Any	该方法返回满足指定查询条件的文档。
2 或更多	集合扫描(collection scan)	该方法根据自然顺序返回第一个文档。在固定大小集合中，自然顺序与插入顺序相同。
2 或更多	索引扫描	该方法返回从索引中检索到的第一个文档。

重要

如果将查询计划更改为使用不同的索引，则该方法可能会返回不同的文档。如果您的使用案例要求以一致的方式选择特定记录，则必须使用 options 文档来指定排序。有关配合 options 文档中使用 findOne() 的详细信息，请参阅示例。

如果您指定 projection 参数，findOne() 将返回仅包含 projection 字段的文档。除非您显式排除 _id 字段，否则该字段将始终包含在内。

注意

虽然与 find() 方法类似，但 findOne() 方法返回的是文档而不是游标。

兼容性

此方法可用于以下环境中托管的部署：

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

findOne() 方法采用以下形式：

db.collection.findOne( <query>, <projection>, <options> )

findOne() 方法使用以下参数：

行为

{ field1: <value>, field2: <value> ... }

示例

db.bios.findOne()

db.bios.findOne(
   {
     $or: [
            { 'name.first' : /^G/ },
            { birth: { $lt: new Date('01/01/1945') } }
          ]
   }
)

db.bios.findOne(
    { },
    { name: 1, contribs: 1 }
)

db.bios.findOne(
   { contribs: 'OOP' },
   { _id: 0, 'name.first': 0, birth: 0 }
)

db.bios.findOne(
   { },
   { },
   { sort: { birth: 1 } }
)

var myDocument = db.bios.findOne();
if (myDocument) {
   var myName = myDocument.name;
   print (tojson(myName));
}

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

db.cakeFlavors.findOne(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { _id: 0 },
   { let : { targetFlavor: "chocolate" }
} )

{ flavor: 'chocolate' }