$where

在本页面

Definition

$where
- 使用$where运算符可将包含 JavaScript 表达式的字符串或完整的 JavaScript 函数传递给查询系统。 $where提供了更大的灵 Active，但是要求数据库处理集合中每个文档的 JavaScript 表达式或函数。使用this或obj在 JavaScript 表达式或函数中引用文档。

Important

在版本 3.6 中更改：$expr运算符允许在查询语言中使用aggregation expressions。 $expr比$where快，因为它不执行 JavaScript，因此应首选使用。

Behavior

Restrictions

map-reduce operations，group命令和$where运算符表达式**无法访问mongoShell 程序中可用的某些全局函数或属性，例如db。

下列 JavaScript 函数和属性**可用于map-reduce operations，group命令和$where运算符表达式：

Available Properties	Available Functions
`args`
`MaxKey` `MinKey`	`assert()` `BinData()` `DBPointer()` `DBRef()` `doassert()` `emit()` `gc()` `HexData()` `hex_md5()` `isNumber()` `isObject()` `ISODate()` `isString()`	`Map()` `MD5()` `NumberInt()` `NumberLong()` `ObjectId()` `print()` `printjson()` `printjsononeline()` `sleep()` `Timestamp()` `tojson()` `tojsononeline()` `tojsonObject()` `UUID()` `version()`

elemMatch

仅将$where查询运算符应用于顶级文档。 $where查询运算符将无法在嵌套文档中使用，例如，在$elemMatch查询中。

Considerations

不要使用全局变量。
$where评估 JavaScript，无法利用索引。因此，当您使用标准 MongoDB 运算符(例如$gt，$in)表达查询时，查询性能会提高。
通常，仅当无法使用其他运算符表达查询时，才应使用$where。如果必须使用$where，请尝试至少包含其他一个标准查询运算符来过滤结果集。单独使用$where需要进行收集扫描。

使用普通的非$where查询语句具有以下性能优势：

MongoDB 将在$where条语句之前评估非$where条查询的组成部分。如果非$where语句不匹配任何文档，则 MongoDB 将不会使用$where执行任何查询评估。
非$where查询语句可以使用index。

Example

考虑players集合中的以下文档：

{
   _id: 12378,
   name: "Steve",
   username: "steveisawesome",
   first_login: "2017-01-01"
}
{
   _id: 2,
   name: "Anya",
   username: "anya",
   first_login: "2001-02-02"
}

以下示例使用$where和hex_md5() JavaScript 函数将name字段的值与 MD5 哈希值进行比较，并返回任何匹配的文档。

db.players.find( { $where: function() {
   return (hex_md5(this.name) == "9b53e667f30cd329dca1ec9e6a83e994")
} } );

该操作返回以下结果：

{
   "_id" : 2,
   "name" : "Anya",
   "username" : "anya",
   "first_login" : "2001-02-02"
}

首页