/ /

$firstN（ウィンドウ関数）

定義

$firstN

ウィンドウ内の最初の n 要素を含む配列を返します。

注意

曖昧さ回避

このページでは、ウィンドウ関数として使用する場合の$firstN について説明します。

次の他のコンテキストでは $firstN を使用することもできます。

$firstN (accumulator)n。グループ化で使用され、各グループから最初の要素を返します。
$firstN (expression)は、配列の先頭から指定された数の要素を返します。

構文

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $firstN: {
               input: <expression>,
               n: <expression>
            }
         }
      }
   }
}

オプション

フィールド	タイプ	説明
`input`	式	`input`式はウィンドウ内の各ドキュメントに対して評価され、最初の `n` 結果が保持されます。
`n`	式	`$firstN` がウィンドウから返す要素の数。正の整数に解決される必要があります。ウィンドウに含まれる要素が `n` 未満の場合、`$firstN` はウィンドウ内のすべての要素を返します。

動作

NULL および欠損値

$firstN は、null 値をフィルタリングで除外しません。
$firstN 欠落値を null に変換します。

例

このページの例では、 sample_mflix データセットのデータを使用します。このデータセットを自己管理型MongoDBデプロイにロードする方法の詳細については、「サンプルデータセットをロードする」を参照してください。サンプルデータベースに変更を加えた場合、このページの例を実行するには、データベースを削除して再作成する必要がある場合があります。

この例では、$setWindowFields yearを使用して、映画をimdb.rating で分割し、で降順にソートして、各年の最初の 3 つの映画を返します。各映画には、その年に公開された最高評価の 3 つの映画タイトルを表示するフィールドも含まれています。

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2000, 2001 ] },
         "imdb.rating": { $gte: 8.5 }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { "imdb.rating": -1 },
         output: {
            topThreeMoviesInYear: {
               $firstN: {
                  input: "$title",
                  n: 3
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         "imdb.rating": 1,
         topThreeMoviesInYear: 1
      }
   },
   {
      $sort: { year: 1, "imdb.rating": -1 }
   }
] )

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Gladiator',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Memento',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Hera Pheri',
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: "A Dog's Will",
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.8 },
    year: 2001,
    title: 'The Lord of the Rings: The Fellowship of the Ring',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  }
]

先行するパイプライン:

$match1999ステージを使用して、から年にリリースされ、2001 IMDb 評価が8.5 以上の映画に結果をフィルタリングします。
$setWindowFieldsを使用して、映画をで分割し、year imdb.ratingで降順にソートします。ステージでは、$firstN n: 3topThreeMoviesInYearとdocuments: [ "unbounded", "unbounded" ] を使用して、として定義されたウィンドウからを作成します。
出力に $projecttitleyear、、imdb.rating 、フィールドのみを含めるには、を使用します。topThreeMoviesInYear
$sortを使用して、結果を年と評価で並べ替えます。

戻る

$first

$last