C#에서 병렬 OCR 메모리 사용량 제어 방법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 8월 26일

IronOCR에 의해 병렬로 처리되는 각 페이지는 자체 네이티브 Tesseract 엔진 인스턴스를 할당합니다. 대용량 배치 - 스캔한 PDF의 수백 페이지나 이미지 폴더의 경우 - 메모리 사용량은 동시 페이지 수에 따라 선형적으로 증가합니다. IronTesseract.MaxDegreeOfParallelism 속성은 단일 Read 호출 내에서 동시에 OCR할 페이지 수를 제한하며, IronTesseract.MultiThreaded를 false로 설정하면 완전히 순차 처리로 전환됩니다.

시작하기: MaxDegreeOfParallelism으로 병렬 OCR 제한하기

IronOCR이 한 번에 얼마나 많은 페이지를 읽을지를 제한하는 단일 속성을 설정하여 최대 메모리를 알려진 예산 내에 유지합니다.

  1. 1IronOCR를 NuGet Package Manager로 설치하십시오

    PM > Install-Package IronOcr

  2. 2다음 코드 조각을 복사하여 실행하세요.

    var ocr = new IronOcr.IronTesseract { MaxDegreeOfParallelism = 4 };
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    오늘 프로젝트에서 IronOCR 사용을 시작해보세요 무료 체험
    arrow pointer

NuGetNuGet으로 설치

PM > Install-Package IronOcr

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronOCR를 설치하십시오.

대량 배치 동안 OCR 메모리는 왜 증가하는가?

MultiThreaded이 true일 때, 이는 기본 설정으로, IronOCR은 페이지를 병렬로 처리합니다. 각 동시 페이지는 이미지 버퍼, 인식 모델 및 비관리형 메모리 내 중간 상태를 보유하는 자체 네이티브 Tesseract 엔진을 사용합니다.

따라서 Read 호출의 피크 메모리는 두 부분으로 나뉘며, 그 중 하나만 사용자가 제어할 수 있습니다:

  • 페이지가 어떻게 스케줄링되든 상관없이 페이지 수에 따라 증가하는 문서 자체의 고정 비용
  • 각각 하나의 네이티브 엔진을 사용하는 동시에 읽은 각 페이지의 한계 비용

MaxDegreeOfParallelism는 두 번째 용어에만 작용합니다. 이 구분은 중요합니다: 긴 문서일 경우 고정 비용이 더 큰 비율을 차지할 수 있으므로, 병렬성을 제한하면 피크 메모리가 크게 감소하지만 절대로 0으로 감소하지는 않습니다.

Docker의 고정 --memory 제한이나 Kubernetes의 리소스 할당 포드와 같은 컨테이너화된 환경에서는, 한계 용어가 작업을 완료 불가능한 OOM 킬로 바꿔버릴 수 있습니다, 왜냐하면 그것이 호스트의 논리 프로세서 개수와 함께 증가하기 때문입니다. 하드웨어 서버에서는 스왑을 발생시키고 처리량을 저하시킵니다. 우리는 피크 작업 세트를 알려진 예산 내에 두기 위해 병렬성을 제한합니다.

각 동시 페이지는 얼마나 많은 메모리를 사용하는가?

아래 참조 워크로드에 대한 측정 결과, 이 두 용어는 다음과 같습니다:

피크 ≈ 고정 문서 비용 + (엔진당 비용 × 동시성)

측정된 수치를 시작점으로 삼아 자신의 워크로드를 측정하여 조정하십시오 - 두 용어는 DPI, 페이지 복잡성, 문서 길이 및 언어 패키지에 따라 변합니다.

이게 어떻게 측정되었는가?

  • 각 구성은 한 페이지 가열 후 EnglishFast 언어 팩으로 5번씩 자체 프로세스에서 실행되었습니다.
  • 메모리는 해당 실행의 중앙값입니다; 처리량은 가장 빠른 것입니다.

