집계 파이프라인 빌더

이 페이지의 내용

필수 역할

애그리게이션 파이프라인 빌더에 액세스하기
애그리게이션 파이프라인 만들기
애그리게이션 파이프라인을 드라이버 언어로 내보내기
집계 파이프라인 설정

Data Explorer 은(는) 데이터를 처리하기 위한 집계 파이프라인 빌더를 제공합니다. 집계 파이프라인은 선택한 파이프라인 단계를 기반으로 문서를 집계된 결과로 변환합니다.

MongoDB Atlas 집계 파이프라인 빌더는 파이프라인을 실행하는 것이 아니라 파이프라인을 빌드하도록 설계되었습니다. 파이프라인 빌더는 드라이버 에서 실행할 파이프라인을 쉽게 내보낼 수 있는 방법을 제공합니다.

Ops Manager UI에서 데이터와 상호 작용하려면 다음을 수행합니다.

왼쪽 탐색에서 Deployment을 클릭합니다.
원하는 MongoDB deployment를 선택합니다.
0}Data 탭을 선택합니다.

필수 역할

Data Explorer 에서 집계 파이프라인을 생성하고 실행하려면 최소한 Project Data Access Read Only 역할을 부여받아야 합니다.

파이프라인에서 $out 단계를 활용하려면 최소한 Project Data Access Read/Write 역할을 부여받아야 합니다.

애그리게이션 파이프라인 빌더에 액세스하기

컬렉션의 데이터베이스를 선택합니다.

왼쪽의 기본 패널과 왼쪽 측면의 Namespaces 에는 데이터베이스의 컬렉션이 나열됩니다.

왼쪽 또는 메인 패널에서 컬렉션을 선택합니다.

기본 패널에는 Find, Indexes 및 Aggregation 보기가 표시됩니다.

Aggregation 보기를 선택합니다.

Aggregation 보기를 처음 열면 Data Explorer 이(가) 빈 집계 파이프라인을 표시합니다.

클릭하여 확대

애그리게이션 파이프라인 만들기

애그리게이션 단계를 선택합니다.

왼쪽 하단 패널의 Select 드롭다운에서 애그리게이션 단계를 선택합니다.

클릭하여 확대

드롭다운 오른쪽에 있는 토글은 단계 활성화 여부를 나타냅니다.

애그리게이션 단계를 입력합니다.

단계를 적절한 값으로 채웁니다. 댓글 모드 가 활성화된 경우 파이프라인 빌더는 선택한 단계에 대한 구문 지침을 제공합니다.

단계를 수정하면 Data Explorer 가 현재 단계의 결과를 기반으로 오른쪽에 있는 미리보기 문서를 업데이트합니다.

클릭하여 확대

원하는 대로 파이프라인에 단계를 추가할 수 있습니다.

파이프라인에 단계를 추가하는 방법에는 두 가지가 있습니다:

파이프라인 끝에 새 단계를 추가하려면 파이프라인 하단에 있는 Add Stage 버튼을 클릭하세요.
단계에서 버튼을 클릭하면 해당 단계 바로 뒤에 새 단계를 추가할 수 있습니다.

파이프라인 단계를 삭제하려면 다음을 클릭합니다. 아이콘을 클릭합니다.

추가 단계마다 1단계와 2단계를 반복합니다.

데이터 정렬

데이터 정렬 을 사용하여 문자열 비교를 위한 언어별 규칙(예: 대소문자 및 악센트 표시 규칙)을 지정할 수 있습니다.

데이터 정렬 문서를 지정하려면 파이프라인 빌더 상단에서 Collation 을 클릭합니다.

데이터 정렬 문서에는 다음과 같은 필드가 있습니다.

{
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

locale 필드는 필수입니다. 다른 모든 데이터 정렬 필드는 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

텍스트에서 애그리게이션 파이프라인 가져오기

애그리게이션 파이프라인을 일반 텍스트에서 파이프라인 빌더를 사용하여 파이프라인을 쉽게 수정하고 확인할 수 있습니다.

일반 텍스트에서 파이프라인을 가져오기 위해선 다음을 수행해야 합니다:

New Pipeline from Text 대화 상자를 엽니다.

파이프라인 빌더 상단의 더하기 아이콘 옆에 있는 화살표를 클릭합니다.
New Pipeline from Text를 클릭합니다.
클릭하여 확대

대화 상자에 파이프라인을 입력하거나 붙여넣습니다.

파이프라인은 db.collection.aggregate() 메서드의 pipeline 매개변수 구문과 일치해야 합니다.

Create New 을(를) 클릭합니다.

이어지는 대화 상자에서 Confirm 를 클릭합니다.

파이프라인 초기화

파이프라인을 초기의 빈 상태로 되돌리려면 파이프라인 빌더 맨 위에 있는 더하기 아이콘을 클릭합니다.

애그리게이션 파이프라인을 드라이버 언어로 내보내기

집계 파이프라인 빌더를 사용하여 완성된 파이프라인을 지원되는 드라이버 언어 중 하나로 내보낼 수 있습니다. Java, Node, C# 및 Python 3. 이 기능을 사용하여 애플리케이션에서 사용할 수 있도록 파이프라인을 포맷하고 내보낼 수 있습니다.

애그리게이션 파이프라인을 내보내려면 다음 단계를 따르세요.

aggregation pipeline을 구축합니다.

집계 파이프라인을 만드는 방법에 대한 지침은 집계 파이프라인 만들기를 참조하세요.

파이프라인 빌더 상단에서 Export to Language 을(를) 클릭합니다.

원하는 내보내기 언어를 선택합니다.

Export Pipeline To 드롭다운에서 원하는 언어를 선택합니다.

왼쪽의 My Pipeline 창에는 파이프라인이 mongosh 구문으로 표시됩니다.

파이프라인이 오른쪽 창에 선택된 언어로 표시됩니다.

원하는 경우 스테이트먼트 가져오기를 포함합니다.

(선택 사항): 택한 언어에 필요한 가져오기(import) 명령문을 포함하려면 Include Import Statements 옵션을 선택하세요.

Copy 버튼을 클릭합니다.

파이프라인 오른쪽 상단에 있는 Copy 버튼을 클릭하여 선택한 언어의 파이프라인을 클립보드에 복사합니다. 이제 파이프라인을 애플리케이션에 통합할 수 있습니다.