db.collection.find（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.find（）

在本页面

定义
行为
例子

定义¶

db.collection.find（查询，投影）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

在集合或视图中选择文档，然后将光标返回到所选文档。

参数	类型	描述
`query`	文献	可选的。使用查询运算符指定选择过滤器。要返回集合中的所有文档，请忽略此参数或传递一个空文档（`{}`）。
`projection`	文献	可选的。指定要在与查询过滤器匹配的文档中返回的字段。要返回匹配文档中的所有字段，请省略此参数。有关详细信息，请参见投影。

返回值：	一个光标匹配的文件`query` 标准。当该`find()`方法“返回文档”时，该方法实际上是将光标返回到文档。

行为¶

投影¶

该projection参数确定在匹配文档中返回哪些字段。该projection参数采用以下格式的文档：

复制

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

该<value>可以是任何如下：

1或true将该字段包括在退货单据中。
0或false排除该字段。
用投影算子表示。

find()视图上的操作不支持以下投影运算符：
- $
- $elemMatch
- $slice
- $meta

注意

对于该_id字段，您不必显式指定要返回该字段。除非您指定禁止显示该字段，否则该方法始终返回_id字段。_id: 1_idfind()_id: 0

一个projection 不能包含两个包含和排除的规范，除了排除_id领域。在明确包含字段的投影中，该_id字段是您可以明确排除的唯一字段。

游标处理功能¶

db.collection.find()在mongoshell中执行将自动迭代光标以显示最多前20个文档。键入it以继续迭代。

要使用驱动程序访问返回的文档，请使用适用于驱动程序语言的游标处理机制。

也可以看看

迭代返回的游标
修改光标行为
可用的mongo Shell游标方法

阅读关注点¶

要指定读关心的 db.collection.find()，使用cursor.readConcern() 方法。

类型括弧¶

为了进行比较，MongoDB将某些数据类型视为等效。例如，数字类型在比较之前先进行转换。但是，对于大多数数据类型，比较运算符仅对目标字段的BSON类型与查询操作数的类型匹配的文档执行比较。考虑以下集合：

复制

{ "_id": "apples", "qty": 5 }
{ "_id": "bananas", "qty": 7 }
{ "_id": "oranges", "qty": { "in stock": 8, "ordered": 12 } }
{ "_id": "avocados", "qty": "fourteen" }

以下查询用于$gt返回值qty大于的文档4。

复制

db.collection.find( { qty: { $gt: 4 } } )

该查询返回以下文档：

复制

{ "_id": "apples", "qty": 5 }
{ "_id": "bananas", "qty": 7 }

_id等于的文档"avocados"不会返回，因为其qty值是类型，string而 $gt操作数是integer。

_id等于的文档"oranges"未返回，因为其qty值的类型为object。

注意

要在集合中强制使用数据类型，请使用 Schema Validation。

会话¶

版本4.0中的新功能。

对于在会话内创建的游标，不能getMore在会话外调用。

同样，对于在会话外部创建的游标，不能getMore在会话内部调用。

会话空闲超时¶

从MongoDB 3.6开始，MongoDB驱动程序和mongo 外壳程序将所有操作与服务器会话相关联，但未确认的写操作除外。对于未与会话明确关联的操作（即使用Mongo.startSession()），MongoDB驱动程序和mongo外壳程序会创建一个隐式会话并将其与该操作相关联。

如果会话空闲时间超过30分钟，则MongoDB服务器会将会话标记为已过期，并可以随时关闭它。当MongoDB服务器关闭会话时，它还会终止所有正在进行的操作并打开与该会话关联的游标。这包括配置了30分钟noCursorTimeout或maxTimeMS30分钟以上的光标。

对于可能闲置超过30分钟的操作，请使用将该操作与显式会话相关联， Session.startSession()并使用该refreshSessions命令定期刷新该会话。请参阅以获取更多信息。Session Idle Timeout

交易¶

db.collection.find()可以在多文档交易中使用。

对于在事务外部创建的游标，不能getMore在事务内部调用。
对于在事务中创建的游标，不能getMore在事务外部调用。

重要

在大多数情况下，与单文档写入相比，多文档事务产生的性能成本更高，并且多文档事务的可用性不应代替有效的架构设计。在许多情况下，非规范化数据模型（嵌入式文档和数组）对于您的数据和用例将继续是最佳的。也就是说，在许多情况下，对数据进行适当的建模将最大程度地减少对多文档交易的需求。

