Condividi tramite

Eseguire la migrazione alla versione 3.x del contenitore Read del riconoscimento ottico dei caratteri

  • Articolo

Se si usa la versione 2 del contenitore OCR Read di Visione di Azure AI, leggere questo articolo per informazioni su come aggiornare l'applicazione per l'uso della versione 3.x del contenitore.

Modifiche API

Il contenitore Read v3.2 usa la versione 3 dell'API Visione di Azure AI e ha gli endpoint seguenti:

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

Per informazioni dettagliate sull'aggiornamento delle applicazioni per l'uso della versione 3 dell'API Read basata sul cloud, vedere la guida alla migrazione dell'API REST Visione di Azure AI v3. Le operazioni sincrone sono supportate solo nei contenitori.

Modifiche di configurazione

  • ReadEngineConfig:ResultExpirationPeriod non è più supportato. Nel contenitore OCR dell'API Lettura è integrato un processo Cron che rimuove i risultati e i metadati associati a una richiesta dopo 48 ore.
  • Cache:Redis:Configuration non è più supportato. Nei contenitori v3.x la cache non viene usata, quindi non è necessario impostarla.

Requisiti di memoria

I requisiti e le raccomandazioni si basano su benchmark con una singola richiesta al secondo e usano un'immagine da 523 KB di una lettera commerciale digitalizzata contenente 29 righe e un totale di 803 caratteri. La tabella seguente descrive l'allocazione minima e consigliata di risorse per ogni contenitore OCR dell'API Lettura.

Contenitore Requisiti minimi Requisiti consigliati
Read 3.2 2022-04-30 4 core, 8 GB di memoria 8 core, 16 GB di memoria

Ogni core deve essere di almeno 2,6 gigahertz (GHz) o superiore.

Core e memoria corrispondono alle impostazioni --cpus e --memory che vengono usate come parte del comando run di Docker.

Implementazioni dell'archiviazione

Nota

MongoDB non è più supportato nelle versioni 3.x del contenitore. I contenitori supportano invece Archiviazione di Azure e i file system offline.

Implementazione Argomenti di runtime obbligatori
Livello file (predefinito) Non sono richiesti argomenti di runtime. Verrà usata la directory /share.
BLOB Azure Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

Implementazioni della coda

Nel contenitore v3.x la coda RabbitMQ non è attualmente supportata. Le implementazioni supportate sono:

Implementazione Argomenti di runtime Uso previsto
In memoria (predefinito) Non sono richiesti argomenti di runtime. Sviluppo e test
Code di Azure Queue:Azure:ConnectionString={AzureStorageConnectionString} Produzione
RabbitMQ Non disponibile Produzione

Per una maggiore ridondanza, il contenitore Read v3.x usa un timer di visibilità per garantire che le richieste possano essere elaborate correttamente in caso di arresto anomalo del sistema durante l'esecuzione in una configurazione a più contenitori.

Impostare il timer con Queue:Azure:QueueVisibilityTimeoutInMilliseconds, che imposta l'ora in cui un messaggio deve essere invisibile quando un altro ruolo di lavoro lo sta elaborando. Per evitare un'elaborazione ridondante delle pagine, è consigliabile impostare il periodo di timeout su 120 secondi. Il valore predefinito è 30 secondi.

Valore predefinito Valore consigliato
30000 120000

Passaggi successivi