읽기 OCR 컨테이너의 v3.x로 마이그레이션

Azure AI Vision 읽기 OCR 컨테이너 버전 2를 사용하는 경우 이 문서를 사용하여 컨테이너 버전 3.x를 사용하도록 애플리케이션을 업그레이드하는 방법을 알아봅니다.

API 변경

Read v3.2 컨테이너는 Azure AI 비전 API 버전 3을 사용하며 다음과 같은 엔드포인트를 갖습니다.

• /vision/v3.2/read/analyzeResults/{operationId}
• /vision/v3.2/read/analyze
• /vision/v3.2/read/syncAnalyze

읽기 API 버전 3을 사용하도록 애플리케이션을 업데이트하는 방법에 대한 자세한 내용은 Azure AI Vision v3 REST API 마이그레이션 가이드를 참조하세요. 동기 작업은 컨테이너에서만 지원됩니다.

구성 변경 내용

• ReadEngineConfig:ResultExpirationPeriod은 더 이상 지원되지 않습니다. Read OCR 컨테이너에는 48시간 후에 요청에 연결된 결과와 메타데이터를 제거하는 빌드된 Cron 작업이 있습니다.
• Cache:Redis:Configuration은 더 이상 지원되지 않습니다. Cache는 v3.x 컨테이너에서 사용되지 않으므로 설정하지 않아도 됩니다.

메모리 요구 사항

요구 사항 및 권장 사항은 초당 단일 요청을 포함하는 벤치마크를 기준으로 하며, 523KB의 스캔된 비즈니스 문자 이미지를 사용하여 29개 줄과 총 803 문자를 포함합니다. 다음 표에서는 각 Read OCR 컨테이너에 대한 최소 및 권장 리소스 할당을 설명합니다.

Container	최소	권장
Read 3.2 2022-04-30	4개 코어, 8GB 메모리	8 코어, 16-GB 메모리

각 코어는 속도가 2.6GHz 이상이어야 합니다.

docker run 명령의 일부로 사용되는 --cpus 및 --memory 설정에 해당하는 코어 및 메모리

스토리지 구현

참고 항목

MongoDB는 3.x 버전의 컨테이너에서 더 이상 지원되지 않습니다. 대신 컨테이너는 Azure Storage 및 오프라인 파일 시스템을 지원합니다.

구현	필요한 런타임 인수
파일 수준(기본값)	런타임 인수가 필요하지 않습니다. /share 디렉터리가 사용됩니다.
Azure Blob	Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

큐 구현

v3.x의 컨테이너에서 RabbitMQ는 현재 지원되지 않습니다. 지원되는 지원 구현은 다음과 같습니다.

구현	런타임 인수	올바른 사용법
메모리 내(기본값)	런타임 인수가 필요하지 않습니다.	개발 및 테스트
Azure Queues	Queue:Azure:ConnectionString={AzureStorageConnectionString}	생산
RabbitMQ	사용할 수 없음	생산

중복 추가의 경우 Read v3.x 컨테이너는 표시 타이머를 사용하여 다중 컨테이너 설정에서 실행될 때 요청이 충돌이 발생하는 경우 요청이 성공적으로 처리될 수 있도록 합니다.

다른 작업자가 처리할 때 메시지가 표시되지 않도록 하는 시간을 설정하는 Queue:Azure:QueueVisibilityTimeoutInMilliseconds로 타이머를 설정합니다. 페이지가 중복 처리되지 않도록 하려면 제한 시간을 120초로 설정하는 것이 좋습니다. 기본값은 30초입니다.

기본값	권장 값
30000	120000

다음 단계

• 컨테이너 구성에서 구성 설정을 검토합니다.
• OCR 개요를 검토하여 인쇄 및 필기 텍스트를 인식하는 방법을 자세히 알아봅니다.
• Read API를 참조하여 컨테이너에서 지원하는 방법을 자세히 알아봅니다.
• Azure AI 비전 기능과 관련된 문제를 해결하려면 FAQ(질문과 대답)를 참조하세요.
• 더 많은 Azure AI 컨테이너 사용