db.collection.findOne()

定義

db.collection.findOne(query, projection, options)

重要

mongosh メソッド

このページでは、mongosh メソッドについて説明します。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

データベースコマンドについては、 findコマンドを参照してください。

MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。

コレクションまたはビューで指定されたクエリ条件を満たす 1 つのドキュメントを返します。

返されるドキュメントは、クエリ条件に一致するドキュメントの数と、使用するクエリプランによって異なる場合があります。

一致するドキュメントの数	クエリプラン	結果
0	Any	このメソッドが返すのは null
1	Any	メソッドは、指定されたクエリ条件を満たすドキュメントを返します。
2以上	コレクションスキャン	このメソッドは、自然な順序に従って最初のドキュメントを返します。上限付きコレクションにおける自然な順序は、挿入順序と同じです。
2以上	インデックス スキャン	このメソッドは、インデックスから検索された最初のドキュメントを返します。

重要

クエリプランが別のインデックスを使用するように変更された場合、このメソッドは別のドキュメントを返すことがあります。ユースケースで特定のレコードを一貫して選択する必要がある場合は、options ドキュメントを使用してソートを指定する必要があります。options ドキュメントで findOne() を使用する方法の詳細については、例を参照してください。

projection パラメーターを指定すると、findOne() は projection フィールドのみを含むドキュメントを返します。_id フィールドは明示的に除外されない限り、常に含まれます。

注意

find()メソッドと似ていますが、 findOne()メソッドはカーソルではなくドキュメントを返します。

互換性

次の環境でホストされる配置には db.collection.findOne() を使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

findOne() メソッドの形式は次のとおりです。

db.collection.findOne( <query>, <projection>, <options> )

findOne() メソッドは次のパラメーターを取ります。

動作

{ field1: <value>, field2: <value> ... }

例

db.bios.findOne()

db.bios.findOne(
   {
     $or: [
            { 'name.first' : /^G/ },
            { birth: { $lt: new Date('01/01/1945') } }
          ]
   }
)

db.bios.findOne(
    { },
    { name: 1, contribs: 1 }
)

db.bios.findOne(
   { contribs: 'OOP' },
   { _id: 0, 'name.first': 0, birth: 0 }
)

db.bios.findOne(
   { },
   { },
   { sort: { birth: 1 } }
)

var myDocument = db.bios.findOne();
if (myDocument) {
   var myName = myDocument.name;
   print (tojson(myName));
}

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

db.cakeFlavors.findOne(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { _id: 0 },
   { let : { targetFlavor: "chocolate" }
} )

{ flavor: 'chocolate' }