db.collection.findOne()

クライアントの切断

MongoDB 4.2以降では、 db.collection.findOne()を発行したクライアントが操作の完了前に切断した場合、MongoDB は killOp を使用してdb.collection.findOne()を終了対象としてマークし 。

プロジェクション

projection パラメーターにより、一致するドキュメントで返されるフィールドが決定されます。projection パラメーターは以下の形式のドキュメントです。

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

空のクエリが指定されている場合

次の操作は、bios コレクションから単一ドキュメントを返します。

db.bios.findOne()

クエリが指定されている場合

次の操作は、埋め込まれたドキュメント name 内のフィールド first が文字 G で始まるか、または フィールド birth が new Date('01/01/1945') 未満である、bios コレクションから最初に一致するドキュメントを返します。

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

プロジェクションの使用

projection は返すフィールドを指定するパラメーターです。このパラメーターに含まれるのは、包含指定と除外指定のいずれかであり、除外指定の対象が _id フィールドでない限り、両方を指定することはできません。

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

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

オプション付き

次の操作では、sort オプションを使用して、ソートされた bios コレクションから最初に一致するドキュメントを返します。この例では、コレクションは birth の昇順でソートされています。

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

findOne 結果ドキュメント

単一ドキュメントが返されるため、カーソル メソッドは findOne() の結果に適用できません。次のとおり、ドキュメントに直接アクセスできます。

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

let オプションでの変数の使用

クエリオプションを指定してクエリの動作を変更することで、結果が返される方法を指定できます。

たとえば、 findOne メソッド内の他の場所からアクセスできる変数を定義するには、 let オプションを使用します。変数を使用して結果をフィルターするには、$expr 演算子内で変数にアクセスする必要があります。

コレクション cakeFlavors を以下ように作成します。

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

次の例では、let で targetFlavor 変数を定義し、その変数を使用してチョコレート ケーキの風味を検索します。

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

出力:

{ flavor: 'chocolate' }

利用可能なすべてのクエリ オプションを確認するには、「FindOptions」を参照してください。