$firstN

이 페이지의 내용

정의

집계 누산기
구문
행동
제한 사항
예시
배열 연산자
구문
행동
예시

정의

버전 5.2에 추가되었습니다.

$firstN 집계 축적자 또는 배열 연산자로 사용할 수 있습니다. 애그리게이션 축적자로서 그룹 내 첫 n 개 요소의 애그리게이션을 반환합니다. 배열 연산자로서 배열의 시작 부분부터 지정된 수의 요소를 반환합니다.

집계 누산기

$firstN

$firstN 을(를) 애그리게이션 축적자로 사용하는 경우 반환된 요소는 지정된 정렬 순서로 정렬되어 있는 경우에만 의미가 있습니다. 그룹에 n 개 미만의 요소가 포함된 경우 $firstN 는 그룹의 모든 요소를 반환합니다.

구문

집계 축적자로 사용되는 경우 $firstN의 구문은 다음과 같습니다.

{
   $firstN:
      {
         input: <expression>,
         n: <expression>
      }
}

input 문서의 처음 n개를 가져올 필드를 지정합니다. 입력은 모든 표현식이 가능합니다.
n $group 에 대한 _id 값에 의존하거나 상수인 양의 정수 표현식 이어야 합니다. 자세한 내용은 그룹 키 예시 를 참조하세요.

행동

Null 및 누락된 값

$firstN null 값을 필터링하지 않습니다.
$firstN 누락된 값을 null로 변환합니다.

그룹에서 처음 5개 문서를 반환하는 다음 집계를 가정해 보겠습니다.

db.aggregate( [
   {
      $documents: [
         { playerId: "PlayerA", gameId: "G1", score: 1 },
         { playerId: "PlayerB", gameId: "G1", score: 2 },
         { playerId: "PlayerC", gameId: "G1", score: 3 },
         { playerId: "PlayerD", gameId: "G1"},
         { playerId: "PlayerE", gameId: "G1", score: null }
      ]
   },
   {
      $group:
      {
         _id: "$gameId",
         firstFiveScores:
            {
               $firstN:
                  {
                     input: "$score",
                     n: 5
                  }
            }
      }
   }
] )

이 예시에서는

$documents 플레이어 점수가 포함된 리터럴 문서를 생성합니다.
$group은 gameId 기준으로 문서를 그룹화합니다. 이 예시에는 gameId가 단 하나(G1)만 있습니다.
PlayerD 점수가 누락되었고 PlayerE에 null score가 있습니다. 이 값은 모두 null로 간주됩니다.
firstFiveScores 필드는 input : "$score" 을 사용하여 지정되고 배열로 반환됩니다.
정렬 기준이 없으므로 처음 5개의 score 필드가 반환됩니다.

[
   {
      _id: 'G1',
      firstFiveScores: [ 1, 2, 3, null, null ]
   }
]

`$firstN` 및 `$topN` 축적자 비교

$firstN 축적자와 $topN 축적자는 모두 비슷한 결과를 얻을 수 있습니다.

일반적으로 다음과 같습니다.

$group 에 들어오는 문서가 이미 주문된 경우 $firstN 을 사용해야 합니다.
상위 n 요소를 정렬하고 선택하는 경우 $topN을 사용하여 하나의 축적자로 두 작업을 모두 수행할 수 있습니다.
$firstN 는 애그리게이션 표현식으로 사용할 수 있지만 $topN 은 사용할 수 없습니다.

제한 사항

창 함수 및 집계 표현식 지원

$firstN 은(는) 애그리게이션 표현식으로 지원됩니다.

$firstN 은 window operator로 지원됩니다.

예시

다음 문서가 포함된 gamescores collection을 생각해 보세요.

db.gamescores.insertMany([
   { playerId: "PlayerA", gameId: "G1", score: 31 },
   { playerId: "PlayerB", gameId: "G1", score: 33 },
   { playerId: "PlayerC", gameId: "G1", score: 99 },
   { playerId: "PlayerD", gameId: "G1", score: 1 },
   { playerId: "PlayerA", gameId: "G2", score: 10 },
   { playerId: "PlayerB", gameId: "G2", score: 14 },
   { playerId: "PlayerC", gameId: "G2", score: 66 },
   { playerId: "PlayerD", gameId: "G2", score: 80 }
])

단일 게임의 첫 세 플레이어 점수 찾기

$firstN 축적자를 사용하여 한 게임에서 처음 세 개의 점수를 찾을 수 있습니다.

