定義
$switch一連のケース式を評価します。
trueに評価される式が見つかると、$switch指定された式を実行し、制御フローを抜け出します。$switchの構文は次のとおりです。$switch: { branches: [ { case: <expression>, then: <expression> }, { case: <expression>, then: <expression> }, ... ], default: <expression>}branches配列内のオブジェクトには、caseフィールドとthenフィールドのみを含める必要があります。オペランド説明branchesdefault任意。
trueと評価するブランチcase式が無い場合に採用するパス。省略可能ですが、
defaultが指定されず、true と評価するブランチcaseがない場合、$switchはエラーを返します。
動作
のさまざまなケース ステートメントは、相互に排他的である必要はありません。 $switchは、 trueと評価される最初に見つけたブランチを実行します。 どのブランチも true と評価しない場合、 $switchはdefaultオプションを実行します。
次の条件は、$switch がエラーで失敗する原因になります。
branchesフィールドが欠落しているか、少なくとも 1 つのエントリを含む配列ではありません。branches配列内のオブジェクトには、caseフィールドが含まれていません。branches配列内のオブジェクトには、thenフィールドが含まれていません。branches配列内のオブジェクトには、case以外、またはthen以外のフィールドが含まれています。defaultは指定されず、trueと評価されるcaseはありません。
例 | 結果 |
|---|---|
|
|
|
|
|
|
例
以下の例では、sample_mflix サンプル データセットの movies コレクションを使用します。このデータセットを配置にロードする方法について詳しくは、「サンプル データセットのロード」を参照してください。
この集計操作では、$switch を使用して、各映画の評価に基づいて特定のメッセージが表示されます。$match ステージでは、サンプルデータセット内の最も長い3つの映画に結果を制限します。
db.movies.aggregate( [ { $match: { runtime: { $gt: 800 } } }, { $project: { _id: 0, title: 1, summary: { $switch: { branches: [ { case: { $gte: [ "$imdb.rating", 9 ] }, then: "Doing great!" }, { case: { $and: [ { $gte: [ "$imdb.rating", 8 ] }, { $lt: [ "$imdb.rating", 9 ] } ] }, then: "Doing pretty well." }, { case: { $lt: [ "$imdb.rating", 8 ] }, then: "Needs improvement." } ], default: "No rating found." } } } }, { $sort: { title: 1 } }] )[ { title: 'Baseball', summary: 'Doing great!' }, { title: 'Centennial', summary: 'Doing pretty well.' }, { title: 'Taken', summary: 'Needs improvement.' }]Tip