별도의 프로세스는 중요합니다, 왜냐하면 피크 메모리는 절대 재설정되지 않는 높이 수준이므로 동일한 프로세스에서 두 번째 구성을 측정하면 첫 번째의 피크를 다시 보고할 것입니다. 처리량은 중앙값이 아닌 가장 빠른 실행을 사용합니다, 왜냐하면 머신의 다른 작업은 읽기를 결코 가속하지 않고 항상 느리게 만들 수만 있기 때문입니다.

저작물은 "Experiences in Biodiversity Research: A Field Course" (Thea B.)입니다. 아이오와 주립 대학 - 49페이지의 텍스트 중심 PDF이며, 결과를 재생산 가능한 방식으로 다운로드할 수 있습니다. 동일한 실행은 또한 이 페이지 아래의 순위표의 모든 행을 확인했습니다.

결과는 무엇이었습니까?

MaxDegreeOfParallelism최고 메모리추가된 페이지 당 한계 비용처리량
순차 - MultiThreaded = false782 MBbaseline0.77 페이지/초
2859 MB+77 MB1.32 페이지/초
41008 MB+75 MB2.09 페이지/초
81279 MB+68 MB2.56 페이지/초
16 - 이 기계의 기본값1829 MB+69 MB3.01 페이지/초

테스트 환경: 8코어 / 16스레드 x64 랩탑 CPU · 1.9 GHz · 16 GB RAM · Windows 11 x64 · .NET 8 · IronOCR 2026.8.1 · 마지막 확인 2026년 8월

첫 번째 행은 병렬성을 완전히 꺼두고; 마지막은 아무것도 설정하지 않은 경우입니다. 피크 메모리는 프로세스가 단일 순간에 도달한 가장 높은 것입니다. 추가된 페이지 당 한계 비용은 위 행 대비 추가된 각 동시 페이지 개체의 추가 메모리입니다 - 열 전체에서 거의 평평하게 유지되며, 이 안정성이 모델을 계획하는 가치가 있습니다.

유의 사항: 실행 간 변동은 모든 구성에서 2% 이내였습니다. 피크 작업 세트는 프로세스당 기록되므로, 메모리 열은 당시 실행 중인 다른 소프트웨어에 영향을 받지 않습니다; 처리량은 그렇지 않으며, 이 하드웨어에 특정한 것으로 간주해야 합니다.

수익 감소는 어디서 시작되는가?

메모리는 동시성과 함께 꾸준히 증가합니다. 처리량은 그렇지 않습니다 - 이득은 평평하게 되지만 메모리 비용은 동일한 속도로 계속 증가합니다. 마지막 두 행을 비교하십시오: 메모리 열이 그들 사이에서 훨씬 가파르게 올라가며 처리량 열은 그렇지 않습니다.

이는 실천적 발견입니다: 기본값은 대량 작업에 거의 최선이 아닙니다. 이는 단일 문서의 대기 시간을 위해 조정된 것이며, 발자국이 아닙니다. 메모리가 제한된 호스트에서 문서를 대량 처리하는 경우, 논리 프로세서 수보다 아래의 한계를 명시적으로 설정하면 속도 손실이 거의 없이 많은 메모리를 절약할 수 있습니다. 자신의 문서에서 전환점이 어디에 있는지 측정하십시오, 왜냐하면 그것은 페이지 복잡성에 따라 이동하기 때문입니다.

한 번에 몇 페이지를 읽어야 할지를 어떻게 설정하나요?

단일 Read 호출 내에서 동시에 처리되어야 하는 최대 페이지 수로 IronTesseract.MaxDegreeOfParallelism를 설정하세요. 따로 설정하지 않으면, Environment.ProcessorCount 값이 기본값으로 설정됩니다.

using IronOcr;
using System;

var ocr = new IronTesseract();

// Cap concurrency at 2 pages. Each concurrent page holds its own native
// engine, so this bounds peak memory for every Read on this instance.
ocr.MaxDegreeOfParallelism = 2;

