/ /

$unsetField（演算子）

定義

$unsetField

バージョン 5.0 の新機能。

ドキュメント内の指定したフィールドを削除します。

$unsetFieldを使用すると、名前にピリオド（）が含まれる名前付きフィールド、またはドル記号（. ）で始まる名前付きフィールドを削除できます。$

$unsetFieldは、$setField $$REMOVEを使用してフィールドを削除するのエイリアスです。

構文

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

{
   $unsetField: {
      field: <String>,
      input: <Object>,
   }
}

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

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

動作

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

例

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

インベントリコレクションを検討します。

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パイプラインステージと$unsetField "price.usd"演算子を使用して、各ドキュメントからフィールドを削除します。

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

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

[
  { _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 }
]

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

インベントリコレクションを検討します。

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演算子と演算子とともに$unsetField $literal"$price"パイプラインステージを使用して、各ドキュメントからフィールドを削除します。

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

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

[
  { _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 }
]

サブフィールドの削除

インベントリコレクションを検討します。

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

"price"フィールドには、2 つのサブフィールド"usd"と"euro"を持つドキュメントが含まれています。 "price.euro""euro"MongoDB"price.euro" は、ピリオド（. ）を含む最上位フィールド名としてを解析するため、を使用してを識別して削除することはできません。

とネストされた $replaceWith$setField$unsetField操作とともにパイプラインステージを使用して、フィールドを削除します。"euro"

db.inventory.aggregate( [
   { $replaceWith: {
        $setField: {
           field: "price",
           input: "$$ROOT",
           value: {
              $unsetField: {
                 field: "euro",
                 input: { $getField: "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 } }
]

詳細

$unsetField（演算子）

定義

構文

動作

例

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

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

サブフィールドの削除

詳細

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

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