Sdílet prostřednictvím

Migrace na v3.x kontejneru OCR pro čtení

  • Článek

Pokud používáte verzi 2 kontejneru Azure AI Vision Read OCR, v tomto článku se dozvíte, jak upgradovat aplikaci tak, aby používala verzi 3.x kontejneru.

Změny rozhraní API

Kontejner Read v3.2 používá verzi 3 rozhraní AZURE AI Vision API a má následující koncové body:

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

Podrobné informace o aktualizaci aplikací tak, aby používaly verzi 3 rozhraní API pro čtení, najdete v průvodci migrací rozhraní REST API služby Azure AI Vision v3. Synchronní operace jsou podporovány pouze v kontejnerech.

Změny konfigurace

  • ReadEngineConfig:ResultExpirationPeriod už se nepodporuje. Kontejner Read OCR má vytvořenou úlohu Cron, která odebere výsledky a metadata přidružená k požadavku po 48 hodinách.
  • Cache:Redis:Configuration už se nepodporuje. Mezipaměť se nepoužívá v kontejnerech v3.x, takže ji nemusíte nastavovat.

Požadavky na paměť

Požadavky a doporučení jsou založeny na srovnávacích testech s jedním požadavkem za sekundu pomocí 523kB obrázku naskenovaného obchodního dopisu, který obsahuje celkem 29 řádků a celkem 803 znaků. Následující tabulka popisuje minimální a doporučené přidělení prostředků pro každý kontejner OCR pro čtení.

Kontejner Minimum Doporučeno
Čtení 3.2 2022-04-30 4 jádra, 8 GB paměti 8 jader, 16 GB paměti

Každé jádro musí mít alespoň 2,6 gigahertz (GHz) nebo rychlejší.

Jádro a paměť odpovídají --cpus nastavením --memory , které se používají jako součást příkazu docker run.

Implementace úložiště

Poznámka:

MongoDB se už nepodporuje ve verzích 3.x kontejneru. Místo toho kontejnery podporují Azure Storage a offline systémy souborů.

Implementace Požadované argumenty modulu runtime
Úroveň souboru (výchozí) Nejsou vyžadovány žádné argumenty modulu runtime. /share použije se adresář.
Azure Blob Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

Implementace front

V kontejneru verze 3.x se v současné době nepodporuje RabbitMQ. Podporované backing implementace jsou:

Implementace Argumenty modulu runtime Zamýšlený účel
V paměti (výchozí) Nejsou vyžadovány žádné argumenty modulu runtime. Vývoj a testování
Azure Queues Queue:Azure:ConnectionString={AzureStorageConnectionString} Výroba
RabbitMQ Neaktivní Výroba

Pro zvýšení redundance používá kontejner Read v3.x časovač viditelnosti k zajištění úspěšného zpracování požadavků v případě, že dojde k chybě při spuštění v nastavení s více kontejnery.

Nastavte časovač pomocí Queue:Azure:QueueVisibilityTimeoutInMilliseconds, který nastaví čas, aby zpráva byla neviditelná, když ho zpracovává jiný pracovník. Pokud se chcete vyhnout redundantnímu zpracování stránek, doporučujeme nastavit časový limit na 120 sekund. Výchozí hodnota je 30 sekund.

Default value Doporučená hodnota
30000 120000

Další kroky