Migrate to the Read v3.x OCR containers
If you're using version 2 of the Computer Vision Read OCR container, Use this article to learn about upgrading your application to use version 3.x of the container.
ReadEngineConfig:ResultExpirationPeriodis no longer supported. The Read OCR container has a built Cron job that removes the results and metadata associated with a request after 48 hours.
Cache:Redis:Configurationis no longer supported. The Cache isn't used in the v3.x containers, so you don't need to set it.
The Read v3.2 container uses version 3 of the Computer Vision API and has the following endpoints:
See the Computer Vision v3 REST API migration guide for detailed information on updating your applications to use version 3 of cloud-based Read API. This information applies to the container as well. Sync operations are only supported in containers.
The requirements and recommendations are based on benchmarks with a single request per second, using a 523-KB image of a scanned business letter that contains 29 lines and a total of 803 characters. The following table describes the minimum and recommended allocations of resources for each Read OCR container.
|Read 3.2 2022-04-30||4 cores, 8-GB memory||8 cores, 16-GB memory|
Each core must be at least 2.6 gigahertz (GHz) or faster.
Core and memory correspond to the
--memory settings, which are used as part of the docker run command.
MongoDB is no longer supported in 3.x versions of the container. Instead, the containers support Azure Storage and offline file systems.
|Implementation||Required runtime argument(s)|
|File level (default)||No runtime arguments required.
In v3.x of the container, RabbitMQ is currently not supported. The supported backing implementations are:
|Implementation||Runtime Argument(s)||Intended use|
|In Memory (default)||No runtime arguments required.||Development and testing|
For added redundancy, the Read v3.x container uses a visibility timer to ensure requests can be successfully processed if a crash occurs when running in a multi-container setup.
Set the timer with
Queue:Azure:QueueVisibilityTimeoutInMilliseconds, which sets the time for a message to be invisible when another worker is processing it. To avoid pages from being redundantly processed, we recommend setting the timeout period to 120 seconds. The default value is 30 seconds.
|Default value||Recommended value|
- Review Configure containers for configuration settings
- Review OCR overview to learn more about recognizing printed and handwritten text
- Refer to the Read API for details about the methods supported by the container.
- Refer to Frequently asked questions (FAQ) to resolve issues related to Computer Vision functionality.
- Use more Cognitive Services Containers