// The cap applies per Read call, however many pages the document has.
using var input = new OcrInput();
input.LoadPdf("500-page-archive.pdf");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text.Length);

어떤 값을 선택해야 합니까?

숫자를 선택하는 대신 위의 두 부분 모델을 사용하여 크기를 조정하십시오:

고정 문서 비용 + 엔진당 비용 × MaxDegreeOfParallelism ≤ OCR에 대한 메모리 예산

자신의 문서에 대한 두 비용을 채우려면, 대표 파일을 두 번 읽으세요 - 한번은 MultiThreaded를 false로 설정하고, 한번은 MaxDegreeOfParallelism = 2로 설정하여 각 시간 피크 작업 세트를 기록하십시오. 순차 실행은 고정 비용을 제공하며, 두 차이점은 한 개의 추가 엔진 비용을 제공합니다. 둘 다 참조 수치는 위의 표에 있습니다.

이를 적용할 때 주의할 가치가 있는 두 가지 사항. 고정 용어는 문서 길이에 따라 증가하므로 긴 아카이브는 위에서 측정된 샘플과 같지 않을 것입니다. .NET 런타임, 관리 힙 및 프로세스 내의 기타 요소를 위해 여유 공간을 남겨두세요 - 컨테이너 한도의 약 40%를 남기는 것이 합리적인 시작점입니다.

메모리가 넉넉한 호스트는 기본값을 유지할 수 있습니다. 제한된 호스트는 명시적으로 하한을 설정해야 하며, 위의 수익 감소 수치가 보여주듯이, 그 제한은 종종 메모리 절약 제안보다는 처리량 손실이 훨씬 적습니다.

경고: MaxDegreeOfParallelism는 한 번의 Read 호출 내에서 페이지만 경계합니다. 사용자 코드도 동시에 여러 문서를 실행하는 경우, 두 개를 곱합니다 - 동시 문서 4개는 기본값이 16이므로 64개의 엔진이 됩니다, 16개가 아닙니다. 두 계층 모두 제한하십시오. 대량 OCR 동안 높은 피크 메모리를 위한 외부 루프 패턴을 참조하십시오.

페이지를 순차적으로 읽는 방법은?

MultiThreaded를 false로 설정하세요. 이는 가장 낮은 메모리 옵션입니다, 왜냐하면 네이티브 엔진 하나만이 활성 상태이기 때문입니다. 대가로는 처리량: 배치 작업은 N명의 병행 작업자와 함께 N배 더 오래 걸리게 됩니다.

using IronOcr;

var ocr = new IronTesseract();

// One page at a time. Overrides MaxDegreeOfParallelism, whatever it is set to.
ocr.MultiThreaded = false;

using var input = new OcrInput();
input.LoadPdf("scans.pdf");

OcrResult result = ocr.Read(input);

이전에는

경고: MultiThreaded이 효과가 없었지만 이제 실시간 설정입니다. 업그레이드 후 조치없이 false에 설정한 코드는 컴파일러 경고 없이, 예외 없이 순차적으로 읽습니다. 처리량이 예상치 못하게 감소하면 기존 사용들을 검토하십시오.

두 속성이 어떻게 상호작용하나요?

MultiThreadedMaxDegreeOfParallelism효과적인 동시성
true (기본값)설정되지 않음Environment.ProcessorCount
true양수동시 페이지 수
true0 또는 부정적Environment.ProcessorCount로 복귀
false모든 값1 - 순차적, MaxDegreeOfParallelism은 무시됨
팁: Environment.ProcessorCount은 물리적 코어가 아닌 논리적 프로세서를 보고합니다. 동시 멀티스레딩이 있는 기계에서는 기본값이 코어 수의 두 배입니다 - 8-코어 CPU는 기본값으로 16개의 동시 페이지를 가지고 있으며, 8개가 아닙니다. 메모리 예산을 논리 수에 맞추세요.

페이지 방향 감지 중 메모리를 제한할 수 있나요?