db.gamescores.aggregate( [
   {
      $match : { gameId : "G1" }
   },
   {
      $group:
         {
            _id: "$gameId",
            firstThreeScores:
               {
                  $firstN:
                  {
                     input: ["$playerId", "$score"],
                     n:3
                  }
               }
         }
   }
] )

예시 파이프라인:

$match를 사용하여 단일 gameId 결과를 필터링합니다. 이 경우에는 G1입니다.
$group을 사용하여 gameId를 기준으로 결과를 그룹화합니다. 이 경우에는 G1입니다.
input : ["$playerId"," $score"] 을 사용하여 $firstN 에 입력되는 필드를 지정합니다.
$firstN을 사용하여 n : 3으로 G1 게임에 대한 처음 세 개의 문서를 반환합니다.

이 연산은 다음과 같은 결과를 반환합니다.

[
   {
      _id: 'G1',
      firstThreeScores: [ [ 'PlayerA', 31 ], [ 'PlayerB', 33 ], [ 'PlayerC', 99 ] ]
   }
]

여러 게임의 첫 세 플레이어 점수 찾기

$firstN 축적자를 사용하여 각 게임에서 처음 n개의 입력 필드를 찾을 수 있습니다.

db.gamescores.aggregate( [
   {
      $group:
      {
      _id: "$gameId", playerId:
         {
            $firstN:
               {
                  input: [ "$playerId","$score" ],
                  n: 3
               }
         }
      }
   }
] )

예시 파이프라인:

$group을 사용하여 gameId를 기준으로 결과를 그룹화합니다.
$firstN을 사용하여 n: 3인 각 게임에 대해 처음 세 개의 문서를 반환합니다.
input : ["$playerId", "$score"] 을 사용하여 $firstN 에 입력되는 필드를 지정합니다.

이 연산은 다음과 같은 결과를 반환합니다.

[
   {
      _id: 'G1',
      playerId: [ [ 'PlayerA', 31 ], [ 'PlayerB', 33 ], [ 'PlayerC', 99 ] ]
   },
   {
      _id: 'G2',
      playerId: [ [ 'PlayerA', 10 ], [ 'PlayerB', 14 ], [ 'PlayerC', 66 ] ]
   }
]

와 함께 사용 `$sort` `$firstN`

파이프라인의 초기 단계에서 $sort 단계를 사용하면 $firstN 축적자의 결과에 영향을 미칠 수 있습니다.

이 예시에서는

{$sort : { score : -1 } } 가장 높은 점수를 각 그룹 뒤쪽으로 정렬합니다.
firstN 각 그룹에서 가장 높은 세 개의 점수를 반환합니다.

db.gamescores.aggregate( [
      { $sort : { score : -1 } },
      {
         $group:
         { _id: "$gameId", playerId:
            {
               $firstN:
                  {
                     input: [ "$playerId","$score" ],
                     n: 3
                  }
            }
         }
      }
   ] )

이 연산은 다음과 같은 결과를 반환합니다.

[
   {
      _id: 'G2',
      playerId: [ [ 'PlayerD', 80 ], [ 'PlayerC', 66 ], [ 'PlayerB', 14 ] ]
   },
   {
      _id: 'G1',
      playerId: [ [ 'PlayerC', 99 ], [ 'PlayerB', 33 ], [ 'PlayerA', 31 ] ]
   }
]

의 그룹 키를 기반으로 계산 `n` `$group`

n 의 값을 동적으로 할당할 수도 있습니다. 이 예제에서는 $cond 표현식이 gameId 필드에 사용됩니다.

db.gamescores.aggregate([
   {
      $group:
      {
         _id: {"gameId": "$gameId"},
         gamescores:
            {
               $firstN:
                  {
                     input: "$score",
                     n: { $cond: { if: {$eq: ["$gameId","G2"] }, then: 1, else: 3 } }
                  }
            }
      }
   }
] )

예시 파이프라인:

$group을 사용하여 gameId를 기준으로 결과를 그룹화합니다.
input : "$score" 으로 $firstN 에 입력하는 필드를 지정합니다.
gameId 가 G2 이면 n 는 1이고, 그렇지 않으면 n 는 3입니다.

이 연산은 다음과 같은 결과를 반환합니다.

[
   { _id: { gameId: 'G1' }, gamescores: [ 31, 33, 99 ] },
   { _id: { gameId: 'G2' }, gamescores: [ 10 ] }
]

