Udostępnij za pośrednictwem


Migrowanie do wersji 3.x kontenera odczytu OCR

Jeśli używasz wersji 2 kontenera OCR do odczytu usługi Azure AI Vision, skorzystaj z tego artykułu, aby dowiedzieć się, jak uaktualnić aplikację do wersji 3.x kontenera.

Zmiany w interfejsie API

Kontener Read v3.2 używa wersji 3 interfejsu API usługi Azure AI Vision i ma następujące punkty końcowe:

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

Aby uzyskać szczegółowe informacje na temat aktualizowania aplikacji w celu korzystania z wersji 3 interfejsu API odczytu, zobacz Przewodnik migracji interfejsu API REST usługi Azure AI Vision w wersji 3. Operacje synchroniczne są obsługiwane tylko w kontenerach.

Zmiany konfiguracji

  • ReadEngineConfig:ResultExpirationPeriod program nie jest już obsługiwany. Kontener odczytu OCR ma skompilowane zadanie Cron, które usuwa wyniki i metadane skojarzone z żądaniem po 48 godzinach.
  • Cache:Redis:Configuration program nie jest już obsługiwany. Pamięć podręczna nie jest używana w kontenerach w wersji 3.x, więc nie trzeba jej ustawiać.

Wymagania dotyczące pamięci

Wymagania i zalecenia są oparte na testach porównawczych z pojedynczym żądaniem na sekundę przy użyciu obrazu 523 KB zeskanowanego listu biznesowego zawierającego 29 wierszy i łącznie 803 znaków. W poniższej tabeli opisano minimalne i zalecane alokacje zasobów dla każdego kontenera OCR odczytu.

Kontener Minimum Zalecane
Przeczytaj 3.2 2022-04-30 4 rdzenie, 8 GB pamięci 8 rdzeni, 16 GB pamięci

Każdy rdzeń musi być co najmniej 2,6 gigahertz (GHz) lub szybszy.

Rdzeń i pamięć odpowiadają --cpus ustawieniu i --memory , które są używane w ramach polecenia docker run.

Implementacje magazynu

Uwaga

Baza danych MongoDB nie jest już obsługiwana w wersjach 3.x kontenera. Zamiast tego kontenery obsługują usługi Azure Storage i systemy plików offline.

Implementacja Wymagane argumenty środowiska uruchomieniowego
Poziom pliku (wartość domyślna) Nie są wymagane żadne argumenty środowiska uruchomieniowego. /share zostanie użyty katalog.
Azure Blob Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

Implementacje kolejek

W wersji 3.x kontenera usługa RabbitMQ nie jest obecnie obsługiwana. Obsługiwane implementacje kopii zapasowych to:

Implementacja Argumenty środowiska uruchomieniowego Przeznaczenie
W pamięci (wartość domyślna) Nie są wymagane żadne argumenty środowiska uruchomieniowego. Tworzenie i testowanie
Azure Queues Queue:Azure:ConnectionString={AzureStorageConnectionString} Produkcyjne
RabbitMQ Niedostępny Produkcyjne

W przypadku dodatkowej nadmiarowości kontener Read v3.x używa czasomierza widoczności w celu zapewnienia, że żądania mogą zostać pomyślnie przetworzone, jeśli wystąpi awaria podczas uruchamiania w konfiguracji z wieloma kontenerami.

Ustaw czasomierz Queue:Azure:QueueVisibilityTimeoutInMillisecondsza pomocą polecenia , który ustawia czas, przez który komunikat będzie niewidoczny, gdy inny proces roboczy go przetwarza. Aby uniknąć nadmiarowego przetwarzania stron, zalecamy ustawienie limitu czasu na 120 sekund. Wartość domyślna to 30 sekund.

Domyślna wartość Zalecana wartość
30000 120000

Następne kroki