db.collection.findOne()
最后更新于
最后更新于
在本页面
db.collection. findOne(查询，投影)
返回一个满足集合或视图上指定查询条件的文档。如果多个文档满足查询，则此方法根据自然订单返回第一个文档，该文档反映磁盘上文档的 order。在上限集合中，natural order 与 insert order 相同。如果没有文档满足查询，则该方法返回 null。
| 参数 | 类型 | 描述 |
|---|---|---|
projection参数采用以下形式的文档：
<boolean>可以是以下包含或排除值之一：
1或true包括。即使未在投影参数中明确指定字段，findOne()方法也始终包含_id字段。
0或false排除。
projection 参数不能混合 include 和 exclude 规则，而 exception 则排除_id字段。
从MongoDB 4.2开始，如果发出db.collection.findOne()断开连接的客户端在操作完成之前断开连接，则MongoDB将标记db.collection.findOne()为终止（即killOp在操作上）。
以下操作从bios 系列返回单个文档：
以下操作返回bios 系列中的第一个匹配文档，其中嵌入文档name中的字段first以字母G 开头，或字段birth小于new Date('01/01/1945')：
projection参数指定 return 的哪些字段。除非排除属于_id字段，否则该参数包含 include 或 exclude 规范，而不是两者。
以下操作在bios 系列中查找文档，并仅返回name，contribs和_id字段：
以下操作返回bios 系列中的文档，其中contribs字段包含元素OOP，并返回除_id字段，name嵌入文档中的first字段和birth字段之外的所有字段：
您不能将游标方法应用于findOne()的结果，因为返回单个文档。您可以直接访问该文档：
译者：李冠飞
校对：
query
document
可选的。使用query operators指定查询选择条件。
projection
document
可选的。使用投影操作员指定要 return 的字段。省略此参数以 return 匹配文档中的所有字段。
返回：
一个文档满足指定为此方法的第一个参数的条件。如果指定projection参数，findOne()将返回仅包含projection字段的文档。除非您明确排除，否则始终包含_id字段。 虽然类似于find()方法，findOne()方法返回文档而不是游标。