有关其他事务使用方面的注意事项（例如运行时限制和oplog大小限制），另请参见生产注意事项。

客户端断开¶

从MongoDB 4.2开始，如果发出db.collection.find() 断开连接的客户端在操作完成之前断开连接，则MongoDB将标记db.collection.find()为终止（即killOp在操作上）。

例子¶

本节中的示例使用来自bios集合的文档，这些文档通常具有以下格式：

复制

{
    "_id" : <value>,
    "name" : { "first" : <string>, "last" : <string> },       // embedded document
    "birth" : <ISODate>,
    "death" : <ISODate>,
    "contribs" : [ <string>, ... ],                           // Array of Strings
    "awards" : [
        { "award" : <string>, year: <number>, by: <string> }  // Array of embedded documents
        ...
    ]
}

要创建并填充bios集合，请参见 bios示例集合。

查找集合中的所有文档¶

find()没有参数的方法将返回集合中的所有文档，并返回该文档的所有字段。例如，以下操作将返回bios集合中的所有文档：

复制

db.bios.find()

查找符合查询条件的文档¶

平等查询¶

以下操作返回bios集合中_id等于的文档5：
复制
```
db.bios.find( { _id: 5 } )
```
下列操作返回文档BIOS收集其中场 last中name嵌入文档等于"Hopper"：
复制
```
db.bios.find( { "name.last": "Hopper" } )
```
注意

要访问嵌入式文档中的字段，请使用点符号（）。"<embedded document>.<field>"

查询使用运算符¶

要查找与一组选择标准匹配的文档，请find()使用<criteria>参数进行调用。

MongoDB提供了各种查询运算符来指定条件。

以下操作使用$in运算符返回等于或的bios集合中的文档：_id5ObjectId("507c35dd8fada716c89d0013")
复制
```
db.bios.find(
   { _id: { $in: [ 5, ObjectId("507c35dd8fada716c89d0013") ] } }
)
```
以下操作使用$gt运算符从bios集合中返回birth大于的所有文档：new Date('1950-01-01')
复制
```
db.bios.find( { birth: { $gt: new Date('1950-01-01') } } )
```
以下操作使用$regex运算符返回bios集合中的文档，其中name.last字段以字母N（或为）开头"LIKE N%"
复制
```
db.bios.find(
   { "name.last": { $regex: /^N/ } }
)
```

有关查询运算符的列表，请参见查询选择器。

查询范围¶

组合比较运算符以指定字段的范围。以下操作从bios收集文档返回，其中birth介于和之间（不包括）：new Date('1940-01-01')new Date('1960-01-01')

复制

db.bios.find( { birth: { $gt: new Date('1940-01-01'), $lt: new Date('1960-01-01') } } )

有关查询运算符的列表，请参见查询选择器。

查询多个条件¶

下面的操作返回所有从文件BIOS集合，其中birth场和字段不存在：greater than new Date('1950-01-01')death

复制

db.bios.find( {
   birth: { $gt: new Date('1920-01-01') },
   death: { $exists: false }
} )

有关查询运算符的列表，请参见查询选择器。

查询嵌入式文件¶

以下示例查询bios集合中的name嵌入式字段。

在嵌入式文档上查询精确匹配¶

下列操作返回文档BIOS收集在嵌入文件name是 完全相同 ，包括订单：{ first: "Yukihiro", last: "Matsumoto" }

复制

db.bios.find(
    { name: { first: "Yukihiro", last: "Matsumoto" } }
)

该name字段必须与嵌入文档完全匹配。该查询与具有以下字段的文档不匹配name：

复制

{
   first: "Yukihiro",
   aka: "Matz",
   last: "Matsumoto"
}

{
   last: "Matsumoto",
   first: "Yukihiro"
}

嵌入文档中的查询字段¶

以下操作返回bios集合中的文档，其中嵌入的文档name 包含first具有值"Yukihiro"的字段last和具有值的字段 "Matsumoto"。该查询使用点表示法来访问嵌入式文档中的字段：

复制

db.bios.find(
   {
     "name.first": "Yukihiro",
     "name.last": "Matsumoto"
   }
)

