정의
배열의 첫 번째 요소를 반환합니다.
참고
명확화
이 페이지에서는 표현식으로 사용될 때 배열의 첫 번째 요소를 반환하는 $first에 대해 설명합니다.
$first를 다른 다음 문맥에서도 사용할 수 있습니다:
$first (accumulator), 그룹화에 사용되며 각 그룹에서 첫 번째 값을 반환합니다.$first (window function), 창의 첫 번째 문서에 대한 값을 반환하는 데$setWindowFields단계에서 사용되는.
구문
{ $first: <expression> }<expression>은 배열로 평가되어야 합니다.
행동
피연산자 표현식이 배열로 해석되는 경우,
$first은(는) 해당 배열의 첫 번째 요소를 반환합니다.배열이 비어 있으면
$first은null을(를) 반환합니다.표현식이
null(으)로 평가되거나 누락된 필드를 참조하는 경우,$first은null(을)를 반환합니다.
예시
이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.
다음 예시는 $first을(를) 사용하여 각 영화의 주연 배우를 반환합니다. sample_mflix 데이터셋에서는 cast 배열에 청구 순서대로 배우가 나열되어 있습니다. 따라서 첫 번째 요소가 최고 청구 배우입니다.
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Pulp Fiction", "Forrest Gump" ] } } }, { $addFields: { topBilledActor: { $first: "$cast" } } }, { $project: { _id: 0, title: 1, cast: 1, topBilledActor: 1 } }, { $sort: { title: 1 } }] )이전 파이프라인의 경우:
$match3개의 특정 영화에 대한 필터$addFields와 `$first`을 사용하면 `cast` 배열의 첫 번째 요소를 포함하는 새 필드 `topBilledActor`가 만들어집니다.$project는 출력에title,cast및topBilledActor필드만 포함합니다.$sort결과를 제목으로 정렬합니다.