$toObjectId (ObjectId への変換)

最終更新：2026-10-09

$toObjectId (ObjectId への変換)

$toObjectId は 24 文字の 16 進文字列を ObjectId に変換します。結合で最もよく使われる変換です。代表的な用途は、CSV や API からインポートした文字列 ID を $lookup 用の ObjectId にキャストしたり、$match 内で文字列の _id を ObjectId と比較したりすることです。文字列は有効な ObjectId リテラルである必要があり、違うと変換はエラーになります。null は null のままです。無効な入力をガードするには onError 付きの $convert を優先してください。

📝 構文

{ $toObjectId: <expression> }

⚙️ パラメータ

戻り値：ObjectId。入力が null の場合は null

▶ 例

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

// $toObjectId: 結合用に文字列 ID をキャスト
db.orders.aggregate([
  { $project: {
      uid: { $toObjectId: '$userIdStr' }
  } }
])

出力：

{ '_id': 1, 'uid': { '$oid': '64b7f1c2e4b0a1b2c3d4e5f6' } }

📌 注意事項

• 文字列は 24 文字の 16 進でなければならない。それ以外はエラー
• null は null のまま
• $lookup では両側の型を揃える必要がある。結合前に変換する

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて