집계 파이프라인 제한

결과 크기 제한

aggregate 명령은 커서 반환하거나 결과를 컬렉션 에 저장 수 있습니다. 결과 설정하다 의 각 문서 에는 16 메비바이트 BSON 문서 크기 제한이 적용됩니다. 단일 문서 BSON 문서 크기 제한을 초과하는 경우 집계 오류가 발생합니다. 이 한도는 반환된 문서에만 적용됩니다. 파이프라인 처리 중에 문서가 이 크기를 초과할 수 있습니다. db.collection.aggregate() 메서드는 기본값 으로 커서 반환합니다.

단계 수 제한

MongoDB는 단일 파이프라인에서 허용되는 집계 파이프라인 단계 수를 1000개로 제한합니다.

집계 파이프라인이 구문 분석 전후에 단계 제한을 초과하면 오류가 발생합니다.

메모리 제한

MongoDB 6.0부터 allowDiskUseByDefault 매개변수는 실행에 100메가바이트 이상의 메모리가 필요한 파이프라인 단계에서 기본적으로 디스크에 임시 파일 쓰기를 수행할지 여부를 제어합니다.

• allowDiskUseByDefault를 true로 설정하면 실행하는 데 100메가바이트 이상의 메모리가 필요한 파이프라인 단계에서는 기본적으로 임시 파일을 디스크에 씁니다. { allowDiskUse: false } 옵션을 사용하여 특정 find 또는 aggregate 명령에 대해 디스크에 임시 파일 쓰기를 비활성화할 수 있습니다.

• allowDiskUseByDefault를 false로 설정하면 실행하는 데 100메가바이트 이상의 메모리가 필요한 파이프라인 단계는 기본적으로 오류가 발생합니다. { allowDiskUse: true } 옵션을 사용하여 특정 find 또는 aggregate에 대한 임시 파일을 디스크에 쓸 수 있도록 설정할 수 있습니다.

$search 집계 단계는 별도의 프로세스에서 실행되므로 100 메가바이트의 RAM으로 제한되지 않습니다.

허용 디스크 사용이 true일 때 디스크에 임시 파일을 쓸 수 있는 단계의 예시는 다음과 같습니다.

• $bucket

• $bucketAuto

• $group

• $setWindowFields

• $sort 인덱스에서 정렬 작업을 지원하지 않는 경우

• $sortByCount

$sort 파이프라인 단계 중 하나의 결과가 한도를 초과하는 경우 $limit 단계를 추가하는 것을 고려하세요.

단계별 제한 외에도 단일 작업은 작업당 메모리 제한보다 많은 메모리를 사용할 수 없습니다.

프로파일러 로그 메시지 및 진단 로그 메시지에는 메모리 제한으로 인해 집계 단계에서 임시 파일에 데이터를 쓴 경우 usedDisk 표시기가 포함됩니다.

작업별 메모리 제한

MongoDB 9.0부터, MongoDB는 단일 쿼리 작업이 사용할 수 있는 총 메모리 양을 제한합니다. 이 제한은 작업의 모든 메모리 추적 단계의 결합된 메모리에 적용됩니다.

추적된 메모리에는 다음이 포함됩니다:

• $group 및 $sort와 같은 차단 단계

• 표현식 평가

• 지리 공간적 근접성 검색, 인덱스를 사용하는 카운트, 업데이트와 같이 기록을 버퍼링하는 쿼리 실행 단계

기본값은 1 기가바이트 또는 서버 프로세스에서 사용할 수 있는 메모리의 20% 중 더 큰 값입니다. MongoDB는 서버가 시작될 때 기본값을 설정합니다.

작업당 제한을 변경하려면 스타트업 시, 런타임에 또는 쿼리 설정에서 internalQueryMaxMemoryUsageBytesPerOperation 매개변수를 설정하세요.

작업별 제한이 적용되지 않는 메모리 집약적 표현식의 경우, MongoDB는 표현식의 하위 집합이 사용할 수 있는 최대 메모리에 제한을 적용합니다. 이 제한의 기본값은 100 메가바이트입니다. 이 제한을 변경하려면 스타트업 시 또는 런타임에 internalQueryMaxSingleExpressionMemoryUsageBytes 매개변수를 설정하세요.

작업당 제한은 100 MB(메가바이트) 단계당 메모리 제한과 별개이며, 단계가 디스크로 유출되는 방식을 변경하지 않습니다. 단계별 제한에 대해 학습하려면 메모리 제한.을 참조하세요.

작업이 작업당 제한을 초과하면 MongoDB는 해당 작업을 종료하고 다음 오류 중 하나를 반환합니다.

• 디스크로 스필될 수 있는 단계가 제한을 초과하고 allowDiskUse이(가) false인 경우 QueryExceededMemoryLimitNoDiskUseAllowed 입니다. 실패하는 대신 단계가 디스크로 스필되도록 { allowDiskUse: true }을(를) 사용하여 작업을 실행합니다.

• ExceededMemoryLimit 제한을 초과하는 다른 작업의 경우.

대부분의 작업은 제한보다 훨씬 적은 메모리를 사용합니다. 작업이 메모리 제한 오류를 반환하는 경우 다음 조치 중 하나 이상을 수행하여 작업에 필요한 메모리를 줄이십시오.

• MongoDB가 메모리에서 문서를 정렬하지 않도록 인덱스를 사용하여 정렬을 충족합니다. 자세한 사항은 정렬 및 인덱스 사용 항목을 참조하십시오.

• 단계 $limit $sort 뒤에 단계를 추가하여 정렬이 필요한 문서만 유지하도록 합니다. 자세한 내용은 $sort 및 $limit 메모리 최적화를 참조하세요.

• 파이프라인의 초기 단계에서 $match를 사용한 문서 필터로 이후 단계에서 처리할 문서의 수를 줄일 수 있습니다. 자세한 내용은 집계 파이프라인 최적화를 참조하세요.

작업별 메모리 사용량을 확인하려면 다음 serverStatus 지표를 사용하세요.

• metrics.query.peakMemoryUsageOperation

• metrics.query.operationsFailedDueToMemoryLimit

• metrics.query.configuredMaxMemoryUsageBytesPerOperation