애그리게이션을 통한 데이터 변환
이 페이지의 내용
개요
이 가이드 에서는 스칼라 운전자 사용하여 집계 게이션 작업을 수행하는 방법을 학습 수 있습니다.
애그리게이션 작업은 MongoDB 컬렉션의 데이터를 처리하고 계산된 결과를 반환합니다. Query API의 일부인 MongoDB 애그리게이션 프레임워크는 데이터 처리 파이프라인 개념을 모델로 합니다. 문서는 하나 이상의 단계를 포함하는 파이프라인에 들어가고, 이 파이프라인은 문서를 애그리게이션된 결과로 변환합니다.
집계 작업은 자동차 공장과 유사합니다. 자동차 공장에는 조립 라인이 있으며, 여기에는 드릴과 용접기 등 특정 작업을 수행할 수 있는 특수 공구를 갖춘 조립 스테이션이 있습니다. 원부품이 공장에 들어오면 조립 라인에서 이를 변형하고 조립하여 완제품으로 만듭니다.
집계 파이프라인은 조립 라인이고, 집계 단계는 조립 스테이션이며, 작업 연산자는 특수 도구입니다.
집계 및 찾기 연산 비교
다음 표에는 찾기 작업으로 수행할 수 있는 다양한 작업과 집계 작업으로 수행할 수 있는 작업이 나와 있습니다. 집계 프레임워크 데이터를 변환하고 조작할 수 있는 확장된 기능을 제공합니다.
작업 찾기 | 집계 작업 |
---|---|
Select certain documents to return Select which fields to return Sort the results Limit the results Count the results | Select certain documents to return Select which fields to return Sort the results Limit the results Count the results Rename fields Compute new fields Summarize data Connect and merge data sets |
제한 사항
집계 작업을 수행할 때 다음 제한 사항을 고려합니다.
반환된 문서는 BSON 문서 크기 제한 인 16 메가바이트를 위반할 수 없습니다.
파이프라인 단계의 메모리 제한은 기본값 으로 100 메가바이트입니다.
true
값을allowDiskUse()
메서드에 전달하고 메서드를aggregate()
에 연결하여 이 제한을 초과할 수 있습니다.$graphLookup 연산자 메가바이트의 엄격한 메모리 제한이 있으며 메서드에 100 전달된 값을
allowDiskUse()
무시합니다.
애그리게이션 작업 실행
참고
샘플 데이터
이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants
데이터베이스 에 있는 restaurants
컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.
집계 수행하려면 파이프라인 단계가 포함된 목록을 aggregate()
메서드에 전달합니다. 스칼라 운전자 파이프라인 단계를 빌드하기 위한 헬퍼 메서드를 포함하는 Aggregates
클래스를 제공합니다.
파이프라인 단계와 해당 Aggregates
도우미 메서드에 대해 자세히 학습 다음 리소스를 참조하세요.
문서 필터링, 그룹화 및 개수
이 코드 예시 뉴욕의 각 자치구에 있는 베이커리 수의 개수를 생성합니다. 이를 위해 aggregate()
메서드를 호출하고 집계 파이프라인 단계 목록으로 전달합니다. 이 코드는 다음 Aggregates
헬퍼 메서드를 사용하여 이러한 단계를 빌드합니다.
filter()
: $match 단계를 빌드하여 값이 인 문서를 필터하다 .cuisine
"Bakery"
group()
:$ 그룹 단계를 빌드하여 일치하는 문서를 필드borough
별로 그룹 각 고유 값에 대한 문서 수를 누적합니다.
val pipeline = Seq(Aggregates.filter(Filters.equal("cuisine", "Bakery")), Aggregates.group("$borough", Accumulators.sum("count", 1)) ) collection.aggregate(pipeline) .subscribe((doc: Document) => println(doc.toJson()), (e: Throwable) => println(s"There was an error: $e"))
{"_id": "Brooklyn", "count": 173} {"_id": "Queens", "count": 204} {"_id": "Bronx", "count": 71} {"_id": "Staten Island", "count": 20} {"_id": "Missing", "count": 2} {"_id": "Manhattan", "count": 221}
애그리게이션 설명
MongoDB 작업을 실행하는 방법에 대한 정보를 보려면 MongoDB 쿼리 플래너에게 설명을 지시하면 됩니다. MongoDB 작업을 설명할 때 실행 계획과 성능 통계를 반환합니다. 실행 계획은 MongoDB 작업을 완료할 수 있는 잠재적인 방법입니다. MongoDB 작업을 설명하도록 지시하면 기본값 으로 MongoDB 실행한 계획과 거부된 실행 계획을 모두 반환합니다.
집계 작업을 explain()
aggregate()
설명하려면 메서드를 메서드에 연결합니다. 메서드가 explain()
반환하는 정보의 유형과 양을 수정하는 에 상세도 수준을 전달할 수 있습니다. 상세도에 대한 자세한 내용은 MongoDB Server 매뉴얼의 상세도 모드를 참조하세요.
다음 예시 앞의 필터, 그룹 및 문서 계산 예시 의 집계 작업을 설명하도록 MongoDB 에 지시합니다. 이 코드는 의 상세도 값을 ExplainVerbosity.EXECUTION_STATS
explain()
메서드에 전달하며, 이 메서드는 성공적인 계획의 실행을 설명하는 통계를 반환하도록 메서드를 구성합니다.
val pipelineToExplain = Seq(Aggregates.filter(Filters.equal("cuisine", "Bakery")), Aggregates.group("$borough", Accumulators.sum("count", 1)) ) collection.aggregate(pipelineToExplain) .explain(ExplainVerbosity.EXECUTION_STATS) .subscribe((doc: Document) => println(doc.toJson()), (e: Throwable) => println(s"There was an error: $e"))
{"explainVersion": "2", "queryPlanner": {"namespace": "sample_restaurants.restaurants", "indexFilterSet": false, "parsedQuery": {"cuisine": {"$eq": "Bakery"}}, "queryHash": "865F14C3", "planCacheKey": "0FC225DA", "optimizedPipeline": true, "maxIndexedOrSolutionsReached": false, "maxIndexedAndSolutionsReached": false, "maxScansToExplodeReached": false, "winningPlan": {"queryPlan": {"stage": "GROUP", "planNodeId": 3, "inputStage": {"stage": "COLLSCAN", "planNodeId": 1, "filter": {"cuisine": {"$eq": "Bakery"}}, "direction": "forward"}}, ...}
Atlas Full Text Search 실행
팁
MongoDB Atlas v4.2 이상에서만 사용 가능
이 집계 파이프라인 연산자4.2 Atlas Search 인덱스 가적용되는 v 이상을 실행 MongoDB Atlas 클러스터에 호스팅되는 컬렉션에만 사용할 수 있습니다.
하나 이상의 필드에 대한 전체 텍스트 검색 지정하려면 $search
파이프라인 단계를 만들면 됩니다. 스칼라 운전자 이 단계를 생성하기 위해 Aggregates.search()
헬퍼 메서드를 제공합니다. search()
메서드에는 다음 인수가 필요합니다.
SearchOperator
인스턴스 : 검색 할 필드 와 텍스트를 지정합니다.SearchOptions
인스턴스: 전체 텍스트 검색 사용자 지정하는 옵션을 지정합니다. 사용할 Atlas Search 인덱스 의 이름으로index
옵션을 설정하다 해야 합니다.
이 예시 다음 조치를 수행하는 파이프라인 단계를 생성합니다.
name
필드"Salt"
단어가 포함된 텍스트 검색일치하는 문서의
_id
및name
값만 프로젝션
val operator = SearchOperator.text(SearchPath.fieldPath("name"), "Salt") val options = searchOptions().index("<search index name>") val pipeline = Seq(Aggregates.search(operator, options), Aggregates.project(Projections.include("name"))) collection.aggregate(pipeline) .subscribe((doc: Document) => println(doc.toJson()), (e: Throwable) => println(s"There was an error: $e"))
{"_id": {"$oid": "..."}, "name": "Fresh Salt"} {"_id": {"$oid": "..."}, "name": "Salt & Pepper"} {"_id": {"$oid": "..."}, "name": "Salt + Charcoal"} {"_id": {"$oid": "..."}, "name": "A Salt & Battery"} {"_id": {"$oid": "..."}, "name": "Salt And Fat"} {"_id": {"$oid": "..."}, "name": "Salt And Pepper Diner"}
중요
앞의 예시 실행 하려면 필드 포함하는 컬렉션 에 Atlas Search 인덱스 만들어야 restaurants
name
합니다. 그런 다음 "<search index name>"
자리 표시자를 인덱스 이름으로 바꿉니다. Atlas Search 인덱스에 대해 자세히 학습 Atlas Search 인덱스 가이드 참조하세요.
추가 정보
MongoDB Server 매뉴얼
이 가이드 에서 설명하는 주제에 대해 학습 보려면 MongoDB Server 매뉴얼의 다음 페이지를 참조하세요.
표현식 연산자의 전체 목록을 보려면 애그리게이션 연산자를 참조하세요.
집계 파이프라인 을 어셈블하는 방법과 예제를 학습 집계 파이프라인을 참조하세요.
파이프라인 단계 생성에 대해 자세히 알아보려면 애그리게이션 단계를 참조하세요.
MongoDB 작업에 대해 자세히 알아보려면 출력 설명 및 쿼리 계획을 참조하세요.
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.