db.collection.find()

オープン インタラクティブ チュートリアル

埋め込みフィールド仕様

埋め込みドキュメント内のフィールドの場合は、次のいずれかを使用してフィールドを指定できます。

• ドット表記の場合は次のようになります。 "field.nestedfield": <value>

• ネストされた形式の例 { field: { nestedfield: <value> } }

_id フィールドプロジェクション

_id フィールドは、プロジェクションで _id: 0 を明示的に指定して抑制しない限り、返されるドキュメントにデフォルトで含まれます。

包含または除外

projection には、 _id フィールドを除いて、包含指定と除外指定の両方を含めることはできません。

• フィールドを明示的に含めるプロジェクションでは、_id フィールドだけが明示的に除外できる唯一のフィールドです。

• フィールドを明示的に除外するプロジェクションでは、_id フィールドが明示的に包含できる唯一のフィールドですが、デフォルトで _id フィールドが含まれます。

「プロジェクションの例 」を参照してください。

セッション アイドル タイムアウト

MongoDB ドライバーとmongosh では、確認されていない書込み操作を除くすべての操作がサーバー セッションに関連付けられます。セッションに明示的に関連付けられていない操作（つまり Mongo.startSession()を使用するもの）の場合、MongoDB ドライバーとmongoshによって暗黙的なセッションが作成され、それが操作に関連付けられます。

セッションが30分以上アイドル状態になると、MongoDBサーバーはそのセッションを期限切れとしてマークし、いつでも閉じる可能性があります。MongoDB サーバーでセッションが閉じると、そのセッションで進行中の操作や開いているカーソルもすべて終了します。これには、noCursorTimeout() や 30 分を超える maxTimeMS() で構成されたカーソルも含まれます。

30 分以上アイドル状態になる可能性がある操作の場合は、 Mongo.startSession() を使用して操作を明示的なセッションに関連付け、refreshSessions コマンドを使用して定期的にセッションを更新してください。詳細については、「セッションアイドルタイムアウト」を参照してください。

等価を検索するクエリ

• 次の操作は、bios コレクション内の_id が 5 に等しいドキュメントを返します。

  db.bios.find( { _id: 5 } )

• 次の操作は、埋め込みドキュメント name 内のフィールド last が "Hopper" に等しい bios コレクション内のドキュメントを返します。

  db.bios.find( { "name.last": "Hopper" } )

  注意

  埋め込みドキュメントのフィールドにアクセスするには、ドット表記（"<embedded document>.<field>"）を使用します。

演算子を使用したクエリ

選択基準のセットに一致するドキュメントを検索するには、<criteria> パラメーターを指定して find() を呼び出します。

MongoDB は、条件を指定するためのさまざまなクエリ演算子を提供します。

• 次の操作では、 $in 演算子を使用して、 _id が 5 または ObjectId("507c35dd8fada716c89d0013") に等しい bios コレクション内のドキュメントを返します。

  db.bios.find(
     { _id: { $in: [ 5, ObjectId("507c35dd8fada716c89d0013") ] } }
  )

• 次の操作では、$gt 演算子を使用して、 birth が new Date('1950-01-01') より大きい bios コレクションのすべてのドキュメントを返します。

  db.bios.find( { birth: { $gt: new Date('1950-01-01') } } )

• 次の操作では、$regex 演算子を使用して、 name.last フィールドが文字 N で始まる（または"LIKE N%"である）bios コレクション内のドキュメントを返します。

  db.bios.find(
     { "name.last": { $regex: /^N/ } }
  )

クエリ演算子のリストについては、「クエリ セレクター」を参照してください。

範囲のクエリ

比較演算子を組み合わせて、フィールドの範囲を指定します。次の操作は、bios コレクションから、birth が new Date('1940-01-01') と new Date('1960-01-01') の間（排他的）にあるドキュメントを返します。

