MongoDBのフィールド名で使用できない文字は？ドル記号とピリオドの注意点を解説

MongoDBでは、フィールド名（ドキュメント内のキー名）に使用できない文字がいくつかあります。最も重要なのは以下の2つです。

• ドル記号（$）：フィールド名に含めることはできません。特に、フィールド名を$で始めることは禁止されています。
• ピリオド（.）：フィールド名の中に使用することはできません。

これらの文字は、MongoDB内部で特別な意味を持つため予約されており、フィールド名として利用するとエラーや予期しない動作の原因になります。

フィールド名として許可される文字の例

一方で、日本語や英語の文字、数字はもちろん、スペースを含んだフィールド名も問題なく使用できます。以下は「Employee Name」のようにスペース入りのフィールド名を使った例です。

> db.charactersAllowedDemo.insertOne({"Employee Name" : "John"});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c7fefbc8d10a061296a3c6d")
}

上記のクエリでは、スペースを含むフィールド名「Employee Name」を持つドキュメントが正常に挿入されていることがわかります。

挿入したドキュメントの確認方法

コレクション内のすべてのドキュメントを表示するには、find()メソッドを使用します。pretty()を組み合わせると、結果を見やすい形式で出力できます。

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

実行結果は次の通りです。

{
    "_id" : ObjectId("5c7fefbc8d10a061296a3c6d"),
    "Employee Name" : "John"
}

まとめ

MongoDBのフィールド名を設計する際は、「$」や「.」といった特殊文字の使用を避けることが基本です。これらの文字はMongoDBの内部的な構文（集計パイプライン演算子やパス表現など）で重要な役割を果たすためです。半角英数字、アンダースコア（_）、ハイフン（-）、さらにはスペースなどは自由に使用できるので、読みやすく一貫性のある命名規則を採用することをおすすめします。