このチュートリアルでは、カーソル内のドキュメントにアクセスする方法を説明します。
このタスクについて
カーソル内のドキュメントにアクセスするには、カーソルを手動で反復処理するか、toArray() メソッドを使用します。
このチュートリアルでは、次の方法について概説します。
letキーワードを使用してカーソルを変数として保存します。toArray()メソッドを使用して、カーソル ドキュメントを配列として返してアクセスします。
バッチ サイズ
カーソルはドキュメントをバッチ単位で返します。デフォルトでは、mongosh はカーソルの反復ごとに 20 個のドキュメントを表示します。これがニーズに合わせて多すぎるか少なすぎる場合は、config.set("displayBatchSize") を使用して変更できます。
始める前に
新しいコレクションにドキュメントを挿入します。
mongosh を使用して、デフォルトのtestデータベースを使用して新しいコレクションにドキュメントを挿入します。
db.users.insertMany( [ { _id: 0, type: "admin", email: "admin@example.com", name: "Admin User" }, { _id: 1, type: "user", email: "user1@example.com", name: "Test User 1" }, { _id: 2, type: "user", email: "user2@example.com", name: "Test User 2" } ] )
例
カーソルを保存するには、 let
mongosh では、カーソルをlet キーワードを使用して変数に代入する場合、自動的には繰り返し処理されません。
let myCursor = db.users.find( { type: "user" } )
shell でカーソル変数を呼び出して、一致するドキュメントを出力できます。
myCursor
返されたカーソルが let キーワードを使用して変数に割り当てられていない場合、カーソルはバッチ サイズまで自動的に繰り返し処理され、最初のバッチするの結果が出力されます。
db.users.find( { type: "user" } )
を使用してカーソル内のドキュメントにアクセスする next()
カーソル メソッド next() を使用してドキュメントにアクセスすることもできます。next() は、カーソルが現在指しているドキュメントを返し、カーソルを次のドキュメントに移動します。
let myCursor = db.users.find( { type: "user" } ) myCursor.next()
を使用してカーソル内のドキュメントにアクセスする hasNext()
カーソル メソッド hasNext() は true または false を返して、カーソルから返されるドキュメントが他にもあるかどうかを示します。
let myCursor = db.users.find( { type: "user" } ) myCursor.hasNext()
hasNext() メソッドと next() メソッドを使用して、printjson() ヘルパーを使い、カーソルから残りのすべてのドキュメントを印刷できます。
let myCursor = db.users.find( { type: "user" } ) while ( myCursor.hasNext() ) { printjson( myCursor.next() ) }
を使用してカーソル内のドキュメントにアクセスする forEach()
同様に、カーソル内の各ドキュメントに対して forEach() カーソル メソッドを使用し、printjson() などのヘルパーを適用することができます。
let myCursor = db.users.find( { type: "user" } ) myCursor.forEach( myDocument => printjson(myDocument) )
mongosh 2.1.0 から、また、for-of ループを使用してカーソルを反復処理することもできます。次の例では、前の例と同じ結果が返されます。
let myCursor = db.users.find( { type: "user" } ) for ( let myDocument of myCursor ) { printjson( myDocument ) }
カーソル メソッドの詳細については、「 JavaScript カーソル メソッド」およびドライバーのドキュメントを参照してください。
を使用してカーソル内のドキュメントにアクセスする toArray()
mongosh では、toArray() メソッドを使用してカーソルが反復処理され、ドキュメントが配列で返されます。
let myCursor = db.users.find( { type: "user" } ) let documentArray = myCursor.toArray() documentArray
結果のドキュメント配列には、従来の配列としてアクセスすることができます。
let myCursor = db.users.find( { type: "user" } ) let documentArray = myCursor.toArray() documentArray[1]
toArray() メソッドは、カーソルによって返されるすべてのドキュメントを RAM に読み込み、カーソルを使い切ります。
一部のドライバーでは、カーソルのインデックス（つまり、cursor[index]）を使用してドキュメントにアクセスできます。これは、最初に toArray() メソッドを呼び出し、次に結果の配列のインデックスを使用するショートカットです。
let myCursor = db.users.find( { type: "user" } ) myCursor.toArray() [1]