$limit (집계 단계)

정의

$limit: 파이프라인의 다음 단계로 전달되는 문서 수를 제한합니다.

호환성

다음 환경에서 호스팅되는 배포에 $limit 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

$limit 단계의 프로토타입 형식은 다음과 같습니다.

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

$limit 전달할 최대 문서 수를 지정하는 양의 정수를 사용합니다.

참고

$limit 파이프라인 집계에는 64비트 정수 제한이 있습니다. MongoDB는 값이 이 제한을 초과하면 유효하지 않은 인수 오류를 반환합니다.

행동

정렬된 결과에 $limit 사용

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

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

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

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

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

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

예시

이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.

다음 예를 고려하십시오.

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

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

이 페이지의 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# 운전자 사용하여 $limit 집계 파이프라인 에 단계를 추가하려면 PipelineDefinition 객체 에서 UnionWith() 메서드를 호출합니다.

다음 예시 제목별로 영화를 정렬하고 결과를 첫 번째 5 개 문서로 제한하는 파이프라인 단계를 만듭니다.

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

{"_id": "...", "title": "!Women Art Revolution", "runtime": "...", "rated": "...", "metacritic": "...", "imdb": "..."}{"_id": "...", "title": "#chicagoGirl: The Social Network Takes on a Dictator", "runtime": "...", "rated": "...", "metacritic": "...", "imdb": "..."}{"_id": "...", "title": "$", "runtime": "...", "rated": "...", "metacritic": "...", "imdb": "..."}{"_id": "...", "title": "$9.99", "runtime": "...", "rated": "...", "metacritic": "...", "imdb": "..."}{"_id": "...", "title": "'71", "runtime": "...", "rated": "...", "metacritic": "...", "imdb": "..."}

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

다음 예에서는 반환된 문서 수를 10개로 제한하는 파이프라인 단계를 만듭니다. 그리고 집계 파이프라인을 실행합니다.

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

참고

$sort가 $limit 앞에 오고 문서 수를 수정하는 중간 단계가 없는 경우, 옵티마이저는 $limit를 $sort로 병합할 수 있습니다. 이렇게 하면 $sort 연산을 진행하는 과정에서 상위 n개의 결과만 유지할 수 있고(여기서 n은 지정된 제한값 의미), MongoDB는 메모리에 n개의 항목만 저장하면 됩니다. 이 최적화는 allowDiskUse가 true이고 n 항목이 집계 메모리 제한을 초과하는 경우에도 여전히 적용됩니다.

자세히 알아보기

전체 예시에서 $limit를 사용하는 방법 학습을 하려면 집계 파이프라인에서 데이터 필터 튜토리얼을 참조하세요.

돌아가기

$indexStats

$listClusterCatalog