AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

$ 축적자 (축적자 연산자)

$accumulator

사용자 지정 누산기 연산자를 정의합니다. 축적자는 문서가 파이프라인을 통해 진행됨에 따라 상태를 유지하는 연산자입니다(예: 총계, 최대값, 최소값 및 관련 데이터). $accumulator 연산자로 자체 JavaScript 함수를 실행하여 MongoDB 쿼리 언어에서 지원하지 않는 동작을 구현합니다. $function도 참조하세요.

$accumulator 이 단계에서 사용할 수 있습니다:

중요

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

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

{ $accumulator: { init: <code>, initArgs: <array expression>, // Optional accumulate: <code>, accumulateArgs: <array expression>, merge: <code>, finalize: <code>, // Optional lang: <string> }}
필드
유형
설명

문자열 또는 코드

상태를 초기화하는 데 사용되는 함수입니다. init 함수는 initArgs 배열 표현식에서 인수를 받습니다. 함수 정의를 BSON type 코드 또는 문자열로 지정할 수 있습니다.

init 함수의 형식은 다음과 같습니다.

function (<initArg1>, <initArg2>, ...) { ... return <initialState>}

디스크로 유출하거나 샤딩된 클러스터에서 쿼리를 실행하면 축적자가 각각 init()을(를) 호출하여 시작하는 여러 하위 누적의 병합으로 계산될 수 있습니다. init(), accumulate() 및 merge() 함수가 이 실행 모델과 호환되는지 확인합니다.

배열

선택 사항. init 함수에 전달된 인수입니다.

initArgs 의 형식은 다음과 같습니다.

[ <initArg1>, <initArg2>, ... ]

중요: $bucketAuto 단계에서 사용되는 경우 initArgs는 그룹 키를 참조할 수 없습니다(즉, $<fieldName> 구문을 사용할 수 없음). 대신 $bucketAuto 단계에서는 initArgs에 상수 값만 지정할 수 있습니다.

문자열 또는 코드

문서를 누적하는 데 사용되는 함수입니다. accumulate 함수는 현재 상태 및 accumulateArgs 배열 표현식에서 인수를 받습니다. accumulate 함수의 결과가 새 상태가 됩니다. 함수 정의를 BSON type 코드 또는 문자열로 지정할 수 있습니다.

accumulate 함수의 형식은 다음과 같습니다.

function(state, <accumArg1>, <accumArg2>, ...) { ... return <newState>}

배열

accumulate 함수에 전달된 인수입니다. accumulateArgs을 사용하여 accumulate 함수에 전달할 필드 값을 지정할 수 있습니다.

accumulateArgs 의 형식은 다음과 같습니다.

[ <accumArg1>, <accumArg2>, ... ]

문자열 또는 코드

두 개의 내부 상태를 병합하는 데 사용되는 함수입니다. merge는 String 또는 Code BSON 유형이어야 합니다. merge는 병합된 두 상태의 합산 결과를 반환합니다. 병합 함수가 호출되는 시점에 관한 자세한 내용은 $merge로 두 상태 병합을 참조하세요.

merge 함수의 형식은 다음과 같습니다.

function (<state1>, <state2>) { <logic to merge state1 and state2> return <newState>}

문자열 또는 코드

선택 사항. 누적 결과를 업데이트하는 데 사용되는 함수입니다.

finalize 함수의 형식은 다음과 같습니다.

function (state) { ... return <finalState>}

문자열

$accumulator 코드에 사용되는 언어입니다.

중요: 현재 lang에 대해서는 js만 지원됩니다.

다음 단계에서는 $accumulator 연산자가 문서를 처리하는 방법을 간략하게 설명합니다.

  1. 연산자는 init 함수에 의해 정의된 초기 상태에서 시작됩니다.

  2. 각 문서에 대해 연산자는 accumulate 함수를 기반으로 상태를 업데이트합니다. accumulate 함수의 첫 번째 인수는 현재 상태이며 추가 인수는 accumulateArgs 배열에 지정됩니다.

  3. 연산자는 여러 중간 상태를 병합해야 하는 경우 병합 함수를 실행합니다. 병합 함수가 호출되는 경우에 대한 자세한 내용은 $merge으로 두 가지 상태 병합 항목을 참조하세요.

  4. finalize 함수가 정의되어 있는 경우 모든 문서가 처리되고 그에 따라 상태가 업데이트되면 finalize 함수가 상태를 최종 출력으로 변환합니다.

내부 연산의 일부로 $accumulator 연산자는 두 개의 개별적인 중간 상태를 병합해야 할 수 있습니다. merge 함수는 연산자가 두 상태를 병합하는 방법을 지정합니다.

병합 함수는 항상 한 번에 상태 2개를 병합합니다. 상태를 3개 이상 병합해야 하는 경우 상태 2개의 결과 병합은 단일 상태로 병합됩니다. 이 프로세스는 모든 상태가 병합될 때까지 반복됩니다.

예를 들어 $accumulator는 다음 시나리오에서 두 상태를 결합해야 할 수 있습니다.

  • $accumulator 샤딩된 클러스터에서 실행됩니다. 연산자는 최종 결과를 얻기 위해 각 샤드의 결과를 병합해야 합니다.

  • 단일 $accumulator 작업이 지정된 메모리 제한을 초과했습니다. allowDiskUse 옵션을 지정하면 연산자는 진행 중인 작업을 디스크에 저장하고 메모리에서 작업을 완료합니다. 연산이 완료되면 병합 기능을 사용하여 디스크와 메모리의 결과를 함께 병합합니다.

MongoDB가 init(), accumulate(), merge() 함수에 대해 문서를 처리하는 순서는 다를 수 있으며, $accumulator 함수에 해당 문서가 지정된 순서와 다를 수 있습니다.

예를 들어 _id 필드가 알파벳 문자인 일련의 문서를 생각해 보세요.

{ _id: 'a' },{ _id: 'b' },{ _id: 'c' }...{ _id: 'z' }

다음으로 _id 필드를 기준으로 문서를 정렬한 다음 $accumulator 함수를 사용하여 _id 필드 값을 연결하는 집계 파이프라인을 고려합니다.

[ { $sort: { _id: 1 } }, { $group: { _id: null, alphabet: { $accumulator: { init: function() { return "" }, accumulate: function(state, letter) { return(state + letter) }, accumulateArgs: [ "$_id" ], merge: function(state1, state2) { return(state1 + state2) }, lang: "js" } } } }]

MongoDB는 문서가 정렬된 순서로 처리되는 것을 보장하지 않으므로 alphabet 필드가 반드시 abc...z로 설정되는 것은 아닙니다.

이 동작으로 인해 $accumulator 함수가 특정 순서로 문서를 처리하고 반환할 필요가 없는지 확인합니다.

$accumulator를 사용하려면 서버측 스크립팅을 활성화해야 합니다.

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

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

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

이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.

참고

이 예시에서는 $accumulator 연산자를 사용해 MongoDB에서 이미 지원되고 있는 $avg 연산자를 구현하는 방법을 안내합니다. 이 예시의 목표는 새로운 기능을 구현하는 것이 아니라 $accumulator 연산자의 동작과 구문을 익숙한 논리로 설명하는 것입니다.

다음 작업은 rated별로 문서를 groups 작업하고 $accumulator를 사용하여 각 콘텐츠 등급에 대한 평균 imdb.rating을 계산합니다. $match 단계는 입력을 G, PG, PG-13, R 콘텐츠 등급으로 제한하고 imdb.rating이 빈 string과 같은 double이 아닌 문서를 제외합니다.

db.movies.aggregate( [ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.rating": { $type: "double" } } }, { $group: { _id: "$rated", avgRating: { $accumulator: { init: function() { // Set the initial state return { count: 0, sum: 0 } }, accumulate: function(state, rating) { // Define how to update the state return { count: state.count + 1, sum: state.sum + rating } }, accumulateArgs: [ "$imdb.rating" ], // Argument required by the accumulate function merge: function(state1, state2) { // When the operator performs a merge, return { // add the fields from the two states count: state1.count + state2.count, sum: state1.sum + state2.sum } }, finalize: function(state) { // After collecting the results from all documents, return (state.sum / state.count) // calculate the average }, lang: "js" } } } }, { $sort: { _id: 1 } }] )
[ { _id: 'G', avgRating: 6.628092243186578 }, { _id: 'PG', avgRating: 6.43525917926564 }, { _id: 'PG-13', avgRating: 6.404911676001717 }, { _id: 'R', avgRating: 6.456657633242984 }]

$accumulator는 count 및 sum이 모두 0으로 설정된 초기 상태를 정의합니다. $accumulator가 처리하는 각 문서에 대해 다음을 통해 상태를 업데이트합니다.

  • count를 1씩 증가

  • 문서의 imdb.rating 필드 값을 sum에 추가합니다. accumulate 함수는 accumulateArgs 필드에 전달되므로 imdb.rating 필드에 액세스할 수 있습니다.

문서가 처리될 때마다 accumulate 함수는 업데이트된 상태를 반환합니다.

모든 문서가 처리되면 finalize 함수는 평점의 sum을 문서의 count로 나누어 평균을 구합니다. 이렇게 하면 finalize 함수가 모든 문서의 누적 sum 및 count를 수신하므로 실행 중인 계산된 평균을 계속 유지할 필요가 없습니다.

이 작업은 $avg 연산자를 사용하는 다음 파이프라인과 동일합니다.

db.movies.aggregate( [ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.rating": { $type: "double" } } }, { $group: { _id: "$rated", avgRating: { $avg: "$imdb.rating" } } }, { $sort: { _id: 1 } }] )
[ { _id: 'G', avgRating: 6.6280922431865825 }, { _id: 'PG', avgRating: 6.435259179265659 }, { _id: 'PG-13', avgRating: 6.404911676001723 }, { _id: 'R', avgRating: 6.456657633242999 }]

initArgs 옵션을 사용하여 $accumulator의 초기 상태를 변경할 수 있습니다. 예를 들어 다음과 같은 경우에 유용합니다.

  • 사용자의 상태에 없는 필드 값을 사용하여 사용자의 상태에 영향을 미치거나

  • 처리 중인 그룹에 따라 초기 상태를 다른 값으로 설정합니다.

사용자가 이 데이터를 쿼리하여 영화를 찾을 수 있는 애플리케이션이 있다고 가정해 보겠습니다. 사용자가 선호하는 콘텐츠 등급에 대한 결과를 더 많이 표시하는 것이 유용할 수 있습니다. 이 예시에서 사용자가 선호하는 콘텐츠 등급은 PG-13이며, 이는 userProfileRated로 init 함수에 전달됩니다.

다음 집계 파이프라인은 rated별로 문서를 groups 작업합니다. 이 작업은 $accumulator를 사용하여 영화의 등급이 사용자 프로필의 등급과 일치하는지 여부에 따라 각 콘텐츠 등급에서 다른 수의 영화를 표시합니다.

참고

다른 선호 콘텐츠 등급으로 이 예시를 실행하려면 initArgs 배열의 "PG-13"을(를) "R"와(과) 같은 다른 값으로 바꿉니다.

db.movies.aggregate( [ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.rating": { $type: "double" } } }, { $sort: { "imdb.rating": -1, title: 1 } }, { $group: { _id: { rated: "$rated" }, movies: { $accumulator: { init: function(rated, userProfileRated) { // Set the initial state return { max: rated === userProfileRated ? 3 : 1, // If the group matches the user's rating, movies: [] // return 3 movies. Otherwise, return 1. } }, initArgs: [ "$rated", "PG-13" ], // Argument to pass to the init function accumulate: function(state, movieTitle) { // Define how to update the state if (state.movies.length < state.max) { state.movies.push(movieTitle); } return state; }, accumulateArgs: [ "$title" ], // Argument required by the accumulate function merge: function(state1, state2) { return { max: state1.max, movies: state1.movies.concat(state2.movies).slice(0, state1.max) } }, finalize: function(state) { // Adjust the state to only return the field we need return state.movies }, lang: "js" } } } }, { $sort: { "_id.rated": 1 } }] )
[ { _id: { rated: 'G' }, movies: [ 'Modern Times' ] }, { _id: { rated: 'PG' }, movies: [ 'Life' ] }, { _id: { rated: 'PG-13' }, movies: [ 'A Brave Heart: The Lizzie Velasquez Story', 'The Dark Knight', 'The Lord of the Rings: The Return of the King' ] }, { _id: { rated: 'R' }, movies: [ 'The Shawshank Redemption' ] }]

init 함수는 max 및 movies 필드가 포함된 초기 상태를 정의합니다. max 필드는 해당 그룹의 최대 레스토랑 수를 설정합니다. 문서의 rated 필드가 userProfileRated와 일치하는 경우 해당 그룹에는 최대 3 개의 레스토랑이 포함됩니다. 그렇지 않고 문서 rated가 userProfileRated와 일치하지 않으면 그룹에는 최대 1개의 레스토랑이 포함됩니다. init 함수는 rated와 userProfileRated 인수 모두를 initArgs 배열에서 받습니다.

$accumulator가 처리하는 각 문서에 대해 영화의 title을 movies 배열로 푸시합니다. 단 해당 제목의 길이가 movies 길이의 max 값을 넘지 않아야 합니다. 문서가 처리될 때마다 accumulate 함수는 업데이트된 상태를 반환합니다.

병합 함수는 두 상태를 병합하는 방법을 정의합니다. 이 함수는 movies 각 상태 의 배열을 함께 연결하고, 결과 배열 의 길이는 slice() 메서드를 사용하여 제한되어 max 값을 초과하지 않도록 합니다.

모든 문서가 처리되면 finalize 함수는 영화 제목만 반환하도록 결과 상태를 수정합니다. 이 기능이 없으면 max 필드도 출력에 포함되어 해당 애플리케이션에 대한 요구 사항을 충족하지 못합니다.

이 페이지 평가하기

이 페이지의 내용