MongoDBでドキュメント内の特殊文字を含む文字列を検索する方法

MongoDBのドキュメント内に保存された、$などの特殊文字を含む文字列を検索したい場合があります。そのようなときは、正規表現を使い、特殊文字の直前にバックスラッシュ（\）を付けてエスケープすることで、意図した通りの検索が可能になります。

この記事では、実際にコレクションを作成し、特殊文字「$」を含む文字列を検索する手順を具体例とともに解説します。

サンプルコレクションの作成

まず、以下のクエリを実行して、特殊文字を含むデータを持つコレクションを作成します。ここでは「UserId」フィールドに「$」を含む文字列を挿入しています。

> db.searchDocumentWithSpecialCharactersDemo.insertOne({"UserId":"Smith$John123","UserFirstName":"John","UserLastName":"Smith"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c987b98330fd0aa0d2fe4b1")
}
> db.searchDocumentWithSpecialCharactersDemo.insertOne({"UserId":"Taylor$Carol983","UserFirstName":"Carol","UserLastName":"Taylor"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c987bdb330fd0aa0d2fe4b2")
}
> db.searchDocumentWithSpecialCharactersDemo.insertOne({"UserId":"Doe$John999","UserFirstName":"John","UserLastName":"Doe"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c987bee330fd0aa0d2fe4b3")
}
> db.searchDocumentWithSpecialCharactersDemo.insertOne({"UserId":"Miller$David555","UserFirstName":"David","UserLastName":"Miller"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5c987c01330fd0aa0d2fe4b4")
}

登録済みドキュメントの確認

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

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

実行すると、次のような出力が得られます。

{
   "_id" : ObjectId("5c987b98330fd0aa0d2fe4b1"),
   "UserId" : "Smith$John123",
   "UserFirstName" : "John",
   "UserLastName" : "Smith"
}
{
   "_id" : ObjectId("5c987bdb330fd0aa0d2fe4b2"),
   "UserId" : "Taylor$Carol983",
   "UserFirstName" : "Carol",
   "UserLastName" : "Taylor"
}
{
   "_id" : ObjectId("5c987bee330fd0aa0d2fe4b3"),
   "UserId" : "Doe$John999",
   "UserFirstName" : "John",
   "UserLastName" : "Doe"
}
{
   "_id" : ObjectId("5c987c01330fd0aa0d2fe4b4"),
   "UserId" : "Miller$David555",
   "UserFirstName" : "David",
   "UserLastName" : "Miller"
}

特殊文字を含む文字列の検索クエリ

それでは、特殊文字「$」を含む文字列を検索してみましょう。ここでは、「$」の後に続く「John」という文字列を検索対象とします。

ポイントは、正規表現の中で「$」をそのまま書くと「行末」を意味するメタ文字として解釈されてしまうため、直前にバックスラッシュを付けて\$のようにエスケープする点です。

> db.searchDocumentWithSpecialCharactersDemo.find({ UserId : /.*\$John.*/i }).pretty();

検索結果

上記のクエリを実行すると、「$John」というパターンを含むドキュメントのみが抽出されます。

{
   "_id" : ObjectId("5c987b98330fd0aa0d2fe4b1"),
   "UserId" : "Smith$John123",
   "UserFirstName" : "John",
   "UserLastName" : "Smith"
}
{
   "_id" : ObjectId("5c987bee330fd0aa0d2fe4b3"),
   "UserId" : "Doe$John999",
   "UserFirstName" : "John",
   "UserLastName" : "Doe"
}

正規表現パターンの解説

使用した正規表現/.*\$John.*/iの各要素は、次のような意味を持ちます。

• .*：任意の文字が0回以上繰り返されることを表します（前後の文字列にマッチ）。
• \$：特殊文字「$」をエスケープし、文字としての「$」にマッチさせます。
• i：大文字・小文字を区別しないフラグです。「john」「JOHN」などにもマッチします。

このように、MongoDBでは正規表現とエスケープ処理を組み合わせることで、$や.、*などの特殊文字を含む文字列も柔軟に検索できます。なお、アプリケーションから動的に検索条件を組み立てる場合は、ユーザー入力値に含まれる特殊文字を必ずエスケープするよう注意してください。