문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
집계 작업
/
집계 참조
/
애그리게이션 연산자

함수 (집계)

이 페이지의 내용

  • 정의
  • 구문
  • 고려 사항
  • 예제

정의

$function

JavaScript에서 사용자 지정 집계 함수 또는 표현식을 정의합니다.

$function 연산자를 사용하여 MongoDB 쿼리 언어에서 지원하지 않는 동작을 구현하는 사용자 지정 함수를 정의할 수 있습니다. $accumulator 도 참조하세요.

중요

애그리게이션 표현식 내에서 JavaScript를 실행하면 성능이 저하될 수 있습니다. 제공된 $function 파이프라인 연산자 가 애플리케이션의 요구 사항을 충족할 수 없는 경우에만 연산자를 사용합니다.

구문

$function 연산자의 구문은 다음과 같습니다.

{
  $function: {
    body: <code>,
    args: <array expression>,
    lang: "js"
  }
}
필드
유형
설명
body
문자열 또는 코드

함수 정의. 함수 정의를 BSON type 코드 또는 문자열로 지정할 수 있습니다. lang도 함께 참조하세요.

function(arg1, arg2, ...) { ... }

또는

"function(arg1, arg2, ...) { ... }"

args
배열

함수 본문 에 전달된 인수입니다. body 함수가 인수를 받지 않는 경우 빈 배열 [ ] 를 지정할 수 있습니다.

배열 요소는 코드를 포함한 모든 BSON types일 수 있습니다. 예시 2: $where 의 대안을 참조하세요.

lang
문자열

본문 에 사용되는 언어입니다. 반드시 lang: "js" 을(를) 지정해야 합니다.

고려 사항

스키마 유효성 검사 제한

$function 스키마 유효성 검사 쿼리 표현식의 일부로 사용할 수 없습니다.

Javascript 활성화

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

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

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

의 대안 $where

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

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

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

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

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

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

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

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

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

예제

예시 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 이 값의 값은 이름의 MD5 해시가 지정된 해시와 같은지 확인하는 사용자 지정 $function 표현식에 의해 결정됩니다.

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

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

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

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

$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"
} } } )
← $floor (애그리게이션)
getField(집계) →

이 페이지의 내용