Compartir vía

Migración a la versión 3.x del contenedor Read OCR

  • Artículo

Si usa la versión 2 del contenedor OCR de Read de Visión de Azure AI, utilice este artículo para aprender a actualizar la aplicación a fin de usar la versión 3.x del contenedor.

Cambios de API

El contenedor de Read v3.2 emplea la versión 3 de la API de Visión de Azure AI y tiene los siguientes puntos de conexión:

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

Consulte la guía de migración de la API de REST de Visión de Azure AI v3 para más información sobre cómo actualizar las aplicaciones para que usen la versión 3 de la Read API basada en la nube. Las operaciones síncronas sólo son compatibles con los contenedores.

Cambios en la configuración

  • ReadEngineConfig:ResultExpirationPeriod ya no se admite. El contenedor OCR de Read tiene un trabajo de Cron compilado que quita los resultados y los metadatos asociados a una solicitud a las 48 horas.
  • Cache:Redis:Configuration ya no se admite. La caché no se utiliza en los contenedores v3.x, por lo que no es necesario establecerla.

Requisitos de memoria

Los requisitos y las recomendaciones se basan en pruebas comparativas con una única solicitud por segundo, con una imagen de 523 kB de una carta comercial escaneada que contiene 29 líneas y 803 caracteres en total. En la tabla siguiente se describe la asignación mínima y recomendada de recursos para cada contenedor OCR de Read.

Contenedor Mínima Recomendado
Read 3.2 2022-04-30 4 núcleos, 8 GB de memoria 8 núcleos, 16 GB de memoria

Cada núcleo debe ser de 2,6 gigahercios (GHz) como mínimo.

El núcleo y la memoria corresponden a los valores --cpus y --memory, que se usan como parte del comando de ejecución de Docker.

Implementaciones de almacenamiento

Nota

MongoDB ya no se admite en las versiones 3.x del contenedor. En su lugar, los contenedores admiten Azure Storage y sistemas de archivos sin conexión.

Implementación Argumentos en tiempo de ejecución necesarios
Nivel de archivo (predeterminado) No se requieren argumentos en tiempo de ejecución. Se usará el directorio /share.
Blob de Azure Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

Implementaciones de colas

En la versión 3.x del contenedor, no se admite actualmente RabbitMQ. Las implementaciones de respaldo admitidas son:

Implementación Argumentos en tiempo de ejecución Uso previsto
En memoria (predeterminado) No se requieren argumentos en tiempo de ejecución. Desarrollo y pruebas
Colas de Azure Queue:Azure:ConnectionString={AzureStorageConnectionString} Producción
RabbitMQ No disponible Producción

Para agregar redundancia, el contenedor de Read v3.x emplea un temporizador de visibilidad para garantizar que las solicitudes se puedan procesar correctamente si se produce un bloqueo, cuando se ejecuten en una instalación de varios contenedores.

Establezca el temporizador con Queue:Azure:QueueVisibilityTimeoutInMilliseconds, que establece el tiempo que un mensaje es invisible cuando otro trabajo lo procesa. Para evitar que las páginas se procesen de forma redundante, se recomienda establecer el período de tiempo de espera en 120 segundos. El valor predeterminado es 30 segundos.

Valor predeterminado Valor recomendado
30000 120000

Pasos siguientes