$shift（集計）

このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。6.0 配置をアップグレードするには、 MongoDB 7.0 のアップグレード手順を参照してください。

定義

バージョン 5.0 で追加

$shift

ステージ$setWindowFields パーティション内の現在のドキュメントを基準とした指定された位置にあるドキュメントに適用された式の値を返します。

$setWindowFieldsステージのsortByフィールド値によってドキュメント順序が決まります。 MongoDB がさまざまな型のフィールドを比較する方法の詳細については、「 BSON 比較順序」を参照してください。

$shiftは$setWindowFieldsステージでのみ使用可能です。

$shift 構文:

{
   $shift: {
      output: <output expression>,
      by: <integer>,
      default: <default expression>
   }
}

$shift 次のフィールドを持つドキュメントを取ります。

フィールド	説明
出力	出力で評価して返す式を指定します。
による	出力内の現在のドキュメントに対する数値ドキュメント位置を持つ`integer`を指定します。以下に例を挙げます。 `1` は、現在のドキュメントの後のドキュメントの位置を指定します。 `-1` は、現在のドキュメントの前のドキュメントの位置を指定します。 `-2` は、現在のドキュメントの 2 つ前のドキュメント位置を指定します。
default	ドキュメントの位置が暗黙的な`$setWindowFields` ステージウィンドウの外部にあるかどうかを評価するためのオプションのデフォルト式を指定します。暗黙的なウィンドウには、パーティション内のすべてのドキュメントが含まれます。デフォルトの式は定数値に評価される必要があります。 `$shift`デフォルトの式を指定しない場合、`null` は暗黙的なステージウィンドウの外部にあるドキュメントの`$setWindowFields` を返します。

動作

$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後:
- 各stateのドキュメントのshiftQuantityForStateフィールドをquantity値に設定します。
- $shiftを使用して、出力内の現在のドキュメントに続くドキュメントからquantity値を返します。
  - ドキュメントの位置は$shift integer1、がに設定されているを使用して指定されます。
  - 暗黙的なウィンドウの外部のドキュメントの場合、 $shiftはデフォルトの式を使用して指定された"Not available"を返します。

この出力例では、シフトされた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後:
- 各stateのドキュメントのshiftQuantityForStateフィールドをquantity値に設定します。
- $shiftを使用して、出力の現在のドキュメントの前のドキュメントからquantity値を返します。
  - ドキュメントの位置は$shift integer-1、がに設定されているを使用して指定されます。
  - 暗黙的なウィンドウの外部のドキュメントの場合、 $shiftはデフォルトの式を使用して指定された"Not available"を返します。

この出力例では、シフトされた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 }

戻る

$setUnion

$size