AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$limit（集計ステージ）

定義

$limit

パイプラインの次のステージに渡されるドキュメントの数を制限します。

互換性

次の環境でホストされる配置には $limit を使用できます。

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

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

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

構文

$limitステージのプロトタイプ形式は次のとおりです。

{ $limit: <positive 64-bit integer> }

$limit 渡すドキュメントの最大数を指定する正の整数を取ります。

注意

$limit パイプライン集計には 64 ビットの整数制限があります。MongoDB は、値がこの制限を超えると、無効な引数エラーを返します。

動作

ソートされた結果での $limit の使用

$limit ステージを次のいずれかで使用する場合、

結果を $limit ステージに渡す前に、一意の値を含むフィールドを 1 つ以上ソートの中に含めるようにします。

重複する値を含むフィールドをソートすると、特にコレクションが書込み (write) をアクティブに受信している場合、複数回実行時に重複フィールドに対して異なるソート順序が返されることがあります。

並べ替えの整合性を保証する最も簡単な方法は、並べ替えクエリに_idフィールドを含めることです。

それぞれの詳細については、以下を参照してください。

例

このページの例では、sample_mflix データセット のデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

次の例で考えてみます。

db.movies.aggregate([   { $limit : 5 }])

この操作は、パイプラインによって渡された最初の 5 個のドキュメントのみを返します。$limit は、渡すドキュメントの内容には影響しません。

注意

$sortが$limitに先行し、途中にドキュメント数を変更するステージがない場合、オプティマイザは$limitを$sortに統合することができます。 これにより、 $sort操作の進行中に上位 のn結果のみが保持できます。ここでは、 nは指定された制限であり、MongoDB はメモリにn個の項目のみを保存するだけで済むようになります。 この最適化は、 allowDiskUseがtrueで、かつn項目が集計メモリの制限 を超えている場合でも、引き続き適用されます。

詳細

$limit の使用方法を完全な例で学ぶには、集計パイプラインでのデータのフィルターチュートリアルを参照してください。

戻る
$indexStats
次へ
$listClusterCatalog
ルール バッジを取得する

「データ変換の基礎」を無料でマスターしましょう！

詳細
このページを評価

項目一覧