查找

sort

可选。确定返回文档中包含哪些字段的投影规范。请参阅投影和投影运算符。

视图上的find()操作不支持以下查询和投影运算符运算符

• $

• $elemMatch

• $slice

• $meta

可选。索引规范。指定索引名称作为字符串或索引键模式。如果指定，则查询系统将只考虑使用提示索引的计划。

有以下例外，如果命令包括min和/或max字段，则需要hint；如果filter是关于_id字段的等价条件{ _id: <value> }，则不需要hint。

可选。第一次批处理中返回的文档数。默认为101。batchSize为0表示将建立光标，但第一次批处理中不会返回任何文档。

与之前的网络协议版本不同，find命令中batchSize为1不会关闭光标。

单批次

可选。用户提供的用于附加到此命令的注释。一旦设置，此注释将出现在以下位置的此命令记录旁边

• mongod日志消息，在attr.command.cursor.comment字段。

• 数据库分析器输出，在command.comment字段。

• currentOp输出，在command.comment字段。

注释可以是任何有效的BSON类型（字符串、整数、对象、数组等）。

设置在find命令上的任何注释都将继承在find游标上运行的任何后续getMore命令。

可选。

指定毫秒数的时间限制。如果您未指定maxTimeMS的值，则操作不会超时。显式指定0将指定默认的无界行为。

MongoDB使用与db.killOp()相同的机制终止超过其分配时间限制的操作。MongoDB仅在操作的一个指定的中断点处终止操作。

指定线性一致性读取关注时，始终使用maxTimeMS，以防大部分数据承载成员不可用。maxTimeMS确保操作不会无限期阻塞，并且如果读取关注无法满足，则返回错误。

可选。指定读取关注。

readConcern选项具有以下语法：readConcern: { level: <value> }

可能的读取关注级别如下

• "local"。这是针对主节点和副本节点的读取操作默认的读取关注级别。

• "available"。适用于对主节点和副本节点的读取操作。"available"在与主节点和非分片副本节点的操作中表现与"local"相同。查询返回实例的最新数据。

• "majority"。适用于使用WiredTiger存储引擎的副本集。

• "linearizable"。仅适用于主节点的读取操作。

有关读取关注级别的更多信息，请参阅读取关注级别。

getMore 命令使用在原始 find 命令中指定的 readConcern 级别。

可选。特定索引的独占上限。有关详细信息，请参阅 cursor.max()。

要使用 max 字段，命令还必须使用 hint，除非指定的 filter 是 _id 字段的等值条件 { _id: <value> }。

可选。特定索引的包含下限。有关详细信息，请参阅 cursor.min()。

要使用 min 字段，命令还必须使用 hint，除非指定的 filter 是 _id 字段的等值条件 { _id: <value> }。

可选。对于针对分片集合的查询，如果查询的一个或多个分片不可用，则允许命令（或后续的 getMore 命令）返回部分结果，而不是错误。

如果因为查询的分片不可用，find（或后续的 getMore 命令）返回部分结果，则 find 输出 包含一个 partialResultsReturned 指示字段。如果查询的分片对初始 find 命令可用，但一个或多个分片在后续的 getMore 命令中不可用，则只有当分片不可用时的 getMore 命令的输出中包含 partialResultsReturned。

可选。

指定操作要使用的 排序规则。

排序（Collation）允许用户指定字符串比较的语言特定规则，例如字母大小写和重音符号的规则。

排序选项具有以下语法

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

指定排序时，locale字段是必需的；所有其他排序字段都是可选的。有关字段的描述，请参阅排序文档。

如果未指定排序，但集合具有默认排序（见db.createCollection()），则操作使用为集合指定的排序。

如果未为集合或操作指定排序，MongoDB将使用在先前版本中用于字符串比较的简单二进制比较。

您不能为一个操作指定多个排序。例如，您不能按字段指定不同的排序，或者在执行带有排序的查找时，您不能为查找和排序使用不同的排序。

allowDiskUse

可选。

使用此选项可以覆盖特定查询的allowDiskUseByDefault。您可以使用此选项来

• 在默认允许磁盘使用的系统上禁止磁盘使用。

• 在默认禁止磁盘使用的系统上允许磁盘使用。

从MongoDB 6.0开始，如果allowDiskUseByDefault设置为true且服务器对管道执行阶段需要超过100兆字节的内存，MongoDB将自动将临时文件写入磁盘，除非查询指定{ allowDiskUse: false }。

有关详细信息，请参阅allowDiskUseByDefault。

allowDiskUse如果MongoDB可以使用索引满足指定的排序，或者如果阻止排序需要小于100兆字节的内存，则没有效果。

有关allowDiskUse的更完整文档，请参阅cursor.allowDiskUse()。

有关大型阻止排序的内存限制的更多信息，请参阅排序和索引使用。

可选。

指定一个包含变量列表的文档。这允许您通过将变量从查询文本中分离出来来提高命令的可读性。

文档语法是

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

变量设置为表达式返回的值，之后无法更改。

要在命令中访问变量的值，请使用双美元符号前缀（$$）与变量名一起，形式为$$<variable_name>。例如：$$targetTotal。

要使用变量过滤结果，必须在$expr运算符中访问变量。

有关使用let和变量的完整示例，请参阅在let中使用变量。