共用方式為

移轉至讀取 OCR 容器的 v3.x

  • 發行項

如果您使用第 2 版的 Azure AI 視覺讀取 OCR 容器，請使用本文來瞭解如何將應用程式升級為使用 3.x 版的容器。

API 變更

Read v3.2 容器會使用第 3 版的 Azure AI 視覺 API，並具有下列端點：

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

如需更新應用程式以使用第 3 版讀取 API 的詳細資訊，請參閱 Azure AI Vision v3 REST API 移轉指南。 只有在容器中才支援同步作業。

組態變更

  • ReadEngineConfig:ResultExpirationPeriod 不再受支援。 Read OCR 容器具有已建置的 Cron 作業，會在 48 小時後移除與要求相關聯的結果和中繼資料。
  • Cache:Redis:Configuration 不再受支援。 此快取不會用於 v3.x 容器中，因此您不需要加以設定。

記憶體需求

這些需求和建議是以每秒單一要求的基準為基礎，使用已掃描商務信件的 523 KB 映像 (包含 29 行，共 803 個字元)。 下表描述每個 Read OCR 容器的資源配置下限和建議。

容器 最小值 建議需求
讀取 3.2 2022-04-30 4 核心，8 GB 記憶體 8 核心，16-GB 記憶體

每個核心必須至少 2.6 GHz 或更快。

核心和記憶體會對應至 --cpus 和 --memory 設定，用來做為 docker run 命令的一部分。

儲存體實作

注意

在 3.x 版的容器中，已不再支援 MongoDB。 相反地，容器支援 Azure 儲存體和離線檔案系統。

實作 必要的執行時間引數
檔案層級 (預設) 不需要任何執行階段引數。 將使用 /share 目錄。
Azure Blob Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

佇列實作

在 v3.x 的容器中，目前不支援 RabbitMQ。 支援的支援實作為：

實作 執行階段引數 預定用途
在記憶體中 (預設) 不需要任何執行階段引數。 開發與測試
Azure 佇列 Queue:Azure:ConnectionString={AzureStorageConnectionString} Production
RabbitMQ [無法使用] Production

針對新增的備援，Read v3.x 容器會使用可見度計時器，以確保在多容器設定中執行期間發生損毀時能夠成功處理要求。

將計時器設定為 [Queue:Azure:QueueVisibilityTimeoutInMilliseconds]，這會設定當另一個背景工作角色正在處理訊息時，不會顯示訊息的時間。 若要避免頁面重複處理，建議您將逾時期間設定為 120 秒。 預設值為 30 秒。

預設值 建議值
30000 120000

下一步