`$firstN` 애그리게이션 표현식으로 사용

$firstN 를 애그리게이션 표현식으로 사용할 수도 있습니다.

이 예시에서는

$documents 값 배열을 포함하는 리터럴 문서를 만듭니다.
$project $firstN 의 출력값을 반환하는 데 사용됩니다.
_id _id : 0 과 함께 출력에서 생략됩니다.
$firstN [10, 20, 30, 40] 의 입력 배열을 사용합니다.
배열의 처음 세 요소는 입력 문서에 대해 반환됩니다.

db.aggregate( [
   {
      $documents: [
         { array: [10, 20, 30, 40] } ]
   },
   { $project: {
      firstThreeElements:{
                           $firstN:
                           {
                              input: "$array",
                              n: 3
                           }
                        }
               }
   }
] )

이 연산은 다음과 같은 결과를 반환합니다.

[
   { firstThreeElements: [ 10, 20, 30 ] }
]

배열 연산자

$firstN

구문

$firstN가 배열 연산자로 사용되는 경우 구문은 다음과 같습니다.

{ $firstN: { n: <expression>, input: <expression> } }

필드	설명
`n`	양의 정수로 해석되는 표현식입니다. 정수는 `$firstN`이 반환하는 배열 요소의 수를 지정합니다.
`input`	`n` 요소를 반환할 배열로 해석되는 표현식입니다.

행동

$firstN 입력 배열에 나타나는 것과 동일한 순서로 요소를 반환합니다.
$firstN이 입력 배열의 null 값을 필터링하지 않습니다.
1보다 작은 n 값은 지정할 수 없습니다.
지정된 n이 input 배열의 요소 수보다 크거나 같으면 $firstN이 input 배열을 반환합니다.
input 배열이 아닌 값으로 확인되면 집계 작업 오류가 발생합니다.

예시

컬렉션 games에는 다음 문서가 있습니다.

db.games.insertMany([
    { "playerId" : 1, "score" : [ 1, 2, 3 ] },
    { "playerId" : 2, "score" : [ 12, 90, 7, 89, 8 ] },
    { "playerId" : 3, "score" : [ null ] },
    { "playerId" : 4, "score" : [ ] },
    { "playerId" : 5, "score" : [ 1293, null, 3489, 9 ]},
    { "playerId" : 6, "score" : [ "12.1", 2, NumberLong("2090845886852"), 23 ]}
])

다음 예시는 $firstN 연산자를 사용하여 각 플레이어의 처음 세 점수를 조회합니다. $addFields에서 생성한 새 필드 firstScores에 점수가 반환됩니다.

db.games.aggregate([
   { $addFields: { firstScores: { $firstN: { n: 3, input: "$score" } } } }
])

이 연산은 다음과 같은 결과를 반환합니다.

[{
  "playerId": 1,
  "score": [ 1, 2, 3 ],
  "firstScores": [ 1, 2, 3 ]
},
{
  "playerId": 2,
  "score": [ 12, 90, 7, 89, 8 ],
  "firstScores": [ 12, 90, 7 ]
},
{
  "playerId": 3,
  "score": [ null ],
  "firstScores": [ null ]
},
{
  "playerId": 4,
  "score": [ ],
  "firstScores": [ ]
},
{
  "playerId": 5,
  "score": [ 1293, null, 3489, 9 ],
  "firstScores": [ 1293, null, 3489 ]
},
{
  "playerId": 6,
  "score": [ "12.1", 2, NumberLong("2090845886852"), 23 ],
  "firstScores": [ "12.1", 2, NumberLong("2090845886852") ]
 }]

팁

다음도 참조하세요.

돌아가기

$first

$floor

정의

집계 누산기

구문

행동

Null 및 누락된 값

$firstN 및 $topN 축적자 비교

제한 사항

창 함수 및 집계 표현식 지원

예시

단일 게임의 첫 세 플레이어 점수 찾기

여러 게임의 첫 세 플레이어 점수 찾기

와 함께 사용 $sort $firstN

의 그룹 키를 기반으로 계산 n $group

$firstN 애그리게이션 표현식으로 사용

배열 연산자

구문

행동

예시

팁

다음도 참조하세요.

`$firstN` 및 `$topN` 축적자 비교

와 함께 사용 `$sort` `$firstN`

의 그룹 키를 기반으로 계산 `n` `$group`

`$firstN` 애그리게이션 표현식으로 사용