/ /

$firstN（式）

定義

$firstN

配列の先頭から指定した数の要素を返します。

注意

曖昧さ回避

このページでは、配列の先頭から指定された数の要素を式として使用される場合の$firstN について説明します。

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

$firstN (accumulator)n。グループ化で使用され、各グループから最初の要素を返します。
$firstN (window function)。これは特定のウィンドウ内のドキュメントから最初の$setWindowFields n値を返すためにステージで使用されます。

構文

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

オプション

フィールド	タイプ	説明
`input`	式	最初の `n` 要素を返す配列。
`n`	式	`$firstN` が返す要素の数。正の整数に解決される必要があります。

動作

$firstN は、入力配列に出現する順序で要素を返します。
$firstN は入力配列内の null 値をフィルタリングで除外しません。
1 nの値は指定できません。
指定された n が input 配列の要素数以上の場合、$firstN は input 配列全体を返します。
inputが配列以外の値に解決される場合、集計操作はエラーになります。

例

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

次の例では、$firstN 演算子を使用して、各映画の最初の 3 つのキャストメンバーを返します。キャストメンバーは、によって作成された新しいフィールドfirstThreeCast $addFieldsに返されます。

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 }
   }
] )

[
  {
    title: 'Spirited Away',
    cast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki', 'Takashi Naitè' ],
    firstThreeCast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki' ]
  },
  {
    title: 'The Dark Knight',
    cast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart', 'Michael Caine' ],
    firstThreeCast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart' ]
  },
  {
    title: 'The Godfather',
    cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ],
    firstThreeCast: [ 'Marlon Brando', 'Al Pacino', 'James Caan' ]
  }
]

先行するパイプライン:

$match3 つの特定の映画をフィルタリングするには、を使用します。
とを使用して、を持つ$addFields $firstNfirstThreeCast配列の最初の 3 つの要素を含む新しいフィールドcastn: 3 を作成します。
出力に $projecttitlecast、、フィールドのみを含めるには、を使用します。firstThreeCast
$sort結果をタイトル別にソートするには、を使用します。

詳細

戻る

$first

$floor