Docs Menu
Docs Home
/
MongoDB Compass

집계 파이프라인 만들기

이 페이지의 내용

  • 이 작업에 대하여
  • 시작하기 전에
  • 단계
  • 자세히 알아보기

MongoDB Compass에서 집계 파이프라인 빌더를 사용하면 컬렉션 또는 뷰에서 문서를 처리하고 계산된 결과를 반환하는 집계 파이프라인을 생성할 수 있습니다.

MongoDB Compass는 집계 파이프라인을 생성하기 위한 다양한 모드를 제공합니다.

  • 단계 뷰 모드는 선택한 단계에 따라 파이프라인 구문을 미리 로드하는 시각적 파이프라인 편집기입니다.

  • 단계 뷰 모드의 기능인 단계 마법사는 간단한 집계 단계 사용 사례를 위한 템플릿 세트를 제공합니다. 단계 마법사에는 집계 파이프라인을 시작하는 데 도움이 되는 간단한 사용 사례만 포함되어 있습니다.

  • 단계 뷰 모드의 기능인 포커스 모드로 한 번에 하나의 파이프라인 단계를 편집할 수 있습니다. 포커스 모드는 복잡하거나 깊게 중첩된 집계 파이프라인 단계를 관리하는 데 도움이 됩니다.

  • 텍스트 뷰 모드는 원시 파이프라인 구문을 허용하는 텍스트 기반 파이프라인 편집기입니다.

집계 파이프라인을 빌드하려면 컬렉션을 선택하고 Aggregations 탭을 클릭합니다. Compass에 집계 파이프라인이 표시됩니다. Preview of Documents in the Collection 섹션에는 선택한 컬렉션에서 무작위로 샘플링된 10개의 문서가 표시됩니다.

참고

Atlas Search 단계

Atlas에서 호스팅되는 MongoDB 배포에 Compass를 연결하면 집계 파이프라인 빌더에서 추가 Atlas 전용 단계 $search$searchMeta 를 사용할 수 있습니다. 이 단계를 사용하여 Atlas 컬렉션에서 전체 텍스트 검색을 수행합니다.

집계 파이프라인을 생성하는 방법을 보려면 선택한 뷰 모드에 해당하는 탭을 선택합니다.

1

집계 파이프라인 창에서 {} Stages 토글 스위치가 선택되어 있는지 확인합니다.

단계 보기 모드를 켜기
클릭하여 확대
2

집계 파이프라인 창 아래쪽에서 + Add Stage 버튼을 클릭합니다.

3

집계 단계 카드의 왼쪽 상단 모서리에서 Select 드롭다운 메뉴를 클릭하고 파이프라인의 첫 번째 단계에 사용할 집계 파이프라인 단계를 선택합니다.

4

선택한 단계를 입력합니다. 파이프라인 단계의 테두리를 오른쪽으로 드래그하여 너비를 조정할 수 있습니다.

참고

각 파이프라인 단계 이름 오른쪽에 있는 토글은 해당 단계가 파이프라인에 포함되어 있는지 여부를 나타냅니다. 파이프라인 단계를 전환하면 해당 단계의 포함 여부에 따라 업데이트되는 파이프라인 미리 보기도 업데이트됩니다.

예를 들어, 다음 파이프라인에서는 첫 번째 $match 단계는 제외되고 $project 단계만 포함됩니다.

집계 빌더 제외 단계 예시
5

마지막 집계 단계 이후에 파이프라인 단계를 추가하려면 Add Stage을(를) 클릭합니다. 가장 최근에 추가된 단계 앞에 집계 단계를 추가하려면 단계 카드 위의 + 아이콘을 클릭합니다.

각 추가 단계에 대해 3단계와 4단계를 반복합니다.

참고

각 단계 카드의 헤더를 드래그하여 파이프라인 단계의 순서를 변경할 수 있습니다.

6

파이프라인 빌더의 오른쪽 상단에서 Run을(를) 클릭합니다. Compass는 문서 뷰에서 결과를 반환합니다.

경고

1

집계 파이프라인 창에서 {} Stages 토글 스위치가 선택되어 있는지 확인합니다.

단계 보기 모드를 켜기
클릭하여 확대
2

보기 모드 토글 오른쪽에 있는 막대 아이콘을 클릭하여 Stage Wizard 카드를 엽니다.

보기 모드 토글 오른쪽에 있는 아이콘을 클릭합니다.
클릭하여 확대
3

Stage Wizard 카드에서 사용 사례 또는 애그리게이션 단계와 관련된 키워드를 검색하여 사용 사례를 필터링할 수 있습니다.

4

Stage Wizard 카드에서 파이프라인의 첫 번째 단계에 대한 단계 사용 사례를 선택합니다. 단계 카드를 클릭하여 파이프라인 끝에 추가하거나 원하는 위치로 드래그할 수 있습니다.

사용 사례를 선택하면 Compass는 선택한 집계 파이프라인 단계에 해당하는 양식으로 단계 카드를 채웁니다.

단계 마법사 사용 사례에는 다음과 같은 애그리게이션 단계가 포함됩니다.

5