db.bios.find( { birth: { $gt: new Date('1940-01-01'), $lt: new Date('1960-01-01') } } )

クエリ演算子のリストについては、「クエリ セレクター」を参照してください。

複数条件のクエリ

次の操作は、bios コレクション から birth フィールドがgreater thannew Date('1950-01-01') であり、death フィールドが存在しないすべてのドキュメントを返します。

db.bios.find( {
   birth: { $gt: new Date('1920-01-01') },
   death: { $exists: false }
} )

クエリ演算子のリストについては、「クエリ セレクター」を参照してください。

埋め込みドキュメントに対する完全一致のクエリ

次の操作は、 bios コレクション内で埋め込みドキュメント name が { first: "Yukihiro", last: "Matsumoto" } と順序も含めて完全に一致するドキュメントを返します。

db.bios.find(
    { name: { first: "Yukihiro", last: "Matsumoto" } }
)

name フィールドは埋め込みドキュメントと完全に一致する必要があります。このクエリでは、次の name フィールドを持つドキュメントには一致しません。

{
   first: "Yukihiro",
   aka: "Matz",
   last: "Matsumoto"
}
{
   last: "Matsumoto",
   first: "Yukihiro"
}

埋め込みドキュメントのクエリ フィールド

次の操作は、埋め込みドキュメント name に値 "Yukihiro" を持つフィールド first 、および値 "Matsumoto" を持つフィールド last が含まれる bios コレクション内のドキュメントを返します。このクエリは、ドット表記を使用して埋め込みドキュメントのフィールドにアクセスします。

db.bios.find(
   {
     "name.first": "Yukihiro",
     "name.last": "Matsumoto"
   }
)

このクエリは、name フィールドが、フィールド first に値 "Yukihiro" を、フィールド last に値 "Matsumoto" を含む埋め込みドキュメントを持つドキュメントに一致します。たとえば、このクエリは、次のいずれかの値を持つ name フィールドを含むドキュメントと一致します。

{
  first: "Yukihiro",
  aka: "Matz",
  last: "Matsumoto"
}
{
  last: "Matsumoto",
  first: "Yukihiro"
}

詳細と例については、「埋め込みおよびネストされたドキュメントに対するクエリ」も参照してください。

配列要素のクエリ

次の例では、bios コレクション内のcontribs 配列に対してクエリを実行します。

• 次の操作は、配列フィールド contribs に要素 "UNIX" が含まれる bios コレクション内のドキュメントを返します。

  db.bios.find( { contribs: "UNIX" } )

• 次の操作は、配列フィールドcontribs に要素"ALGOL" または "Lisp" が含まれる bios コレクション内のドキュメントを返します。

  db.bios.find( { contribs: { $in: [ "ALGOL", "Lisp" ]} } )

• 次の操作では、$all クエリ演算子を使用して、配列フィールド contribs に要素 "ALGOL" と"Lisp" の両方が含まれる bios コレクション内のドキュメントを返します。

  db.bios.find( { contribs: { $all: [ "ALGOL", "Lisp" ] } } )

  その他の例については、「 $all」を参照してください。「$elemMatch」も参照してください。

• 次の操作では、$size 演算子を使用して、 contribs の配列サイズが 4 である bios コレクション 内のドキュメントを返します。

  db.bios.find( { contribs: { $size: 4 } } )

配列のクエリについての詳細と例については、次を参照してください。

• 配列のクエリ

• 埋め込みドキュメントの配列のクエリ

配列固有のクエリ演算子のリストについては、「配列」を参照してください。

ドキュメントの配列のクエリ

次の例では、bios コレクション内のawards 配列に対してクエリを実行します。

• 次の操作は、awards 配列にフィールド award の値が"Turing Award" に等しい要素を含む bios コレクション内のドキュメントを返します。

  db.bios.find(
     { "awards.award": "Turing Award" }
  )

