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

このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。6.0 配置をアップグレードするには、 MongoDB 7.0 のアップグレード手順を参照してください。

定義

cursor.maxAwaitTimeMS(<time limit>)

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

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

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

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

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

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

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

このメソッドmaxAwaitTimeMS()は、追尾可能 (tailable) カーソルが次の応答を待機する時間の制限を設定します。 maxTimeMS()は合計処理時間の制限を設定します。

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

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

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

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

強調表示された行は、 salesコレクションに追尾可能 (tailable) カーソルを作成します。 maxAwaitTimeMS()は、次のカーソル更新の最大待機時間を 1 秒に設定します。

戻る

cursor.max

cursor.maxTimeMS