Docs Menu

집계 파이프라인 만들기

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

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

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

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

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

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

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

참고

Atlas Search 단계

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

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

1

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

클릭하여 확대
2

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

3

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

4

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

참고

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

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

5

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

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

참고

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

6

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

경고

$merge$out 같은 일부 집계 연산자는 컬렉션의 데이터를 수정할 수 있습니다.

집계 파이프라인에 컬렉션의 데이터를 수정할 수 있는 연산자가 포함되어 있는 경우 파이프라인이 실행되기 전에 확인 메시지가 표시됩니다.

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는 문서 뷰에 결과를 반환합니다.