• 次の操作は、awards 配列において award フィールドが"Turing Award" に等しく、かつ year フィールドが 1980 より大きい要素が少なくとも 1 つ含まれる bios コレクション内のドキュメントを返します。

  db.bios.find(
     { awards: { $elemMatch: { award: "Turing Award", year: { $gt: 1980 } } } }
  )

  配列要素に複数の条件を指定するには、$elemMatch 演算子を使用します。

配列のクエリについての詳細と例については、次を参照してください。

• 配列のクエリ

• 埋め込みドキュメントの配列のクエリ

配列固有のクエリ演算子のリストについては、「配列」を参照してください。

返却するフィールドの指定

次の操作は、bios コレクション内のすべてのドキュメントを検索し、 name フィールド、 contribs フィールド、および _id フィールドのみを返します。

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

明示的に除外されたフィールド

次の操作は、bios コレクションを検索し、 name 埋め込みドキュメント内の first フィールド、および birth フィールドを除くすべてのフィールドを返します。

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

フィールドの明示的除外_id

次の操作は、bios コレクション内のドキュメントを検索し、name フィールドと contribs フィールドのみを返します。

db.bios.find(
   { },
   { name: 1, contribs: 1, _id: 0 }
)

配列と埋め込みドキュメントについて

次の操作は、bios コレクション を検索し、name 埋め込みドキュメントの last フィールドと contribs 配列の最初の 2 つの要素を返します。

db.bios.find(
   { },
   { _id: 0, 'name.last': 1, contribs: { $slice: 2 } } )

ネストされたフォームを使用して埋め込みフィールドを指定することもできます。以下がその例です。

db.bios.find(
   { },
   { _id: 0, name: { last: 1 }, contribs: { $slice: 2 } }
)

集計式の使用

db.collection.find() のプロジェクションでは集計式と構文を受け付けます。

集計式と構文を使用して、新しいフィールドをプロジェクションしたり、既存のフィールドを新しい値でプロジェクションしたりできます。たとえば、次の操作では、集計式を使用して、name フィールドと awards フィールドの値を上書きし、さらに新しいフィールド reportDate、 reportBy、および reportNumber を含めます。

db.bios.find(
   { },
   {
     _id: 0,
     name: {
        $concat: [
           { $ifNull: [ "$name.aka", "$name.first" ] },
           " ",
           "$name.last"
        ]
     },
     birth: 1,
     contribs: 1,
     awards: { $cond: { if: { $isArray: "$awards" }, then: { $size: "$awards" }, else: 0 } },
     reportDate: { $dateToString: {  date: new Date(), format: "%Y-%m-%d" } },
     reportBy: "hellouser123",
     reportNumber: { $literal: 1 }
   }
)

reportRun フィールドに値 1 を設定します。この操作では、次のドキュメントが返されます。

{ "birth" : ISODate("1924-12-03T05:00:00Z"), "contribs" : [ "Fortran", "ALGOL", "Backus-Naur Form", "FP" ], "name" : "John Backus", "awards" : 4, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1927-09-04T04:00:00Z"), "contribs" : [ "Lisp", "Artificial Intelligence", "ALGOL" ], "name" : "John McCarthy", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1906-12-09T05:00:00Z"), "contribs" : [ "UNIVAC", "compiler", "FLOW-MATIC", "COBOL" ], "name" : "Grace Hopper", "awards" : 4, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1926-08-27T04:00:00Z"), "contribs" : [ "OOP", "Simula" ], "name" : "Kristen Nygaard", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1931-10-12T04:00:00Z"), "contribs" : [ "OOP", "Simula" ], "name" : "Ole-Johan Dahl", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1956-01-31T05:00:00Z"), "contribs" : [ "Python" ], "name" : "Guido van Rossum", "awards" : 2, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1941-09-09T04:00:00Z"), "contribs" : [ "UNIX", "C" ], "name" : "Dennis Ritchie", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1965-04-14T04:00:00Z"), "contribs" : [ "Ruby" ], "name" : "Matz Matsumoto", "awards" : 1, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1955-05-19T04:00:00Z"), "contribs" : [ "Java" ], "name" : "James Gosling", "awards" : 2, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "contribs" : [ "Scala" ], "name" : "Martin Odersky", "awards" : 0, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }

