$shift(集計)
定義
バージョン 5.0 で追加
ステージ$setWindowFields
パーティション 内の現在のドキュメントを基準とした指定された位置にあるドキュメントに適用された 式 の値を返します。
$setWindowFields
ステージのsortByフィールド値によってドキュメント順序が決まります。 MongoDB がさまざまな型のフィールドを比較する方法の詳細については、「 BSON 比較順序 」を参照してください。
$shift
は$setWindowFields
ステージでのみ使用可能です。
$shift
構文:
{ $shift: { output: <output expression>, by: <integer>, default: <default expression> } }
$shift
次のフィールドを持つドキュメントを取ります。
フィールド | 説明 |
---|---|
出力で評価して返す式を指定します。 | |
出力内の現在のドキュメントに対する数値ドキュメント位置を持つ 以下に例を挙げます。
| |
ドキュメントの位置が暗黙的な デフォルトの式は定数値に評価される必要があります。 デフォルト式を指定しない場合、 |
動作
$shift
{ ステージで ウィンドウ を指定すると、 $setWindowFields
はエラーを返します。
例
カリフォルニア州(CA
)とワシントン州(WA
)のケーキ販売を含む cakeSales
コレクションを作成します。
db.cakeSales.insertMany( [ { _id: 0, type: "chocolate", orderDate: new Date("2020-05-18T14:10:30Z"), state: "CA", price: 13, quantity: 120 }, { _id: 1, type: "chocolate", orderDate: new Date("2021-03-20T11:30:05Z"), state: "WA", price: 14, quantity: 140 }, { _id: 2, type: "vanilla", orderDate: new Date("2021-01-11T06:31:15Z"), state: "CA", price: 12, quantity: 145 }, { _id: 3, type: "vanilla", orderDate: new Date("2020-02-08T13:13:23Z"), state: "WA", price: 13, quantity: 104 }, { _id: 4, type: "strawberry", orderDate: new Date("2019-05-18T16:09:01Z"), state: "CA", price: 41, quantity: 162 }, { _id: 5, type: "strawberry", orderDate: new Date("2019-01-08T06:12:03Z"), state: "WA", price: 43, quantity: 134 } ] )
次の例では、 cakeSales
コレクションが使用されています。
正の整数を使用したフィルター
この例では、$shift
$setWindowFields
ステージのquantity
を使用して、各 の現在のドキュメントに続く各ドキュメントからのケーキ販売のstate
を出力します。
db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { shiftQuantityForState: { $shift: { output: "$quantity", by: 1, default: "Not available" } } } } } ] )
この例では、次のことが行われます。
partitionBy: "$state"
はコレクション内のドキュメントをstate
で分割します。CA
とWA
のパーティションがあります。sortBy: { quantity: -1 }
は各パーティション内のドキュメントをquantity
で降順(-1
)にソートするため、最高のquantity
が先頭になります。
output
sortBy
後:
この出力例では、シフトされたquantity
値が返された各ドキュメントのshiftQuantityForState
フィールドに表示されます。
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "shiftQuantityForState" : 145 } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "shiftQuantityForState" : 120 } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "shiftQuantityForState" : "Not available" } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "shiftQuantityForState" : 134 } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "shiftQuantityForState" : 104 } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "shiftQuantityForState" : "Not available" }
負の整数を使用したフィルター
この例では、$shift
$setWindowFields
ステージのquantity
を使用して、各 の現在のドキュメントの前の各ドキュメントからのケーキ販売のstate
を出力します。
db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { shiftQuantityForState: { $shift: { output: "$quantity", by: -1, default: "Not available" } } } } } ] )
この例では、次のことが行われます。
partitionBy: "$state"
はコレクション内のドキュメントをstate
で分割します。CA
とWA
のパーティションがあります。sortBy: { quantity: -1 }
は各パーティション内のドキュメントをquantity
で降順(-1
)にソートするため、最高のquantity
が先頭になります。
output
sortBy
後:
この出力例では、シフトされたquantity
値が返された各ドキュメントのshiftQuantityForState
フィールドに表示されます。
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "shiftQuantityForState" : "Not available" } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "shiftQuantityForState" : 162 } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "shiftQuantityForState" : 145 } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "shiftQuantityForState" : "Not available" } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "shiftQuantityForState" : 140 } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "shiftQuantityForState" : 134 }