정의
배열의 시작에서부터 지정된 수의 요소를 반환합니다.
참고
명확화
이 페이지에서는 표현식으로 사용될 때 배열의 시작에서부터 지정된 수의 요소를 반환하는 $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 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.
다음 예시는 $firstN 연산자를 사용하여 각 영화의 첫 번째 출연진 3명을 반환합니다. $addFields에서 생성한 새 필드 firstThreeCast에 cast 노드가 반환됩니다.
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를 사용하여 특정 영화 3개를 필터링합니다.$firstN과 함께$addFields를 사용하여n: 3을(를) 활용하여cast배열에서 첫 번째 세 개의 요소를 포함하는 새 필드firstThreeCast를 만듭니다.출력에
title,cast및firstThreeCast필드만 포함하기 위해$project를 사용합니다.결과를 제목별로 정렬하기 위해
$sort를 사용합니다.