変数名付き

次の例では、変数 myCursor を使用してカーソルを反復処理し、一致するドキュメントを出力します。

var myCursor = db.bios.find( );
myCursor

next()メソッドの場合

次の例では、カーソル メソッド next() を使用してドキュメントにアクセスします。

var myCursor = db.bios.find( );
var myDocument = myCursor.hasNext() ? myCursor.next() : null;
if (myDocument) {
    var myName = myDocument.name;
    print (tojson(myName));
}

出力するには、 print(tojson()) の代わりに printjson() メソッドを使用することもできます。

if (myDocument) {
   var myName = myDocument.name;
   printjson(myName);
}

forEach()メソッドの場合

次の例では、カーソルメソッド forEach() を使用してカーソルを反復処理し、ドキュメントにアクセスします。

var myCursor = db.bios.find( );
myCursor.forEach(printjson);

結果セット内のドキュメントの順序付け

sort() メソッドは結果セット内のドキュメントを順序付けします。次の操作は、nameフィールドで昇順にソートされたbios コレクション内のドキュメントを返します。

db.bios.find().sort( { name: 1 } )

sort() は、SQL のORDER BY ステートメントに対応します。

返すドキュメントの数の制限

limit() メソッドは、結果セット内のドキュメントの数を制限します。次の操作は、bios コレクション内の最大 5 個のドキュメントを返します。

db.bios.find().limit( 5 )

limit() は、SQL のLIMIT ステートメントに対応します。

結果セットの開始点の設定

skip() メソッドは結果セットの開始点を制御します。次の操作は、bios コレクションの最初の 5 個のドキュメントをスキップし、残りのすべてのドキュメントを返します。

db.bios.find().skip( 5 )

照合の指定

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

collation() メソッドによって db.collection.find() 操作の照合を指定します。

db.bios.find( { "name.last": "hopper" } ).collation( { locale: "en_US", strength: 1 } )

カーソル メソッドの組み合わせ

次のステートメントは、カーソル メソッド limit() と sort() を連結します。

db.bios.find().sort( { name: 1 } ).limit( 5 )
db.bios.find().limit( 5 ).sort( { name: 1 } )

2 つのステートメントは同等です。limit() メソッドと sort() メソッドを連結する順序は重要ではありません。どちらのステートメントも、「name」で昇順ソートした最初の 5 つのドキュメントを返します。

利用可能なmongosh カーソル メソッド

limit を含むオプション

次のクエリは、limit オプション パラメーターを使用して結果セット内のドキュメントの数を制限します。

db.users.find(
   { username : "rajiv"}, // query
   { age : 1 }, // projection
   { limit : 1 } // options
)

allowDiskUse を含むオプション

次のクエリは、options パラメーターを使用して allowDiskUse を有効にします。

db.users.find(
   { username : "david" },
   { age : 1 },
   { allowDiskUse : true }
)

explain を含むオプション

次のクエリでは、 optionsパラメータを使用してexecutionStats explain の出力が取得されます。

var cursor = db.users.find(
   { username: "amanda" },
   { age : 1 },
   { explain : "executionStats" }
)
cursor.next()

クエリで複数のオプションを指定する

次のクエリでは、1 つのクエリで複数のoptionsを使用します。 このクエリでは、 limitを2に設定すると 2 つのドキュメントのみが返され、 showRecordIdがtrueに設定されている場合は結果セット内のドキュメントの位置を返します。

db.users.find(
   {},
   { username: 1, age: 1 },
   {
     limit: 2,
     showRecordId: true
   }
)