AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs Menu

$firstN (표현식)

$firstN

배열 의 시작 부분부터 지정된 수의 요소를 반환합니다.

참고

명확화

이 페이지에서는 배열 의 시작 부분에서 지정된 수의 요소를 반환하는 표현식 으로 사용되는 $firstN에 대해 설명합니다.

다음과 같은 다른 컨텍스트에서도 $firstN를 사용할 수 있습니다.

{ $firstN: { input: <expression>, n: <expression> } }
필드
유형
설명

input

표현식

첫 번째 n 요소를 반환할 배열 입니다.

n

표현식

$firstN가 반환하는 요소의 수입니다. 양의 정수로 해석되어야 합니다.

  • $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를 사용하여 제목별로 결과를 정렬합니다.

이 페이지 평가하기