문서 메뉴
문서 홈
/
MongoDB 아틀라스
/

애그리게이션 파이프라인 실행

이 페이지의 내용

  • 필수 역할
  • 애그리게이션 파이프라인 빌더에 액세스하기
  • 애그리게이션 파이프라인 만들기
  • 애그리게이션 파이프라인을 드라이버 언어로 내보내기
  • 애그리게이션 파이프라인 설정 구성

Atlas UI를 사용하여 집계 파이프라인 을 빌드하여 데이터를 처리할 수 있습니다. 집계 파이프라인은 선택한 파이프라인 단계를 기반으로 문서를 집계된 결과로 변환합니다.

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

Atlas UI에서 집계 파이프라인을 만들고 실행하려면 Project Data Access Read Only 역할 이상이 있어야 합니다.

파이프라인에서 $out 단계를 활용하려면 Project Data Access Read/Write 역할이 있어야 합니다.

1

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

Atlas UI에서 데이터베이스를 강조 표시한 스크린샷입니다.
클릭하여 확대
2

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

3

Aggregation 보기를 처음 열면 Atlas에 빈 애그리게이션 파이프라인이 표시됩니다.

애그리게이션 파이프라인 빌더의 초기 화면.
클릭하여 확대
1

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

파이프라인 단계 선택을 보여주는 스크린샷입니다.
클릭하여 확대

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

2

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

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

쓰기 단계(예: $out 또는 $merge)를 포함하지 않는 집계 파이프라인은 기본적으로 출력을 10개 문서로 제한하는 $limit 단계로 자동 포스트픽스됩니다. 집계 파이프라인 설정에서 Number of Preview Documents의 값 필드를 업데이트하여 $limit 단계를 통해 허용되는 문서 수를 변경할 수 있습니다.

파이프라인 단계 결과를 보여주는 스크린샷입니다.
클릭하여 확대
3

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

  • 파이프라인 끝에 새 단계를 추가하려면 파이프라인 하단에 있는 Add Stage 버튼을 클릭하세요.

  • 단계에서 버튼을 클릭하면 해당 단계 바로 뒤에 새 단계를 추가할 수 있습니다.

단계 추가 버튼이 강조 표시된 스크린샷.

파이프라인 단계를 삭제하려면 원하는 단계에서 Delete 를 클릭합니다.

4

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

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

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

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

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

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

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

1
  1. 파이프라인 빌더 상단의 더하기 아이콘 옆에 있는 화살표를 클릭합니다.

  2. New Pipeline from Text를 클릭합니다.

    텍스트에서 새 파이프라인 대화 상자를 여는 스크린샷입니다.
    클릭하여 확대
2

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

3
4

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

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

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

1

집계 파이프라인 생성에 대한 지침은 집계 파이프라인 생성을 참조하세요.

2
3

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

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

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

4

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

5

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

6

Atlas UI에서 애그리게이션 파이프라인 설정을 구성할 수 있습니다.

Atlas는 다음 단계의 미리 보기에 입력할 수 있는 문서 수를 100,000개로 제한합니다.

이 제한을 사용하면 미리보기가 더 빠르게 실행됩니다. Atlas는 파이프라인이 실행될 때 제한을 적용하지 않습니다.

Atlas UI에서는 입력 문서 미리 보기의 제한을 변경할 수 없습니다. Compass를 사용하여 입력 문서의 제한을 변경하려면 집계 파이프라인 빌더 설정을 참조하세요.

애그리게이션 파이프라인 빌더 설정을 수정하려면 다음을 수행해야 합니다.

1
파이프라인 설정 버튼이 강조 표시한 스크린샷입니다.
2

Atlas UI에서 다음 설정을 수정할 수 있습니다.

설정
설명
기본값
Comment Mode

활성화되면 Atlas에서 각 단계에 도우미 댓글을 추가합니다.

참고

이 설정을 변경하면 새 단계에만 영향을 미치며, 파이프라인에 이미 추가된 단계에는 영향을 주지 않습니다.

Number of Preview Documents

각 단계의 미리 보기에 표시할 문서 수입니다.

참고

각 단계마다 최대 20개의 문서만 미리 볼 수 있습니다.

10
3

돌아가기

색인

다음

페더레이션 데이터 쿼리