/ /

$first（ウィンドウ関数）

定義

$first

ウィンドウ内の最初のドキュメントの式の値を返します。

注意

曖昧さ回避

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

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

$first (accumulator)は、各グループの最初の値を返すためにグループ化で使用されます。
$first (expression)は、配列の最初の要素を返します。

構文

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $first: <expression>
         }
      }
   }
}

動作

$firstウィンドウ関数は、null および欠損値に対して次の動作をします。

$first は欠落しているフィールド値を null に変換します。
$first は、空のウィンドウに対して null を返します。

例

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

この例では、$setWindowFields yearを使用して、映画をimdb.rating で分割し、で降順に並べ替えて、各年で最も評価の高い映画を識別します。各ドキュメントには、その年に公開された最高評価の映画のタイトルを示すフィールドが含まれています。

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

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

上記のパイプラインでは、

$match は、 IMDb 評価が 8.5 以上の 1999-2001 の映画をフィルタリングします。
$setWindowFieldsは映画をyear で分割し、imdb.rating で降順にソートします。ステージでは、$first として定義されたウィンドウを持つdocuments: [ "unbounded", "unbounded" ] を使用して、各年のパーティション内の最高評価の映画のタイトルを返します。
では出力に$project title、year 、、imdb.ratingtopRatedMovieInYear のみが含まれます。
$sort は、結果を年と評価でソートします。

戻る

$concatArrays

$firstN