선택한 단계의 양식을 작성하고 Apply 을(를) 클릭합니다. Apply 을 클릭하면 양식이 스테이지 뷰 모드, 포커스 모드 또는 텍스트 뷰 모드에서 편집할 수 있는 스테이지 카드로 바뀝니다.

Compass는 최대 10개의 샘플 출력 문서로 단계 출력을 채웁니다.

참고

단계 마법사를 통해 기존 단계를 편집할 수 없습니다. 단계 마법사는 새 단계만 추가할 수 있습니다. 기존 단계를 편집하려면 단계 뷰 모드, 포커스 모드 또는 텍스트 뷰 모드를 사용합니다.

6

파이프라인에 애그리게이션 단계를 더 추가하려면 추가된 각 단계에 대해 3단계와 4단계를 반복합니다.

각 단계 카드의 헤더를 드래그하여 파이프라인 단계의 순서를 변경할 수 있습니다.

7

파이프라인 빌더의 오른쪽 상단에서 Run을(를) 클릭합니다. Compass는 문서 뷰에서 결과를 반환합니다.

1

집계 파이프라인 창에서 {} Stages 토글 스위치가 선택되어 있는지 확인합니다.

단계 보기 모드를 켜기
클릭하여 확대
2

집계 단계를 아직 생성하지 않은 경우 집계 파이프라인 창 하단에 있는 + Add Stage 버튼을 클릭합니다.

3

스테이지 카드의 오른쪽 상단에서 초점 모드 아이콘을 클릭합니다.

초점 모드 버튼을 선택합니다.
4

Select 드롭다운 메뉴를 클릭하고 파이프라인의 첫 번째 단계에 사용할 집계 파이프라인 단계를 선택합니다.

5

선택한 단계를 입력합니다. Compass가 Stage Output의 샘플 문서를 최대 10개까지 채웁니다.

Stage Input, 스테이지 편집기 및 Stage Output 의 테두리를 원하는 크기로 드래그하여 너비를 조정할 수 있습니다.

참고

각 파이프라인 단계 이름 오른쪽에 있는 토글은 해당 단계가 파이프라인에 포함되어 있는지 여부를 나타냅니다. 파이프라인 단계를 전환하면 해당 단계의 포함 여부에 따라 업데이트되는 파이프라인 미리 보기도 업데이트됩니다.

6

마지막 애그리게이션 단계 전후에 애그리게이션 단계를 추가하려면 Add Stage 드롭다운을 클릭하세요. 각 추가 단계에 대해 4단계와 5단계를 반복합니다.

다음 키보드 단축키를 사용하여 단계를 추가할 수 있습니다.

  • 현재 단계 뒤에 단계를 추가하려면 다음을 수행합니다.

    • Windows/Linux: Ctrl + Shift + A

    • Mac: ⌘ + Shift + A

  • 현재 단계 앞에 단계를 추가하려면 다음을 수행합니다.

    • Windows/Linux: Ctrl + Shift + B

    • Mac: ⌘ + Shift + B

7

다른 단계 사이를 탐색하려면 포커스 모드 모달의 왼쪽 상단에 있는 Stage 드롭다운에서 편집하려는 단계를 선택합니다.

다음 키보드 단축키를 사용하여 단계 간에 이동할 수 있습니다.

  • 현재 단계 이전 단계로 Go 다음을 수행합니다.

    • Windows/Linux: Ctrl + Shift + 9

    • Mac: ⌘ + Shift + 9

  • 현재 단계 앞에 단계를 추가하려면 다음을 수행합니다.

    • Windows/Linux: Ctrl + Shift + 0

    • Mac: ⌘ + Shift + 0

8

x 를 클릭하여 포커스 모드를 종료하고 파이프라인 빌더의 오른쪽 상단에 있는 Run 를 선택합니다. Compass는 문서 뷰에 결과를 반환합니다.

1

집계 파이프라인 창에서 </> Text 토글 스위치를 클릭하여 파이프라인 편집을 위한 텍스트 모드를 활성화합니다.

텍스트 모드 토글
클릭하여 확대
2

텍스트 편집기에 유효한 애그리게이션 구문을 입력합니다. 텍스트 편집기는 올바른 구문 및 디버깅 정보를 위해 실시간 Linting을 제공합니다.

텍스트 뷰 모드를 사용하면 파이프라인을 텍스트 편집기에 입력하거나 붙여넣어 일반 텍스트에서 집계 파이프라인을 가져올 수도 있습니다.

예를 들어 다음 파이프라인은 쿼리 결과를 4 개 문서로 제한합니다.

[ { "$limit" : 4 } ]

참고

미리보기 결과에 포함된 모든 필드와 문서를 확장하려면 Output Options 을 클릭하고 Expand all fields 를 선택합니다.

파이프라인 출력 미리보기
3

파이프라인 빌더의 오른쪽 상단에 있는 Run 을(를) 클릭합니다. Compass는 문서 뷰에 결과를 반환합니다.

  • 집계 파이프라인

  • 집계 파이프라인 단계

  • 집계 파이프라인 빌더 설정

  • 특정 언어로 파이프라인 내보내기

돌아가기

임베디드 MongoDB Shell