cursor.maxAwaitTimeMS()（mongoshメソッド）

定義

cursor.maxAwaitTimeMS(<time limit>)

重要

mongosh メソッド

このページではメソッドについて説明します。これはNode.jsなどの言語固有のドライバーのドキュメントではありませんmongosh 。

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

Capped コレクションの追尾可能 (tailable) カーソルクエリに一致する新しいドキュメントをサーバーが待機する最大時間を指定します。クエリによって返されたカーソルを反復処理する方法の詳細については、「 mongoshでのカーソルの反復処理」を参照してください。

maxAwaitTimeMS()メソッドのプロトタイプ形式は次のとおりです。

db.collection.find(
   { <query> },
   { <projection> }
).tailable( { awaitData: true } ).maxAwaitTimeMS( <milliseconds> )

maxAwaitTimeMS()メソッドには次のパラメーターがあります。

Parameter	タイプ	説明
`milliseconds`	integer	新しいドキュメントの最大待機時間を指定します。

重要

This method, maxAwaitTimeMS(), sets a limit on how long a tailable cursor waits for the next response. maxTimeMS() sets a limit on total processing time.

互換性

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

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

注意

このコマンドは、すべてのMongoDB Atlasクラスターでサポートされています。すべてのコマンドの Atlas サポートの詳細については、「サポートされていないコマンド」を参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

例

Capped salesコレクションをクエリして、エージェントメトリクスの月間売上合計を見つけます。

db.sales.find(
   { agent: "Mary Kay" },
   { _id: 0, agent: 1, weeklyTotal: 1  }
).tailable( { awaitData: true } ).maxAwaitTimeMS( 1000 )

The highlighted line creates a tailable cursor on the sales collection. The maxAwaitTimeMS() sets a one second maximum wait time for the next cursor update.

戻る

cursor.max

cursor.maxTimeMS