cursor.max()

在本页面

• Definition

• Behavior

• Example

Definition

• cursor. max ( )
  • 指定特定索引的* exclusive *上限，以约束find()的结果。 max()提供了一种指定复合键索引上限的方法。

max()方法具有以下参数：

indexBounds参数具有以下原型形式：

{ field1: <max value>, field2: <max value2> ... fieldN:<max valueN> }

这些字段与特定索引的所有键对应(按 Sequences)。您可以使用hint()方法显式指定特定索引。否则，mongod使用indexBounds中的字段选择索引；但是，如果多个索引存在于具有不同排序 Sequences 的相同字段上，则索引的选择可能会模棱两可。

max()主要用于支持mongos(分片)过程，并且是查询修饰符$max的 Shell 包装。

Behavior

与索引选择的交互

因为max()需要在字段上构建索引，并强制查询使用该索引，所以如果可能的话，您可能更喜欢使用$lt运算符进行查询。考虑以下示例：

db.products.find( { _id: 7 } ).max( { price: 1.39 } )

该查询将使用price字段上的索引，即使_id上的索引可能更好。

Index Bounds

如果您使用max()和min()来指定范围：

• min()和max()中指定的索引范围必须都引用同一索引的键。

• max()指定的边界必须大于min()指定的边界。

在版本 3.6.6 中进行了更改。

max()没有 min()

min和max运算符指示系统应避免常规查询计划。相反，它们构造索引扫描，其中索引范围由min和max中给出的值明确指定。

Example

本示例假定一个名为products的集合包含以下文档：

{ "_id" : 6, "item" : "apple", "type" : "cortland", "price" : 1.29 }
{ "_id" : 2, "item" : "apple", "type" : "fuji", "price" : 1.99 }
{ "_id" : 1, "item" : "apple", "type" : "honey crisp", "price" : 1.99 }
{ "_id" : 3, "item" : "apple", "type" : "jonagold", "price" : 1.29 }
{ "_id" : 4, "item" : "apple", "type" : "jonathan", "price" : 1.29 }
{ "_id" : 5, "item" : "apple", "type" : "mcintosh", "price" : 1.29 }
{ "_id" : 7, "item" : "orange", "type" : "cara cara", "price" : 2.99 }
{ "_id" : 10, "item" : "orange", "type" : "navel", "price" : 1.39 }
{ "_id" : 9, "item" : "orange", "type" : "satsuma", "price" : 1.99 }
{ "_id" : 8, "item" : "orange", "type" : "valencia", "price" : 0.99 }

该集合具有以下索引：

{ "_id" : 1 }
{ "item" : 1, "type" : 1 }
{ "item" : 1, "type" : -1 }
{ "price" : 1 }

• 使用{ item: 1, type: 1 }索引的 Sequences，max()将查询限制到item等于apple和type等于jonagold的边界以下的文档：

db.products.find().max( { item: 'apple', type: 'jonagold' } ).hint( { item: 1, type: 1 } )

该查询返回以下文档：

{ "_id" : 6, "item" : "apple", "type" : "cortland", "price" : 1.29 }
{ "_id" : 2, "item" : "apple", "type" : "fuji", "price" : 1.99 }
{ "_id" : 1, "item" : "apple", "type" : "honey crisp", "price" : 1.99 }

如果查询没有使用hint()方法显式指定索引，则关于mongod是选择{ item: 1, type: 1 }索引排序还是{ item: 1, type: -1 }索引排序是不确定的。

• 使用索引{ price: 1 }的 Sequences，max()将查询限制在price等于1.99的索引键边界以下的文档，而min()将查询限制在price等于1.39的索引键边界以下的文档：

db.products.find().min( { price: 1.39 } ).max( { price: 1.99 } ).hint( { price: 1 } )

该查询返回以下文档：

{ "_id" : 10, "item" : "orange", "type" : "navel", "price" : 1.39 }