$unsetField(集計)
定義
$unsetField
バージョン 5.0 で追加
ドキュメント内の指定したフィールドを削除します。
$unsetField
を使用すると、名前にピリオド(.
)が含まれる名前付きフィールド、またはドル記号($
)で始まる名前付きフィールドを削除できます。$unsetField
は、$$REMOVE
を使用してフィールドを削除する$setField
のエイリアスです。
構文
$unsetField
の構文は次のとおりです。
{ $unsetField: { field: <String>, input: <Object>, } }
次のフィールドを提供する必要があります。
動作
input
がmissing
、undefined
、またはnull
と評価された場合、$unsetField
はnull
を返し、input
を更新しません。input
がオブジェクト以外のオブジェクト(missing
、undefined
、またはnull
)以外と評価された場合、$unsetField
はエラーを返します。field
が string 定数以外に解決される場合、$unsetField
はエラーを返します。$unsetField
はオブジェクトまたは配列を暗黙的にトラバースすることはありません。 たとえば、$unsetField
は、"a.b.c"
のfield
値を、ネストされたフィールド{ "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 } } ]