MongoDBでObjectIdを文字列に変換する方法｜$toString演算子の使い方

MongoDBでObjectIdを文字列に変換するには

MongoDBでは、集計パイプライン（aggregate）の中で $toString 演算子を使用することで、ObjectIdを文字列値に変換できます。ここでは、実際にサンプルコレクションを作成し、ObjectIdを文字列へ変換する手順を順番に見ていきましょう。

1. サンプルコレクションを作成する

まずは、変換動作を確認するためのコレクションとドキュメントを作成します。insertOne()メソッドを使って複数のドキュメントを挿入します。

> db.objectidToStringDemo.insertOne({"UserName":"John"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c92b80036de59bd9de0639d")
}
> db.objectidToStringDemo.insertOne({"UserName":"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c92b80436de59bd9de0639e")
}
> db.objectidToStringDemo.insertOne({"UserName":"Larry"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c92b80936de59bd9de0639f")
}
> db.objectidToStringDemo.insertOne({"UserName":"Robert"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c92b81836de59bd9de063a0")
}

挿入が完了すると、各ドキュメントの _id フィールドに自動的に ObjectId が割り当てられていることがわかります。

2. find()でドキュメントを確認する

find()メソッドを使えば、コレクション内のすべてのドキュメントを表示できます。

> db.objectidToStringDemo.find().pretty();

実行結果は以下の通りです。

{ "_id" : ObjectId("5c92b80036de59bd9de0639d"), "UserName" : "John" }
{ "_id" : ObjectId("5c92b80436de59bd9de0639e"), "UserName" : "Chris" }
{ "_id" : ObjectId("5c92b80936de59bd9de0639f"), "UserName" : "Larry" }
{ "_id" : ObjectId("5c92b81836de59bd9de063a0"), "UserName" : "Robert" }

このように、現時点では _id が ObjectId 型として保存されていることが確認できます。

3. aggregateの$toStringでObjectIdを文字列に変換する

それでは本題の、ObjectIdを文字列値へ変換するクエリを見ていきましょう。aggregateの $project ステージ内で、$toString を $_id に適用します。

> db.objectidToStringDemo.aggregate([
    {
       $project: {
          _id: {
             $toString: "$_id"
          }
       }
    }
]
);

実行結果は以下の通りです。

{ "_id" : "5c92b80036de59bd9de0639d" }
{ "_id" : "5c92b80436de59bd9de0639e" }
{ "_id" : "5c92b80936de59bd9de0639f" }
{ "_id" : "5c92b81836de59bd9de063a0" }

_id が「ObjectId("...")」という形式から、引用符で囲まれた単純な文字列型に変換されていることが確認できます。

まとめ

• ObjectIdを文字列に変換するには、aggregateパイプライン内で $toString を使います。
• $project ステージと組み合わせることで、_id のみを出力用に文字列化できます。
• $toString は MongoDB 4.0 以降で利用可能な演算子です。
• API連携やJSONレスポンスの生成など、ObjectIdをそのまま扱えない場面で特に役立ちます。