OcrInput.DetectPageOrientation의 새로운 오버로드는 페이지 방향이 동시에 감지되는 수를 제한하는 maxDegreeOfParallelism 매개변수를 수용합니다. 음수가 아닌 값은 Environment.ProcessorCount로 돌아갑니다. 단일 인수 오버로드는 변경되지 않았으며, 소스 및 바이너리와 호환됩니다.

using IronOcr;
using System;

using var input = new OcrInput();
input.LoadPdf("rotated-scans.pdf");

// Analyse at most 2 pages at once. Orientation detection runs before the
// OCR read, so capping it here prevents a spike ahead of the real workload.
var results = input.DetectPageOrientation(
    OrientationDetectionMode.Fast,
    maxDegreeOfParallelism: 2);

// One result per page, in page order.
foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.RotationAngle}");
}

Fast 모드는 페이지당 하나의 엔진을 할당하는 대신 워커 스레드당 하나의 엔진을 재사용하여 피크 메모리를 더욱 줄입니다. 이는 태세 감지가 주요 OCR 읽기 전에 전처리 단계로 실행될 때 중요합니다, 병렬성을 여기에 제한하여 실질적 작업이 시작되기 전 메모리 급증을 방지하기 때문입니다.

대량 배치에서 병렬 OCR이 여전히 충돌합니까?

이전 버전은 네이티브 Tesseract 상태에 대한 안전하지 않은 교차 스레드 액세스로 인해 병렬 또는 대량 OCR에서 치명적인 AccessViolationException를 발생시킬 수 있었습니다. 해당 예외는 복구할 수 없습니다 - 이를 포착할 기회 없이 프로세스를 종료합니다. 이제 해결되었습니다. 이전 해결 방법, 스레드당 하나의 IronTesseract 인스턴스 및 하나의 문서씩은 더 이상 필요하지 않습니다: 엔진은 워커별로 네이티브 상태를 올바르게 분리하며, MaxDegreeOfParallelism는 해당 임시 패턴을 대체하는 공식 제한을 제공합니다.

이 설정들을 언제 조정해야 하나요?

  • 메모리 제한이 있는 컨테이너 또는 CI 실행기 - 최대 메모리를 제한 내에 유지하기 위해 MaxDegreeOfParallelism를 설정하세요.
  • 수천 페이지의 배치 처리 - OOM 킬을 방지하기 위해 MaxDegreeOfParallelism를 낮추세요. 처리량은 비례적으로 감소하지만 작업이 완료되고 충돌하지 않습니다.
  • 가장 낮은 가능성의 메모리 - MultiThreaded를 false로 설정하여 순차적 모드를 실행하세요. 하나의 엔진, 한 번에 하나의 페이지.
  • 최대 처리량 - 기본값을 모두 유지하여 엔진이 사용 가능한 모든 코어를 사용하도록 하세요. 속도를 위한 멀티스레딩 예제를 참조하세요.
  • 정확도와 속도 조정 - 이는 다른 축입니다. 속도를 위한 Tesseract 조정 가이드는 정확도와 속도 비교를 다루며, 이 페이지는 메모리와 처리량 비교를 다룹니다.

비동기 처리와 반응성을 다루는 경우, 예를 들어 OCR 동안 UI 반응성을 유지하려면 비동기 OCR 사용법을 참조하십시오, 이는 ReadAsync 및 OcrReadTask를 소유합니다. 이 페이지는 리소스 제약을 다룹니다: 배치 크기와 상관없이 예측 가능한 메모리 사용을 유지합니다.

IronTesseract 구성 가이드를 탐색하여 전체 속성 면과, OcrInput 사용 패턴에 대한 PDF 입력 로드 및 이미지 입력 로드, 새 병렬성 오버로드 및 DetectPageOrientation 메소드에 대한 페이지 방향 감지를 참조하세요.

IronOCR 라이선싱 옵션을 탐색하여 체험판에서 본 프로덕션으로 이동하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 6,394,824버전:2026.11방금 출시