/ /

건너뛰기 (집계 단계)

정의

$skip

단계로 전달되는 지정된 수의 문서를 건너뛰고 나머지 문서를 파이프라인의 다음 단계로 전달합니다.

$skip 단계에는 다음과 같은 프로토타입 형식이 있습니다.

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

$skip 건너뛸 최대 문서 수를 지정하는 양의 정수를 사용합니다.

참고

MongoDB 5.0부터 $skip 파이프라인 집계에 64비트 정수 제한이 있습니다. 이 제한을 초과하여 파이프라인에 전달된 값은 잘못된 인수 오류를 반환합니다.

행동

정렬된 결과와 함께 $skip 사용

$skip 단계를 다음 중 하나와 함께 사용하는 경우:

$sort 집계 단계,
sort() 메소드 또는
sort 0} 필드를 findAndModify 명령 또는 findAndModify() 셸 메서드에 추가합니다,

$skip 단계로 결과를 전달하기 전에 정렬에 고유 값을 포함하는 필드를 하나 이상 포함해야 합니다.

중복 값이 포함된 필드를 기준으로 정렬하면 특히 컬렉션이 활발하게 쓰기를 수신하는 경우 여러 번 실행할 때 중복 필드에 대해 일관되지 않은 정렬 순서가 반환될 수 있습니다.

정렬 일관성을 보장하는 가장 쉬운 방법은 정렬 쿼리에 _id 필드를 포함하는 것입니다.

각각에 대한 자세한 내용은 다음을 참조하세요:

예시

다음 예를 고려하십시오.

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

이 연산은 파이프라인에서 전달된 처음 5개의 문서만 반환합니다. $skip은 파이프라인을 따라 전달되는 문서의 콘텐츠에 영향을 주지 않습니다.

이 페이지의 C# 예제에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB .NET/ C# 드라이버 문서에서 시작하기 를 참조하세요.

다음 Movie 클래스는 sample_mflix.movies 컬렉션의 문서를 모델링합니다.

[BsonIgnoreExtraElements]
public class Movie
{
    [BsonId]
    public ObjectId Id { get; set; }
    [BsonElement("title")]
    public string Title { get; set; } = null!;
    [BsonElement("year")]
    public int? Year { get; set; }
    [BsonElement("runtime")]
    public int? Runtime { get; set; }
    [BsonElement("rated")]
    public string? Rated { get; set; }
    [BsonElement("metacritic")]
    public int Metacritic { get; set; }
    [BsonElement("plot")]
    public string? Plot { get; set; }
    [BsonElement("type")]
    public string? Type { get; set; }
    [BsonElement("cast")]
    public string[]? Cast { get; set; }
    [BsonElement("directors")]
    public string[]? Directors { get; set; }
    [BsonElement("writers")]
    public string[]? Writers { get; set; }
    [BsonElement("imdb")]
    public ImdbData? Imdb { get; set; }
}

MongoDB .NET/ C# 운전자 사용하여 $skip 집계 파이프라인 에 단계를 추가하려면 PipelineDefinition 객체 에서 Skip() 메서드를 호출합니다.

다음 예에서는 제목과 ID로 영화를 정렬하고 처음 5 개 문서를 건너띄는 파이프라인 단계를 만듭니다.

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Sort(Builders<Movie>.Sort
        .Ascending(m => m.Title)
        .Ascending(m => m.Id))
    .Skip(5)
    .Limit(5);

{"_id": "...", "title": "'Doc'", "runtime": "...", "rated": "...", "year": "...", "metacritic": "..."}
{"_id": "...", "title": "'Pimpernel' Smith", "runtime": "...", "rated": "...", "year": "...", "metacritic": "..."}
{"_id": "...", "title": "'R Xmas", "runtime": "...", "rated": "...", "year": "...", "metacritic": "..."}
{"_id": "...", "title": "'Round Midnight", "runtime": "...", "rated": "...", "year": "...", "metacritic": "..."}
{"_id": "...", "title": "'Til Madness Do Us Part", "runtime": "...", "rated": "...", "year": "...", "metacritic": "..."}

MongoDB Node.js 운전자 사용하여 집계 파이프라인 에 $skip 단계를 추가하려면 파이프라인 객체 에서 $skip 연산자 사용합니다.

다음 예시는 입력 컬렉션에서 처음 5개의 문서를 건너뛰고, 나머지 문서를 파이프라인의 다음 단계로 전달하는 파이프라인 단계를 만듭니다. 그리고 집계 파이프라인을 실행합니다.

const pipeline = [{ $skip: 5 }];
const cursor = collection.aggregate(pipeline);
return cursor;

자세히 알아보기

$skip 단계를 사용하는 전체 집계 예시는 전체 집계 파이프라인 튜토리얼을 참조하세요.

돌아가기

$shardedDataDistribution

$sort