AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$set(集計ステージ)

注意

曖昧さ回避

次のページは、集計ステージ $set について説明しています。更新演算子 $set については、$set を参照してください。

$set

ドキュメントに新しいフィールドを追加します。$set は、入力ドキュメントの既存の全フィールドと、新しく追加されたフィールドを含むドキュメントを出力します。

$setステージは$addFieldsのエイリアスです。

どちらのステージも、入力ドキュメント内の既存のフィールドをすべて明示的に指定し、新しいフィールドを追加する $project ステージと同等です。

次の環境でホストされる配置には $set を使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

$set の形式は次のとおりです。

{ $set: { <newField>: <expression>, ... } }

追加する各フィールドの名前を指定し、その値を集計式空のオブジェクトに設定します。式の詳細については、式を参照してください。

重要

新しいフィールドの名前が既存のフィールド名(_id など)と同じ場合、$set はそのフィールドの既存の値を、指定された式の値で上書きします。

  • $setは既存のドキュメントに新しいフィールドを追加します。 集計操作には、1 つ以上の$setステージを含めることができます。

  • $set は、集計式または空のオブジェクトに値を設定できるオブジェクトの埋め込みを受け入れます。たとえば、以下のようなネストされたオブジェクトを受け入れられます。

    {$set: { a: { b: { } } } }

    埋め込みドキュメント (配列内のドキュメントを含む) に 1 つまたは複数のフィールドを追加するには、ドット表記を使用します。 例 を参照してください。

  • $set を使用して既存の配列フィールドに要素を追加するには、$concatArrays を使用します。例を参照してください。

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

次の操作では、2 つの$setステージを使用して、出力ドキュメントに 3 つの新しいフィールドを含めます。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { imdbScoreScaled: { $multiply: [ "$imdb.rating", 10 ] }, runtimeHours: { $floor: { $divide: [ "$runtime", 60 ] } } } }, { $set: { totalScore: { $add: [ "$imdbScoreScaled", "$runtimeHours" ] } } }] )
[ { _id: ..., title: 'Baseball', runtime: 1140, imdbScoreScaled: 91, runtimeHours: 19, totalScore: 110 }, { _id: ..., title: 'Centennial', runtime: 1256, imdbScoreScaled: 85, runtimeHours: 20, totalScore: 105 }]...
第 1 ステージ($set):
最初の $set ステージでは、IMDB 評価に 10 を掛ける imdbScoreScaled と、ランタイムを 60 で割り、最近の整数に切り捨てる runtimeHours の 2 つのフィールドが追加されます。
第 2 ステージ($set):
2 番目の $set ステージでは、前のステージで計算された imdbScoreScaled と runtimeHours を合計する totalScore が追加されます。

埋め込みドキュメントに新しいフィールドを追加するには、ドット表記を使用します。

次の集計操作は、埋め込みドキュメント imdb に新しいフィールド normalizedRating を追加します。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { "imdb.normalizedRating": { $multiply: [ "$imdb.rating", 10 ] } } }] )
[ { _id: ..., title: 'Baseball', imdb: { '...': '...', normalizedRating: 91 } }, { _id: ..., title: 'Centennial', imdb: { '...': '...', normalizedRating: 85 } }]...

$set操作で既存のフィールド名を指定すると、元のフィールドが置き換えられます。

次の$set操作はratedフィールドを上書きします。

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { rated: "UNRATED" } }] )
[ { _id: ..., title: 'Baseball', rated: 'UNRATED' }]...

あるフィールドを別のフィールドで置き換えることができます。次の例では、_id フィールドの代わりに title フィールドを使用します。

次の集計操作では、$set を使用して各ドキュメントの _id フィールドを title フィールドの値に置き換え、title フィールドを string "movie" に置き換えます。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { _id: "$title", title: "movie" } }] )
[ { _id: 'Baseball', title: 'movie' }, { _id: 'Centennial', title: 'movie' }]...

$setと$concatArrays式を併用すると、既存の配列フィールドに要素を追加できます。次の操作では、$setを使用して、genresフィールドを、現在の genres 配列が新しいジャンル [ "Classic" ] を含む別の配列に連結されている新しい配列に置き換えます。

db.movies.aggregate( [ { $match: { title: "Baseball" } }, { $set: { genres: { $concatArrays: [ "$genres", [ "Classic" ] ] } } }] )
[ { _id: ..., title: 'Baseball', genres: [ 'Documentary', 'History', 'Sport', 'Classic' ] }]...

次の集計操作では、映画のタイトルと公開年を連結する新しいフィールド titleWithYear が各ドキュメントに追加されます。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $set: { titleWithYear: { $concat: [ "$title", " (", { $toString: "$year" }, ")" ] } } }] )
[ { _id: ..., title: 'Baseball', titleWithYear: 'Baseball (1994)' }, { _id: ..., title: 'Centennial', titleWithYear: 'Centennial (1978)' }]...

関連するパイプラインステージの詳細については、$addFieldsガイドを参照してください。

このページを評価