该查询将匹配文档，其中该name字段包含嵌入的文档，该文档的字段first具有值，"Yukihiro"而字段则last具有"Matsumoto"。例如，查询将使文档与具有name以下任一值的字段进行匹配：

复制

{
  first: "Yukihiro",
  aka: "Matz",
  last: "Matsumoto"
}

{
  last: "Matsumoto",
  first: "Yukihiro"
}

有关更多信息和示例，另请参见对嵌入/嵌套文档的查询。

查询阵列¶

查询一个数组元素¶

以下示例查询bios集合中的contribs数组。

以下操作返回bios集合中的文档，其中array字段contribs包含元素"UNIX"：
复制
```
db.bios.find( { contribs: "UNIX" } )
```
以下操作返回bios集合中的文档，其中array字段contribs包含元素"ALGOL"或"Lisp"：
复制
```
db.bios.find( { contribs: { $in: [ "ALGOL", "Lisp" ]} } )
```
以下操作使用$all查询运算符返回bios集合中的文档，其中array字段同时 contribs包含元素"ALGOL"和"Lisp"：
复制
```
db.bios.find( { contribs: { $all: [ "ALGOL", "Lisp" ] } } )
```
有关更多示例，请参见$all。另请参阅$elemMatch。
以下操作使用$size运算符返回数组大小为4 的bios集合中的文档contribs：
复制
```
db.bios.find( { contribs: { $size: 4 } } )
```

有关更多信息和查询数组的示例，请参见：

有关特定于数组的查询运算符的列表，请参见Array。

查询文档数组¶

以下示例查询bios集合中的awards数组。

以下操作返回bios集合中的文档，其中awards 数组包含award字段等于的元素"Turing：
复制
```
db.bios.find(
   { "awards.award": "Turing Award" }
)
```
以下操作返回bios集合中的文档，其中awards 数组包含至少一个元素，且两个award字段均等于且字段大于1980："Turing Award"year
复制
```
db.bios.find(
   { awards: { $elemMatch: { award: "Turing Award", year: { $gt: 1980 } } } }
)
```
使用$elemMatch运算符在数组元素上指定多个条件。

有关更多信息和查询数组的示例，请参见：

有关特定于数组的查询运算符的列表，请参见Array。

投影¶

该projection参数指定要返回的字段。该参数包含“包含”或“排除”规范，但不能同时包含两者，除非“ exclude”用于该_id字段。

注意

除非_id投影文档中明确排除了该字段，否则将返回该字段。_id: 0_id

指定要返回的字段¶

以下操作在bios集合中查找所有文档，并且仅返回name 字段，contribs字段和_id字段：

复制

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

注意

除非_id投影文档中明确排除了该字段，否则将返回该字段。_id: 0_id

明确排除的字段¶

下面的操作查询BIOS收集并返回所有领域，除了 在first该领域中的name嵌入文档和birth 领域：

复制

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

显式排除`_id`字段¶

注意

除非_id投影文档中明确排除了该字段，否则将返回该字段。_id: 0_id

以下操作在bios集合中查找文档，并且仅返回该name 字段和该contribs字段：

复制

db.bios.find(
   { },
   { name: 1, contribs: 1, _id: 0 }
)

在阵列和嵌入式文件¶

以下操作查询bios集合，并返回嵌入式文档中的last字段name以及contribs 数组中的前两个元素：

复制

db.bios.find(
   { },
   {
     _id: 0,
     'name.last': 1,
     contribs: { $slice: 2 }
   }
)

也可以看看

从查询返回的项目字段

迭代返回的游标¶

该find()方法将光标返回到结果。

在里面

MongoDB 中文手册

db.collection.find（）

定义¶

行为¶

投影¶

游标处理功能¶

阅读关注点¶

类型括弧¶

会话¶

会话空闲超时¶

交易¶

客户端断开¶

例子¶

查找集合中的所有文档¶

查找符合查询条件的文档¶

平等查询¶

查询使用运算符¶

查询范围¶

查询多个条件¶

查询嵌入式文件¶

在嵌入式文档上查询精确匹配¶

嵌入文档中的查询字段¶

查询阵列¶

查询一个数组元素¶

查询文档数组¶

投影¶

指定要返回的字段¶

明确排除的字段¶

显式排除_id字段¶

在阵列和嵌入式文件¶

迭代返回的游标¶

显式排除`_id`字段¶