$unset (フィールド削除)

最終更新：2026-10-09

$unset (フィールド削除)

$unset は、ドキュメントから指定したフィールドを削除します。`{ $unset: { age: '' } }` のように書きます — 値はプレースホルダで、通常は空文字列を指定します。ネストしたフィールドにはドット区切りのパスを使い、存在しないフィールドは黙って無視されます。配列要素に対して $unset を使うと要素は削除されず null に設定されます（削除には $pull を使います）。

📝 構文

{ $unset: { <field>: '' } }

⚙️ パラメータ

戻り値：更新結果

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $unset: age フィールドを削除
db.users.updateOne(
  { _id: 1 },
  { $unset: { age: '' } }
)

// ネストしたフィールドを削除
db.users.updateOne(
  { _id: 1 },
  { $unset: { 'address.city': '' } }
)

出力：

// ドキュメントから age と address.city フィールドが削除される

📌 注意事項

• 配列要素に対しては削除ではなく null が設定される
• $set と対になる: 一方は削除、もう一方は書き込み
• フィールドが存在しない場合は黙って無視される

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて