でのカーソルの反復 mongosh

カーソルの手動反復処理

mongosh では、 find() メソッドから返されたカーソルを var キーワードを使用して変数に割り当てると、カーソルは自動的に反復されません。

以下の例のように、shell で cursor 変数を呼び出して、最大 20 回繰り返し [1]、一致するドキュメントを出力できます。

var myCursor = db.users.find( { type: 2 } );
myCursor

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

var myCursor = db.users.find( { type: 2 } );
while (myCursor.hasNext()) {
   print(tojson(myCursor.next()));
}

代わりの出力操作として、printjson() ヘルパー メソッドを使用して print(tojson()) を置き換えることを検討してください。

var myCursor = db.users.find( { type: 2 } );
while (myCursor.hasNext()) {
   printjson(myCursor.next());
}

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

var myCursor =  db.users.find( { type: 2 } );
myCursor.forEach(printjson);

カーソル メソッドの詳細については、「 JavaScript カーソル メソッド」およびドライバーのドキュメントを参照してください。

イテレータ インデックス

mongosh では、次のように toArray() メソッドを使用してカーソルを反復処理し、ドキュメントを配列で返すことができます。

var myCursor = db.inventory.find( { type: 2 } );
var documentArray = myCursor.toArray();
var myDocument = documentArray[3];

toArray() メソッドは、カーソルによって返されたすべてのドキュメントを RAM にロードします。そのため、toArray() メソッドはカーソルを使い果たします。

さらに、一部のドライバーでは、カーソルのインデックス（つまり、cursor[index]）を使用してドキュメントにアクセスできます。これは、最初に toArray() メソッドを呼び出し、次に結果の配列のインデックスを使用するショートカットです。

次の例で考えてみます。

var myCursor = db.users.find( { type: 2 } );
var myDocument = myCursor[1];

myCursor[1] は次の例と同等です。

myCursor.toArray() [1];

カーソルの動作

var myCursor = db.users.find().noCursorTimeout();

var myCursor = db.inventory.find();
var myFirstDocument = myCursor.hasNext() ? myCursor.next() : null;
myCursor.objsLeftInBatch();

カーソル情報

db.serverStatus() メソッドは、以下の metrics フィールドを含むドキュメントを返します。metrics フィールドには、次の情報を含む metrics.cursor フィールドが含まれています。

• 前回のサーバー再起動以降にタイムアウトしたカーソルの数

• 非アクティブな期間が一定期間続いてもタイムアウトしないよう DBQuery.Option.noTimeout オプションで設定されたオープンカーソルの数

• 「ピン留めされた」オープン カーソルの数

• オープン カーソルの合計数

db.serverStatus() メソッドを呼び出して、結果から metrics フィールドにアクセスし、その metrics フィールドから cursor フィールドにアクセスする次の例を検討してみましょう。

db.serverStatus().metrics.cursor

次のドキュメントは、その結果です。

{
   "timedOut" : <number>
   "open" : {
      "noTimeout" : <number>,
      "pinned" : <number>,
      "total" : <number>
   }
}