cursor.addOption()
定義
cursor.addOption(flag)
重要
mongosh メソッド
これは
mongosh
メソッドです。 これは、Node.js
またはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。ほとんどの場合、
mongosh
メソッドはレガシーのmongo
shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongosh
では利用できません。レガシー
mongo
shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。MongoDB API ドライバーについては、各言語のMongoDB ドライバードキュメント を参照してください。
以下に掲げるフラグを設定してクエリの動作を変更するために使用されます。
cursor.addOption()
メソッドには次のパラメーターがあります。Parameterタイプ説明flag
flag
Flags
mongosh
は、カーソルの動作を変更するための追加のカーソル フラグをいくつか提供します。
Flag | 説明 |
---|---|
最後のデータを受信してもカーソルを閉じないように設定し、初期結果が使い果たされた後に追加されたデータをクエリが引き続き返すことができるようにします。 | |
レプリカ スレーブのクエリを許可します。 | |
サーバーがアイドル カーソルをタイムアウトしないようにします。 | |
DBQuery.Option.tailable と併用します。 使用可能なデータがない場合にクエリ スレッドをブロックし、すぐにデータを返さずに設定された時間データを待機するようにカーソルを設定します。 カーソルは、タイムアウトが経過した場合にのみデータを返しません。 | |
結果をバッチで分割するのではなく、クエリによって返されたすべてのデータを一度に返すようにカーソルを設定します。 | |
エラーをスローするのではなく、一部のシャードが応答しないシャーディングされたクラスターに対するクエリから部分的なデータを返すようにカーソルを設定します。 |
例
次の例では、クエリが追尾可能 (tailable) カーソルを返すようにするために、 DBQuery.Option.tailable
フラグとDBQuery.Option.awaitData
フラグを追加します。 シーケンスはカーソルを作成します。 完全な結果セットが返された後、クエリ中に追加された追加データをキャプチャして返すことができるように、デフォルトの間隔である 1000 ミリ秒待機します。
var t = db.myCappedCollection; var cursor = t.find().addOption(DBQuery.Option.tailable). addOption(DBQuery.Option.awaitData)
警告
誤ったワイヤプロトコル フラグを追加すると、問題が発生したりサーバーに余計な負荷がかかる可能性があります。