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

집계 파이프라인

집계 파이프라인 문서를 프로세스 하나 이상의 단계로 구성됩니다. 이러한 문서는 컬렉션, view 또는 특별히 설계된 단계에서 가져올 수 있습니다.

각 단계는 입력 문서에 대한 작업을 수행합니다. 예시를 들어 단계는 $filter 문서를 작성하고, $group 문서를 작성하고, 값을 계산할 수 있습니다. 단계에서 출력되는 문서는 파이프라인 의 다음 단계로 전달됩니다.

집계 파이프라인 문서 그룹에 대한 결과를 반환할 수 있습니다. 집계 파이프라인 으로 업데이트에 표시된 단계를 사용하여 집계 파이프라인으로 문서를 업데이트 할 수도 있습니다.

참고

db.collection.aggregate() 메서드로 실행되는 집계 파이프라인은 파이프라인에 $merge 또는 $out 단계가 포함되지 않는 한 컬렉션의 문서를 수정하지 않습니다.

MongoDB Atlas에서 호스팅되는 배포에 대해 UI에서 집계 파이프라인을 실행할 수 있습니다.

MongoDB Atlas UI에서 MongoDB Atlas에 집계 파이프라인을 실행하는 경우 각 단계에서 결과를 미리 볼 수 있습니다.

완전한 집계 파이프라인 튜토리얼 섹션에는 MongoDB Shell 및 각 공식 MongoDB 드라이버에 대핕 예제가 포함된 일반적인 집계 작업에 대한 단계별 튜토리얼이 포함되어 있습니다.

집계 파이프라인을 실행하려면 다음을 사용하세요.

집계 파이프라인은 문서를 처리하는 하나 이상의 단계로 구성됩니다.

  • 한 단계가 모든 입력 문서에 대해 하나의 문서를 출력할 필요는 없습니다. 일부 단계에서는 새 문서를 생성하거나 문서를 필터링할 수 있습니다.

  • 이러한 단계 예외를 제외하고 동일한 단계가 파이프라인에 여러 번 나타날 수 있습니다. $out, $merge$geoNear.

모든 집계 단계에 대해 집계 단계를 참조하세요

집계 파이프라인에서 표현식은 스테이지 파이프라인 의 각 입력 문서 처리하는 방법을 정의합니다. 예시 들어 표현식을 사용하여 포함할 문서, 필드 형태를 변경하는 방법 또는 새 값을 계산하는 방법을 정의할 수 있습니다.

일부 집계 파이프라인 단계에서는 표현식을 허용합니다. 연산자는 입력 표현식을 기반으로 값을 계산합니다.

MongoDB 쿼리 언어에서는 다음 구성 요소에서 표현식을 빌드할 수 있습니다.

구성 요소
예시

상수

3

연산자

필드 경로 표현식

"$<path.to.field>"

예시 를 들어 { $add: [ 3, "$inventory.total" ] }$add 연산자 와 두 개의 피연산자로 구성된 표현식 입니다.

표현식은 입력 문서의 경로 inventory.total에 있는 값에 3을 더한 결과를 반환합니다.

참고

$map, $ 필터하다, $reduce에서 배열 요소 인덱스에 액세스하기

MongoDB 8.3 은 $map, $filter$reduce 집계 표현식에서 배열 요소 인덱스에 대한 액세스 개선합니다. 새 arrayIndexAs 필드 사용하여 배열 요소의 인덱스 를 저장 변수를 설정하다 수 있습니다. arrayIndexAs를 생략한 경우 새로운 $$IDX 집계 시스템 변수를 사용하여 현재 배열 요소의 인덱스에 액세스 할 수도 있습니다.

필드 경로 표현식은 입력 문서의 필드에 액세스하는 데 사용됩니다. 필드 이름 앞에 달러 기호 $를 추가합니다. 예를 들어 "$user"user 필드를 참조하고 "$user.name" 는 내장된 user.name 필드를 참조합니다.

자세한 예시는 필드 경로를 참조하세요.

집계 파이프라인을 사용하여 문서를 업데이트하려면 다음을 사용하세요.

값 유형 및 결과 크기에 대한 제한은 집계 파이프라인 제한을 참조하세요.

집계 파이프라인은 샤딩된 컬렉션의 작업을 지원합니다. 집계 파이프라인 및 샤딩된 컬렉션을 참조하세요.

중요

맵 리듀스의 대안으로서의 집계 파이프라인

MongoDB 5.0 부터 리듀스 는 더 이상 사용되지 않습니다.

맵 리듀스 대안으로서의 집계 파이프라인 예시는 다음을 참조하세요.

집계 파이프라인에 대해 자세히 알아보려면 다음을 참조하세요.