/ /

演算子

集計パイプライン演算子

Docs Home

MongoDBマニュアル

参照

演算子

集計パイプライン演算子

$setField（集計）

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

定義

$setField

バージョン 5.0 で追加

ドキュメント内の指定フィールドを追加、アップデート、排除します。

$setFieldを使用して、名前にピリオド（ . ）が含まれるフィールドやドル記号（ $ ）で始まるフィールドを追加、更新、または削除できます。

Tip

$getFieldを使用して、 $setFieldで追加または更新するドル記号（ $ ）またはピリオド（ . ）を含むフィールドの値を取得します。

構文

$setField の構文は次のとおりです。

{
  $setField: {
    field: <String>,
    input: <Object>,
    value: <Expression>
  }
}

次のフィールドを提供する必要があります。

フィールド	タイプ	説明
`field`	文字列	追加、更新、または削除する`input`オブジェクト内のフィールド。 `field`は、string 定数に変換される任意の有効な式にすることができます。
`input`	オブジェクト	追加または更新する`field`を含むドキュメント。 `input`は、オブジェクト`missing` 、 `null` 、または`undefined`に変換される必要があります。
`value`	式	`field`に割り当てる値。 `value`は任意の有効な式にすることができます。を`$$REMOVE`に設定すると、 `input`ドキュメントから`field`が削除されます。

動作

inputがmissing 、 undefined 、またはnullと評価された場合、 $setFieldはnullを返し、 inputを更新しません。
inputがオブジェクト以外のオブジェクト（ missing 、 undefined 、またはnull ）以外と評価された場合、 $setFieldはエラーを返します。
fieldが string 定数以外に解決される場合、 $setFieldはエラーを返します。
fieldがinputに存在しない場合、 $setFieldはそれを追加します。
$setFieldはオブジェクトまたは配列を暗黙的にトラバースすることはありません。たとえば、 $setFieldは、 "a.b.c"のfield値を、ネストされたフィールド{ "a": { "b": { "c": } } }としてではなく、最上位フィールド"a.b.c"として評価します。

$unsetFieldは$setFieldのエイリアスであり、入力値は$$REMOVEです。次の式は同等です。

{
   $setField: {
      field: <field name>,
      input: “$$ROOT”,
      value: "$$REMOVE"
   }
}
{
   $unsetField: {
      field: <field name>,
      input: “$$ROOT”
   }
}

Tip

フィールド名に関する考慮事項

例

ピリオドを含むフィールドを追加しました（`.` ）

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany( [
   { "_id" : 1, "item" : "sweatshirt", price: 45.99, qty: 300 }
   { "_id" : 2, "item" : "winter coat", price: 499.99, qty: 200 }
   { "_id" : 3, "item" : "sun dress", price: 199.99, qty: 250 }
   { "_id" : 4, "item" : "leather boots", price: 249.99, qty: 300 }
   { "_id" : 5, "item" : "bow tie", price: 9.99, qty: 180 }
] )

次の操作では、 $replaceWithパイプラインステージと$setField演算子を使用して、各ドキュメントに新しいフィールド"price.usd"を追加します。 "price.usd"の値は、各ドキュメントの"price"の値と等しくなります。最後に、この操作では$unsetパイプラインステージを使用して"price"フィールドを削除します。

db.inventory.aggregate( [
   { $replaceWith: {
        $setField: {
           field: "price.usd",
           input: "$$ROOT",
           value: "$price"
   } } },
   { $unset: "price" }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300, 'price.usd': 45.99 },
  { _id: 2, item: 'winter coat', qty: 200, 'price.usd': 499.99 },
  { _id: 3, item: 'sun dress', qty: 250, 'price.usd': 199.99 },
  { _id: 4, item: 'leather boots', qty: 300, 'price.usd': 249.99 },
  { _id: 5, item: 'bow tie', qty: 180, 'price.usd': 9.99 }
]

ドル記号（`$` ）で始まるフィールドを追加する

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany( [
   { "_id" : 1, "item" : "sweatshirt", price: 45.99, qty: 300 }
   { "_id" : 2, "item" : "winter coat", price: 499.99, qty: 200 }
   { "_id" : 3, "item" : "sun dress", price: 199.99, qty: 250 }
   { "_id" : 4, "item" : "leather boots", price: 249.99, qty: 300 }
   { "_id" : 5, "item" : "bow tie", price: 9.99, qty: 180 }
] )

次の操作では、 $replaceWithパイプラインステージと$setField } 演算子および$literal演算子を使用して、各ドキュメントに新しいフィールド"$price"を追加します。 "$price"の値は、各ドキュメントの"price"の値と等しくなります。最後に、この操作では$unsetパイプラインステージを使用して"price"フィールドを削除します。

db.inventory.aggregate( [
   { $replaceWith: {
        $setField: {
           field: { $literal: "$price" },
           input: "$$ROOT",
           value: "$price"
   } } },
   { $unset: "price" }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300, '$price': 45.99 },
  { _id: 2, item: 'winter coat', qty: 200, '$price': 499.99 },
  { _id: 3, item: 'sun dress', qty: 250, '$price': 199.99 },
  { _id: 4, item: 'leather boots', qty: 300, '$price': 249.99 },
  { _id: 5, item: 'bow tie', qty: 180, '$price': 9.99 }
]

