cursor.tailable()

定義

cursor.tailable()

重要

mongosh メソッド

これはmongoshメソッドです。 これは、 Node.jsまたはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。

ほとんどの場合、 mongoshメソッドはレガシーの mongo shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongoshでは利用できません。

レガシーmongo shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。

• mongo shell v4.4

• mongo shell v4.2

• mongo shell v4.0

MongoDB API ドライバーについては、各言語のMongoDB ドライバードキュメント を参照してください。

クライアントがすべての結果を使い果たした場合でも、カーソルを開いたままにします。

Capped コレクションに対してのみ使用します。 Capped コレクション以外のコレクションに対してtailable()を使用すると、エラーが返されます。

cursor.tailable() は、次の構文を使用します。

cursor.tailable( { awaitData : <boolean> } )

~cursor.tailable() には、次のパラメーターがあります。

Parameter	タイプ	説明
awaitData	ブール値	任意。 DBQuery.Option.tailableと併用します。 使用可能なデータがない場合にクエリ スレッドをブロックし、すぐにデータを返さずに設定された時間データを待機するようにカーソルを設定します。 カーソルは、タイムアウトが経過した場合にのみデータを返しません。 デフォルトでは、カーソルを作成したコマンドにmaxTimeMSが設定されている場合、 awaitDataのタイムアウトは残りの時間になります。 それ以外の場合、デフォルトのタイムアウトは1000ミリ秒です。 awaitDataが有効になっているカーソルでgetMoreを実行するときにタイムアウトを設定できます。 デフォルトは false です。

次の値を返します。	~cursor.tailable()がアタッチされているカーソル。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

追尾可能 (tailable) カーソルは、 Cappedコレクションに対してコレクションスキャンを実行します。 コレクションの末尾に到達しても開いたままになります。 アプリケーションは、新しいデータがコレクションに挿入されたら、追尾可能 (tailable) カーソルを反復処理し続けることができます。

awaitDataがtrueの場合、カーソルが Capped コレクションの末尾に到達すると、 mongodはタイムアウト間隔だけクエリ スレッドをブロックし、新しいデータの受信を待機します。 新しいデータがCappedコレクションに挿入されると、 mongodはブロックされたスレッドを起動して次のバッチをクライアントに返すようにシグナルを送信します。

「追尾可能 (tailable) カーソル 」を参照してください。