정의
배열 의 시작 부분부터 지정된 수의 요소를 반환합니다.
참고
명확화
이 페이지에서는 배열 의 시작 부분에서 지정된 수의 요소를 반환하는 표현식 으로 사용되는 $firstN에 대해 설명합니다.
다음과 같은 다른 컨텍스트에서도 $firstN를 사용할 수 있습니다.
$firstN (accumulator)는 각 그룹 에서 첫n개의 요소를 반환하기 위해 그룹화하는 데 사용됩니다.$firstN (window function)는$setWindowFields단계에서 특정 창 문서에서 처음n값을 반환하는 데 사용됩니다.
구문
{ $firstN: { input: <expression>, n: <expression> } }
옵션
필드 | 유형 | 설명 |
|---|---|---|
| 표현식 | 첫 번째 |
| 표현식 |
|
행동
$firstN입력 배열에 나타나는 것과 동일한 순서로 요소를 반환합니다.$firstN입력 배열 에서null값을 필터하다 하지 않습니다.1보다 작은n값은 지정할 수 없습니다.지정된
n이input배열 의 요소 수보다 크거나 같으면$firstN는 전체input배열 반환합니다.input배열이 아닌 값으로 확인되면 집계 작업 오류가 발생합니다.
예시
이 페이지의 예제에서는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB deployment 에 로드하는 방법에 대한 자세한 내용은 샘플 데이터 세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우 이 페이지의 예제를 실행 하려면 데이터베이스를 삭제하고 다시 만들어야 할 수 있습니다.
다음 예시 $firstN 연산자 사용하여 각 영화의 처음 3명의 출연진을 반환합니다. 캐스트 멤버는 $addFields가 생성한 새 필드 firstThreeCast에 반환됩니다.
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Spirited Away", "The Dark Knight" ] } } }, { $addFields: { firstThreeCast: { $firstN: { input: "$cast", n: 3 } } } }, { $project: { _id: 0, title: 1, cast: 1, firstThreeCast: 1 } }, { $sort: { title: 1 } } ] )
이전 파이프라인:
$match를 사용하여 세 개의 특정 영화를 필터하다 합니다.$addFields를$firstN와 함께 사용하여n: 3이 있는cast배열 에서 처음 세 개의 요소를 포함하는 새 필드firstThreeCast를 생성합니다.$project를 사용하여 출력에title,cast및firstThreeCast필드만 포함합니다.$sort를 사용하여 제목별로 결과를 정렬합니다.