ピリオドを含むフィールドを更新する（`.` ）

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany( [
   { _id: 1, item: 'sweatshirt', qty: 300, 'price.usd': 45.99 },
   { _id: 2, item: 'winter coat', qty: 200, 'price.usd': 499.99 },
   { _id: 3, item: 'sun dress', qty: 250, 'price.usd': 199.99 },
   { _id: 4, item: 'leather boots', qty: 300, 'price.usd': 249.99 },
   { _id: 5, item: 'bow tie', qty: 180, 'price.usd': 9.99 }
] )

次の操作では、 $matchパイプラインステージを使用して特定のドキュメントを検索し、 $replaceWithパイプラインステージと$setField演算子を使用して一致するドキュメントの"price.usd"フィールドをアップデートします。

db.inventory.aggregate( [
   { $match: { _id: 1 } },
   { $replaceWith: {
        $setField: {
           field: "price.usd",
           input: "$$ROOT",
           value: 49.99
    } } }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300, 'price.usd': 49.99 }
]

ドル記号（`$` ）で始まるフィールドを更新

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany([
   { _id: 1, item: 'sweatshirt', qty: 300, '$price': 45.99 },
   { _id: 2, item: 'winter coat', qty: 200, '$price': 499.99 },
   { _id: 3, item: 'sun dress', qty: 250, '$price': 199.99 },
   { _id: 4, item: 'leather boots', qty: 300, '$price': 249.99 },
   { _id: 5, item: 'bow tie', qty: 180, '$price': 9.99 }
] )

次の操作では、 $matchパイプラインステージを使用して特定のドキュメントを検索し、 $replaceWithパイプラインステージと$setField } 演算子と$literal演算子を使用して一致するドキュメントの"$price"フィールドをアップデートします。

db.inventory.aggregate( [
   { $match: { _id: 1 } },
   { $replaceWith: {
        $setField: {
           field: { $literal: "$price" },
           input: "$$ROOT",
           value: 49.99
   } } }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300, '$price': 49.99 }
]

ピリオドを含むフィールドを排除しました（`.` ）

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany([
   { _id: 1, item: 'sweatshirt', qty: 300, 'price.usd': 45.99 },
   { _id: 2, item: 'winter coat', qty: 200, 'price.usd': 499.99 },
   { _id: 3, item: 'sun dress', qty: 250, 'price.usd': 199.99 },
   { _id: 4, item: 'leather boots', qty: 300, 'price.usd': 249.99 },
   { _id: 5, item: 'bow tie', qty: 180, 'price.usd': 9.99 }
] )

次の操作では、 $replaceWithパイプラインステージと$setField演算子と$$REMOVEを使用して、各ドキュメントから"price.usd"フィールドを削除します。

db.inventory.aggregate( [
   { $replaceWith:  {
        $setField: {
           field: "price.usd",
           input: "$$ROOT",
           value: "$$REMOVE"
   } } }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300 },
  { _id: 2, item: 'winter coat', qty: 200 },
  { _id: 3, item: 'sun dress', qty: 250 },
  { _id: 4, item: 'leather boots', qty: 300 },
  { _id: 5, item: 'bow tie', qty: 180 }
]

$unsetFieldエイリアスを使用して記述された同様のクエリでは、同じ結果が返されます。

db.inventory.aggregate( [
   { $replaceWith:  {
        $unsetField: {
           field: "price.usd",
           input: "$$ROOT"
   } } }
] )

ドル記号（`$` ）で始まるフィールドを削除する

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany( [
   { _id: 1, item: 'sweatshirt', qty: 300, '$price': 45.99 },
   { _id: 2, item: 'winter coat', qty: 200, '$price': 499.99 },
   { _id: 3, item: 'sun dress', qty: 250, '$price': 199.99 },
   { _id: 4, item: 'leather boots', qty: 300, '$price': 249.99 },
   { _id: 5, item: 'bow tie', qty: 180, '$price': 9.99 }
} )

次の操作では、 $replaceWithパイプラインステージ、 $setField } 演算子と$literal演算子、および$$REMOVEを使用して、各ドキュメントから"$price"フィールドを削除します。

db.inventory.aggregate( [
   { $replaceWith: {
        $setField: {
           field: { $literal: "$price" },
           input: "$$ROOT",
           value: "$$REMOVE"
   } } }
] )

この操作は次の結果を返します。

[
  { _id: 1, item: 'sweatshirt', qty: 300 },
  { _id: 2, item: 'winter coat', qty: 200 },
  { _id: 3, item: 'sun dress', qty: 250 },
  { _id: 4, item: 'leather boots', qty: 300 },
  { _id: 5, item: 'bow tie', qty: 180 }
]

$unsetFieldエイリアスを使用して記述された同様のクエリでは、同じ結果が返されます。

db.inventory.aggregate( [
  { $replaceWith: {
       $unsetField: {
          field: { $literal: "$price" },
          input: "$$ROOT"
  } } }
] )

Tip

$unsetField

戻る

$setEquals

$setIntersection

定義

Tip

構文

動作

Tip

例

ピリオドを含むフィールドを追加しました（. ）

ドル記号（$ ）で始まるフィールドを追加する

ピリオドを含むフィールドを更新する（. ）

ドル記号（$ ）で始まるフィールドを更新

ピリオドを含むフィールドを排除しました（. ）

ドル記号（$ ）で始まるフィールドを削除する

Tip

ピリオドを含むフィールドを追加しました（`.` ）

ドル記号（`$` ）で始まるフィールドを追加する

ピリオドを含むフィールドを更新する（`.` ）

ドル記号（`$` ）で始まるフィールドを更新

ピリオドを含むフィールドを排除しました（`.` ）

ドル記号（`$` ）で始まるフィールドを削除する