정의
창에서 각 문서에 표현식을 적용한 결과로 생성되는 중복을 포함한 모든 값의 배열을 반환합니다.
참고
명확화
이 페이지에서는 창 함수로 사용될 때의 $push에 대해 설명합니다.
$push를 다른 다음 문맥에서도 사용할 수 있습니다:
$push (accumulator), 그룹의 각 문서에 표현식을 적용한 후 결과 배열을 반환합니다.$push (update operator), 이는 문서의 배열 필드에 값을 추가합니다.
구문
{ $setWindowFields: { ... output: { <field>: { $push: <expression> } } }}행동
$push 창에서 중복된 값을 포함하여 모든 값을 포함합니다. 출력 배열의 요소 순서는 $setWindowFields sortBy 필드에 지정된 정렬 순서와 일치합니다.
internalQueryMaxPushBytes 서버 매개변수는 누적된 배열이 사용할 수 있는 메모리 양을 제한합니다. 자세한 내용은 $push 축적자 메모리 제한을 참조하세요.
예시
이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.
이 예시는 $push 창 함수를 사용하여 2002의 영화에서 장르의 누적 목록을 빌드합니다. 영화마다, $push는 영화의 프라이머리 장르를 genresSeenSoFar에 추가하며, 중복된 값을 포함하여 모든 값을 유지합니다.
db.movies.aggregate( [ { $match: { year: 2002, genres: { $exists: true, $ne: [] } } }, { $addFields: { primaryGenre: { $first: "$genres" } } }, { $setWindowFields: { sortBy: { title: 1 }, output: { genresSeenSoFar: { $push: "$primaryGenre", window: { documents: [ "unbounded", "current" ] } } } } }, { $project: { _id: 0, genresSeenSoFar: "$genresSeenSoFar", year: "$year", title: "$title", genre: "$primaryGenre", totalGenreCount: { $size: "$genresSeenSoFar" } } }, { $limit: 8 }] )예시:
$match단계는 2002 년에서 장르 정보가 포함된 영화를 필터링합니다.$addFields단계는genres배열의 첫 번째 요소를 포함하는primaryGenre필드를 추가합니다.$setWindowFields단계는$push를unbounded에서current까지의 창과 함께 사용하여 결과 세트의 시작부터 현재 문서까지 모든 장르를 누적합니다.$project단계는 출력을 재구성하고totalGenreCount을(를) 계산하여 각 문서에 따라 배열이 어떻게 증가하는지 보여줍니다.$limit단계는 출력을 8 문서로 제한하여 가독성을 높입니다.
totalGenreCount 문서를 추가할 때마다 1씩 증가합니다. 일곱 번째 문서('3 Extremes II')의 장르가 Horror입니다. 이 장르는 이미 배열에 있었으므로 Horror가 genresSeenSoFar에 두 번 나타납니다. 이는 $push 에는 중복 값이 포함되어 있지만, 고유한 값만 추가하는 $addToSet와는 달리합니다.