어디

이 페이지의 내용

정의

호환성
구문
행동
사용 가능한 JavaScript 속성 및 함수
elemMatch
고려 사항
JavaScript 활성화
지원되지 않는 배열 및 문자열 함수
예시

정의

$where: $where 연산자를 사용하여 JavaScript 표현식이 포함된 문자열 또는 전체 JavaScript 함수를 쿼리 시스템으로 전달합니다. #mongodb-query-op.-where는 더 큰 유연성을 제공하지만, 데이터베이스가 컬렉션의 각 문서에 대해 JavaScript 표현식 또는 함수를 처리해야 합니다. this 또는 obj를 사용하여 JavaScript 표현식 또는 함수에서 문서를 참조합니다.

호환성

다음 환경에서 호스팅되는 배포에 $where 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

$where 연산자의 형식은 다음과 같습니다.

{ $where: <string|JavaScript Code> }

참고

$where는 더 이상 사용되지 않는 BSON 유형 범위의 JavaScript 코드(BSON 유형 15)를 지원하지 않습니다. $where 연산자는 BSON 유형 스트링(BSON 유형 2) 또는 BSON 유형 JavaScript(BSON 유형 13)만 지원합니다. $where 범위의 BSON 유형 JavaScript의 사용은 MongoDB 4.2.1 이후로 더 이상 사용되지 않습니다.

참고

선호하는 집계 대안

$expr 연산자를 사용하면 쿼리 언어 내에서 집계 표현식을 사용할 수 있습니다. $function 및 $accumulator를 사용하면 제공된 파이프라인 연산자가 애플리케이션의 요구 사항을 충족할 수 없는 경우 사용자가 JavaScript에서 사용자 지정 집계 표현식을 정의할 수 있습니다.

사용 가능한 집계 연산자가 주어집니다.

JavaScript를 사용하지 않는 집계 연산자와 함께 $expr 를 사용하는 경우(예: 비-$function 및 비-$accumulator 연산자)는 JavaScript를 실행하지 않기 때문에 $where보다 빠르며 가능하면 선호되어야 합니다.
그러나 사용자 지정 표현식을 작성해야 하는 경우에는 $where보다 $function을 사용하는 것이 좋습니다.

행동

사용 가능한 JavaScript 속성 및 함수

map-reduce operations 및 $where 연산자 표현식은 mongosh에서 사용할 수 있는 db와 같은 특정 글로벌 함수 또는 속성에 액세스 불가합니다.

다음 JavaScript 함수 및 속성은 및 map-reduce operations 및 $where연산자 표현식에 사용할 수 있습니다.

사용 가능한 속성	사용 가능한 기능
`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 쿼리) 내부에서는 작동하지 않습니다.

고려 사항

전역 변수를 사용하지 마십시오.
$where는 JavaScript를 평가하며 인덱스를 활용할 수 없습니다. 따라서 표준 MongoDB 연산자(예: $gt, $in)를 사용하여 쿼리를 표현하면 쿼리 성능이 향상됩니다.
일반적으로 $where는 다른 연산자를 사용하여 쿼리를 표현할 수 없는 경우에만 사용해야 합니다. $where를 사용해야 하는 경우 결과를 필터링하기 위해 하나 이상의 다른 표준 쿼리 연산자를 포함하세요. $where를 단독으로 사용하려면 컬렉션 스캔이 필요합니다.

일반 비-$where 쿼리 문을 사용하면 다음과 같은 성능상의 이점이 있습니다:

MongoDB는 $where 문 이전에 쿼리의 $where가 아닌 구성 요소를 평가합니다. $where가 아닌 문이 문서와 일치하지 않으면 MongoDB는 $where를 사용하여 쿼리 평가를 수행하지 않습니다.
$where가 아닌 쿼리 문은 인덱스를 사용할 수 있습니다.

JavaScript 활성화

$where(또는 $function, $accumulator 또는 mapReduce)를 사용하려면 서버 사이드 스크립팅을 활성화해야 합니다(기본값).

그러나 이러한 작업을 사용하지 않는 경우 서버 쪽 스크립팅을 사용하지 않도록 설정합니다.

mongod 인스턴스의 경우 security.javascriptEnabled 구성 옵션 또는 명령줄 옵션을 참조하세요 --noscripting.
mongos 인스턴스의 경우 security.javascriptEnabled 구성 옵션 또는 --noscripting 명령줄 옵션을 참조하세요.

또한 ➤ 보안 구성 옵션으로 MongoDB 실행을 참조하세요.

지원되지 않는 배열 및 문자열 함수

MongoDB 6.0는 서버 측 JavaScript, $accumulator, $function 및 $where 표현식에 사용되는 내부 JavaScript 엔진을 MozJS-60에서 MozJS-91로 업그레이드합니다. MozJS-91에서는 MozJS-60에 존재했던 사용 중단된 비표준 배열과 문자열 함수가 제거되었습니다.

제거된 배열 및 문자열 함수의 전체 목록은 6.0 호환성 정보를 참조하십시오.

예시

players collection에 있는 다음 문서를 고려하세요.

db.players.insertMany([
   { _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"
}

또는 $expr과 $function을 사용하여 이전 예시를 다시 작성할 수 있습니다. JavaScript에서 집계 연산자 $function을 사용해 사용자 지정 집계 표현식을 정의할 수 있습니다. db.collection.find()에서 $function과 다른 집계 연산자에 액세스하려면 $expr를 함께 사용하세요.

db.players.find( {$expr: { $function: {
      body: function(name) { return hex_md5(name) == "9b53e667f30cd329dca1ec9e6a83e994"; },
      args: [ "$name" ],
      lang: "js"
} } } )

사용자 지정 표현식을 작성해야 하는 경우 $where보다 $function이 선호됩니다.

돌아가기

정규식

지리공간 쿼리