db.コレクション.findOne()（mongoshメソッド）

定義

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

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

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

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

重要

If the query plan changes to use a different index, the method may return a different document. If your use case requires that a particular record is chosen consistently, you must use the options document to specify a sort. For details on using findOne() with an options document, see the example.

If you specify a projection parameter, findOne() returns a document that only contains the projection fields. The _id field is always included unless you explicitly exclude it.

注意

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

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

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

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

構文

db.collection.findOne() の形式は次のとおりです。

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

db.collection.findOne() は以下のパラメーターを取ります。

動作

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

例

このページの例では、sample_mflix データセット のデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

db.movies.findOne()

db.movies.findOne(
   {
      $or: [
            { title: /^T/ },
            { year: { $lt: 1950 } }
            ]
   }
)

db.movies.findOne(
   { },
   { title: 1, genres: 1, imdb: 1 }
)

db.movies.findOne(
   { cast: 'Al Pacino' },
   { _id: 0, 'imdb.votes': 0, fullplot: 0 }
)

db.movies.findOne(
   { },
   { },
   { sort: { year: 1 } }
)

var myDocument = db.movies.findOne();
if (myDocument) {
   var myTitle = myDocument.title;
   print(myTitle);
}

db.movies.findOne(
   { $expr: { $eq: [ "$title", "$$targetTitle" ] } },
   { _id: 0, title: 1, year: 1 },
   { let : { targetTitle: "The Godfather" } }
)

{ year: 1972, title: 'The Godfather' }