Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
演算子
/
集計パイプライン ステージ

$skip（集計）

項目一覧

  • 定義
  • 動作
  • 例

定義

$skip

ステージに渡される指定された数の ドキュメントをスキップし、残りのドキュメントをパイプラインの次のステージに渡します。

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

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

$skip には、スキップするドキュメントの最大数を示す正の整数を指定します。

注意

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

動作

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

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

  • $sort集約段階、

  • sort()メソッド、または

  • findAndModifyコマンドまたはfindAndModify()shellメソッドに対するsortフィールド

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

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

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

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

例

次の例で考えてみます。

db.article.aggregate([
    { $skip : 5 }
]);

この操作は、パイプラインによって渡される最初の5ドキュメントをスキップします。 $skipは、パイプラインで渡すドキュメントの内容には影響しません。

Tip

以下も参照してください。

戻る

$setWindowFields

次へ

$sort

項目一覧