$function (표현식 연산자)

스키마 유효성 검사 제한

를 스키마 유효성 검사 쿼리 조건자의 일부로 $function 사용할 수 없습니다.

Javascript Enablement

를 사용하려면 서버 측 스크립팅을 활성화해야 합니다(기본값).$function

(또는, 또는)를 $function $accumulator$where mapReduce사용하지 않는 경우 서버 측 스크립팅을 비활성화합니다.

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

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

  이전 버전에서 MongoDB는 mongos 인스턴스에서 JavaScript 실행을 허용하지 않습니다.

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

의 대안 $where

쿼리 연산자 $where을(를) 사용하여 JavaScript 표현식을 지정할 수도 있습니다. 그러나

• $expr 연산자를 사용하면 쿼리 언어 내에서 집계 표현식을 사용할 수 있습니다.

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

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

• JavaScript 사용하지 않는 집계 연산자(즉, 비$function및 비$accumulator연산자)와 함께$expr를 사용하는 것은 JavaScript 실행하지 않기 때문에$where보다 빠르며 가능하면 선호되어야 합니다.

• 그러나 사용자 지정 표현식을 만들어야 하는 경우$function 보다 를 사용하는 $where 것이 좋습니다.

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

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

예시 1: 사용 예시

다음 문서를 사용하여 players라는 이름의 샘플 collection을 생성합니다.

db.players.insertMany([
   { _id: 1, name: "Miss Cheevous",  scores: [ 10, 5, 10 ] },
   { _id: 2, name: "Miss Ann Thrope", scores: [ 10, 10, 10 ] },
   { _id: 3, name: "Mrs. Eppie Delta ", scores: [ 9, 8, 8 ] }
])

다음 집계 연산은 $addFields를 사용하여 각 문서에 새 필드를 추가합니다.

• isFound 이 값은 이름의 MD 해시가 지정된 해시와 같은지 확인하는 사용자 지정 표현식 에 의해 값이 결정됩니다.$function 5

• message 템플릿을 사용하여 문자열 $function 메시지의 형식을 지정하는 사용자 지정 표현식 에 의해 값이 결정됩니다.

db.players.aggregate( [
   { $addFields:
      {
        isFound:
            { $function:
               {
                  body: function(name) {
                     return hex_md5(name) == "15b0a220baa16331e8d80e15367677ad"
                  },
                  args: [ "$name" ],
                  lang: "js"
               }
            },
         message:
            { $function:
               {
                  body: function(name, scores) {
                     let total = Array.sum(scores);
                     return `Hello ${name}.  Your total score is ${total}.`
                  },
                  args: [ "$name", "$scores"],
                  lang: "js"
               }
            }
       }
    }
] )

이 작업은 다음 문서를 반환합니다.

{ "_id" : 1, "name" : "Miss Cheevous", "scores" : [ 10, 5, 10 ], "isFound" : false, "message" : "Hello Miss Cheevous.  Your total score is 25." }
{ "_id" : 2, "name" : "Miss Ann Thrope", "scores" : [ 10, 10, 10 ], "isFound" : true, "message" : "Hello Miss Ann Thrope.  Your total score is 30." }
{ "_id" : 3, "name" : "Mrs. Eppie Delta ", "scores" : [ 9, 8, 8 ], "isFound" : false, "message" : "Hello Mrs. Eppie Delta .  Your total score is 25." }

예시 2, 다음과 같은 대안이 있습니다. $where

$where연산자 사용하는 쿼리 의 대안으로$expr및$function를 사용할 수 있습니다. 예시 들어 다음$where예시 살펴보겠습니다.

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

db.collection.find() 연산은 다음 문서를 반환합니다.

{ "_id" : 2, "name" : "Miss Ann Thrope", "scores" : [ 10, 10, 10 ] }

이 예시 와 를 $expr $function 사용하여 표현될 수 있습니다.

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